🔄 卡若AI 同步 2026-03-01 07:59 | 更新：火炬、运营中枢工作台 | 排除 >20MB: 14 个
This commit is contained in:
@@ -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）→ 按任务执行 → 规格符合审 → 代码质量审 → 下一任务 或 验收与复盘 → 分支收尾。
|
||||
|
||||
@@ -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 个 |
|
||||
|
||||
@@ -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) |
|
||||
|
||||
Reference in New Issue
Block a user