diff --git a/04_卡火（火）/火炬_全栈消息/全栈开发/SKILL.md b/04_卡火（火）/火炬_全栈消息/全栈开发/SKILL.md index 9f21b664..ce361002 100644 --- a/04_卡火（火）/火炬_全栈消息/全栈开发/SKILL.md +++ b/04_卡火（火）/火炬_全栈消息/全栈开发/SKILL.md @@ -1,11 +1,11 @@ --- name: 全栈开发 -description: 卡若AI 全栈开发（火炬）— 知己及类似项目经验 + 官网/全站开发与「开发文档 1～10」标准流程。含分销、RAG、向量化；官网/全站类任务时按 1～10 调研→生成→更新，类似事情用本 Skill 做调研与生成。 -triggers: 全栈开发/知己项目/分销/存客宝/RAG/向量化/Next.js/知识库/卡若AI官网/官网开发/全站开发/开发文档/1～10/开发模板/官网全站/v0前端/v0生成/毛玻璃/前端规格/神射手/毛狐狸/前端标准 +description: 卡若AI 全栈开发（火炬）— 知己及类似项目经验 + 官网/全站开发与「开发文档 1～10」标准流程；吸收 Superpowers 实施计划粒度、TDD 推荐、两阶段评审与分支收尾。含分销、RAG、向量化；官网/全站类任务时按 1～10 调研→计划→执行→评审→复盘。 +triggers: 全栈开发/知己项目/分销/存客宝/RAG/向量化/Next.js/知识库/卡若AI官网/官网开发/全站开发/开发文档/1～10/开发模板/官网全站/v0前端/v0生成/毛玻璃/前端规格/神射手/毛狐狸/前端标准/实施计划/两阶段评审 owner: 火炬 group: 火 -version: "2.1" -updated: "2026-02-26" +version: "2.2" +updated: "2026-02-16" --- # 全栈开发（火炬） @@ -26,11 +26,18 @@ updated: "2026-02-26" - **手册**：`9、手册/使用手册（带图）.md` 为访客/开发者操作手册；配图放 `9、手册/images/`。 - **复盘**：迭代结尾用 `10、项目管理/迭代复盘模板.md`（卡若复盘格式，含 Human 3.0 反思与总结）。 -### 1.2 执行流程（调研 → 生成 → 更新） +### 1.2 执行流程（调研 → 计划 → 执行 → 评审 → 复盘） 1. **调研**：先读目标项目的 `开发文档/README.md` 与 `1、需求` 下项目使用说明；无则按 1～10 自建目录并补 `卡若AI项目使用说明` 级总览。 -2. **生成/更新**：按 1～10 与「开发文档使用指引」：需求/架构/原型/前端/接口/后端/数据库/部署/手册/项目管理 逐项生成或更新；前端按 `4、前端/前端开发流程（卡若式）.md` 与组件规格、检查清单执行。 -3. **验收与复盘**：用 `10、项目管理/项目落地执行表` 与 `迭代复盘模板` 更新状态并写复盘；有类似需求时**用本 Skill 做调研再生成**，避免重复造轮。 +2. **需求澄清**（可选，复杂需求时）：结合火眼「智能追问」、水泉「需求拆解与计划制定」，分块展示设计或任务表供确认后再实施。 +3. **实施计划**（推荐，吸收 Superpowers writing-plans）： + - 有明确功能/迭代时，先写**实施计划**再写代码；计划存 `开发文档/10、项目管理/plans/YYYY-MM-DD-<特征名>.md`。 + - 计划须含：**Goal / Architecture / Tech Stack**；每个子任务含 **Files（Create/Modify/Test 精确路径）**、**Steps**（见下「实施计划标准」）、**具体命令与预期输出**（如测试命令与 Expected: FAIL/PASS）。 + - 执行时优先按该计划逐步执行，无计划时先按 1～10 生成计划再执行。 +4. **生成/更新**：按 1～10 与「开发文档使用指引」或按实施计划逐项执行；前端按 `4、前端/前端开发流程（卡若式）.md` 与组件规格、检查清单执行；**新功能推荐 TDD**（见下）。 +5. **任务/迭代评审（两阶段，吸收 Superpowers）**：单任务或迭代结束时——① **规格符合**：实现是否完全符合计划/需求，有无多做或少做；② **代码质量**：可读性、重复、魔法数等。先通过①再做②，未通过则修完再进入下一任务或复盘。 +6. **验收与复盘**：用 `10、项目管理/项目落地执行表` 与 `迭代复盘模板` 更新状态并写复盘；有类似需求时**用本 Skill 做调研再生成**，避免重复造轮。 +7. **分支与收尾**（大功能/实验性开发）：在独立分支或 worktree 开发；完成后跑测试、再选择合并/PR/保留/丢弃并清理（见下「分支与收尾」）。 ### 1.3 参考项目（标准模板） @@ -44,7 +51,34 @@ updated: "2026-02-26" 前端需求与内容以该仓库下 `4、前端/`（规范、页面与路由、组件规格、毛玻璃与自适应、v0 融合、检查清单）及 `3、原型/` 为准；部署以 `8、部署/` 为准。 -### 1.4 前端（见「前端开发」Skill + 开发文档 4、前端 + v0） +### 1.4 实施计划标准（吸收 Superpowers writing-plans） + +- **粒度**：每步 = 一个可执行动作（约 2～5 分钟）。例如：写失败测试 → 运行并确认失败 → 写最小通过实现 → 运行并确认通过 → 提交。 +- **每个子任务须包含**： + - **Files**：Create/Modify/Test 的**精确路径**（含行号区间，如 `src/foo.ts:12-20`）。 + - **Steps**：具体步骤与**完整代码片段**（非「加校验」等笼统描述）、**精确命令**（如 `npm test -- --grep "xxx"` 或 `pytest path::test_name -v`）及 **Expected**（如 FAIL with "function not defined" / PASS）。 +- **计划头**：Goal（一句话）、Architecture（2～3 句）、Tech Stack；并注明执行顺序与验收标准。 +- **保存路径**：`开发文档/10、项目管理/plans/YYYY-MM-DD-<特征名>.md`。 + +### 1.5 TDD 推荐（吸收 Superpowers test-driven-development） + +- **新功能**：推荐 **RED-GREEN-REFACTOR**——先写失败测试 → 运行确认失败 → 写最小实现 → 运行确认通过 → 必要时重构 → 提交。先于测试写出的代码可删或改为在测试通过后补全。 +- **遗留代码**：可逐步补测，不强制一次性全测。 +- **原则**：DRY、YAGNI；频繁提交，每步可提交。 + +### 1.6 任务/迭代两阶段评审（吸收 Superpowers 评审纪律） + +- **顺序**：先 **规格符合**（代码是否完全符合计划/需求，有无多做、少做），通过后再 **代码质量**（可读性、重复、魔法数、命名等）。 +- **禁止**：在规格符合未通过前做代码质量评审；跳过任一轮审或未修完就进入下一任务/复盘。 +- **落地**：在 `10、项目管理/迭代复盘模板.md` 或单任务检查清单中增加「规格符合」「代码质量」两项打勾。 + +### 1.7 分支与收尾（吸收 Superpowers finishing-a-development-branch） + +- **大功能/实验性开发**：推荐在**独立分支**或 worktree 进行；在 `10、项目管理` 中写清分支策略（如 feature/xxx、fix/xxx）。 +- **完成后**：跑全量测试 → 选择 **合并 / PR / 保留 / 丢弃** → 按需清理 worktree 或分支。 +- **不强制**使用独立 worktree，但须在开发文档或复盘中标明「本迭代分支」与「收尾决定」。 + +### 1.8 前端（见「前端开发」Skill + 开发文档 4、前端 + v0） 官网/全站/数据中台类**前端与毛玻璃风格**统一走 **「前端开发」Skill**，不再在本 Skill 内展开前端标准全文。 @@ -148,3 +182,11 @@ scripts/ --- *官网/全站类任务：先调研开发文档（1、需求 + 10、项目管理）→ 按 1～10 生成或更新 → 复盘。知己类：先读 项目经验库_知己与类似项目 → 按需调用协同 Skill。* + +--- + +## 七、全栈开发流程图（v2.2，吸收 Superpowers） + +流程图见：`/Users/karuo/Documents/卡若Ai的文件夹/图片/全栈开发流程_吸收Superpowers_20260216.png`（已登记于 `卡若Ai的文件夹/图片/图片索引.md`）。 + +**流程概要**：调研 → 需求澄清（可选）→ 实施计划（精确路径+TDD）→ 按任务执行 → 规格符合审 → 代码质量审 → 下一任务 或 验收与复盘 → 分支收尾。 diff --git a/运营中枢/工作台/gitea_push_log.md b/运营中枢/工作台/gitea_push_log.md index 023ed270..44514319 100644 --- a/运营中枢/工作台/gitea_push_log.md +++ b/运营中枢/工作台/gitea_push_log.md @@ -177,3 +177,4 @@ | 2026-03-01 07:22:59 | 🔄 卡若AI 同步 2026-03-01 07:22 | 更新：Cursor规则、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 14 个 | | 2026-03-01 07:24:14 | 🔄 卡若AI 同步 2026-03-01 07:24 | 更新：总索引与入口、运营中枢工作台 | 排除 >20MB: 14 个 | | 2026-03-01 07:54:26 | 🔄 卡若AI 同步 2026-03-01 07:54 | 更新：Cursor规则、火炬、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 14 个 | +| 2026-03-01 07:55:10 | 🔄 卡若AI 同步 2026-03-01 07:55 | 更新：运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 14 个 | diff --git a/运营中枢/工作台/代码管理.md b/运营中枢/工作台/代码管理.md index ab73a362..7969a809 100644 --- a/运营中枢/工作台/代码管理.md +++ b/运营中枢/工作台/代码管理.md @@ -180,3 +180,4 @@ | 2026-03-01 07:22:59 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-01 07:22 | 更新：Cursor规则、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 14 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | | 2026-03-01 07:24:14 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-01 07:24 | 更新：总索引与入口、运营中枢工作台 | 排除 >20MB: 14 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | | 2026-03-01 07:54:26 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-01 07:54 | 更新：Cursor规则、火炬、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 14 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | +| 2026-03-01 07:55:10 | 成功 | 成功 | 🔄 卡若AI 同步 2026-03-01 07:55 | 更新：运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 14 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |