朱子纯 / erp-workflow-plugin

Commit 2ef891d4192449b76447788b09259223e182c159

Authored by zichun
1 parent 9508a552

feat(lite): merge project-init + scope-lock into lite-init, lite docs/08 checklist + CLAUDE template

Inline Side-by-side
Showing 14 changed files with 543 additions and 615 deletions
skills/plan/lite-init/SKILL.md 0 → 100644
  View file @2ef891d
  1 +---
  2 +name: lite-init
  3 +description: 计划第 1 段——项目初始化 + 范围锁定。复制 CLAUDE.md/docs(01/04/08) 模板、依赖检查、git init，引导项目概述+技术栈+需求索引，生成 REQ 卡片骨架，停下等人工审阅 REQ。
  4 +user-invocable: false
  5 +allowed-tools: Glob Read Edit Grep Skill AskUserQuestion Bash(mkdir *) Bash(cp *) Bash(sed *) Bash(bash *) Bash(cat *) Bash(git init) Bash(command -v *) Bash(uname *) Bash(brew *) Bash(apt *) Bash(apt-get *) Bash(yum *) Bash(apk *) Bash(export PATH=*) Bash(echo *)
  6 +---
  7 +
  8 +**所有输出必须使用中文。**
  9 +
  10 +你负责完成计划第 ① 段：项目初始化 + 范围锁定。合并了原 project-init + scope-lock 的全部逻辑。
  11 +
  12 +## 执行步骤
  13 +
  14 +### 步骤 0：打印计划流程图
  15 +
  16 +用 `Bash` 向用户展示 lite 流程图（▶ 位于"计划 ①"）：
  17 +
  18 +```bash
  19 +cat "${CLAUDE_PLUGIN_ROOT}/skills/crosscut/plan-start/banners/flow-lite.txt" 2>/dev/null || true
  20 +```
  21 +
  22 +> 注：`flow-lite.txt` 由 Task 7 创建，当前若文件不存在，命令静默忽略，不影响后续执行。
  23 +
  24 +打印分发横幅：
  25 +
  26 +```
  27 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  28 + [lite-init] 计划 ① 初始化 + 范围锁定
  29 + ▶ 当前位置：计划 ① / 共 ③
  30 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  31 +```
  32 +
  33 +### A. 幂等复制模板文件
  34 +
  35 +用 `Bash` 一次性完成。`cp -n` 表示"不覆盖已存在的文件"：
  36 +
  37 +```bash
  38 +mkdir -p docs/01-需求清单
  39 +cp -n "${CLAUDE_SKILL_DIR}/templates/CLAUDE-template.md" CLAUDE.md
  40 +cp -n "${CLAUDE_SKILL_DIR}/templates/docs-01-index-template.md" docs/01-需求清单/index.md
  41 +cp -n "${CLAUDE_SKILL_DIR}/templates/docs-04-stack-template.md" docs/04-技术规范.md
  42 +cp -n "${CLAUDE_SKILL_DIR}/templates/docs-08-initial-template.md" docs/08-模块任务管理.md
  43 +```
  44 +
  45 +完成后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：
  46 +- ` - [ ] 项目文件骨架已创建（CLAUDE.md + docs/01 index + docs/04 + docs/08）`
  47 +
  48 +### B. 依赖检查 + 自动安装（命令行工具）
  49 +
  50 +对 **git、mysql** 两个工具依次执行以下流程：
  51 + 1. 如果缺失，尝试自动安装。
  52 + 2. 如果检测到不在 PATH，尝试添加进 PATH，并加载。
  53 +
  54 +全部通过后打印单行汇总再进入步骤 C：
  55 +
  56 +```
  57 +[lite-init] 依赖检查: git ✓ mysql ✓
  58 +```
  59 +
  60 +完成后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：
  61 +- ` - [ ] 依赖检查通过（git / mysql）`
  62 +
  63 +### C. 初始化 Git（如尚未初始化）
  64 +
  65 +用 `Glob` 检查 `.git/` 目录是否存在。
  66 +- 不存在 → 用 `Bash` 执行 `git init`。
  67 +- 已存在 → 跳过。
  68 +
  69 +完成后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：
  70 +- ` - [ ] Git 已初始化`
  71 +
  72 +打印完成横幅：
  73 +
  74 +```
  75 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  76 + [lite-init] 项目初始化完成
  77 +
  78 + 已创建：
  79 + ✓ CLAUDE.md（从插件模板复制）
  80 + ✓ docs/01-需求清单/index.md（待人工填写模块索引）
  81 + ✓ docs/04-技术规范.md（默认技术栈，步骤 E 让用户确认）
  82 + ✓ docs/08-模块任务管理.md（全流程进度跟踪）
  83 + 已勾选：初始化子项 3 项
  84 +
  85 + 下一步：引导项目概述 + 技术栈 + 需求索引 + 生成 REQ 卡片
  86 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  87 +```
  88 +
  89 +### D. 提示用户填写项目概述并等待
  90 +
  91 +向用户输出：
  92 +
  93 +```
  94 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  95 + [lite-init] 请填写项目概述
  96 +
  97 + 📄 文件位置: ./CLAUDE.md
  98 + 📌 编辑位置: § 🎯 项目概述
  99 +
  100 + 请将以下占位符替换为实际值：
  101 + - 项目名称
  102 + - 项目简述
  103 + - 目标用户
  104 + - 部署方式
  105 + 改完后回来选择「继续」。
  106 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  107 +```
  108 +
  109 +用 `AskUserQuestion` 询问：
  110 +- **question**: `项目概述填写完毕了吗？`
  111 + - 用户选择「继续」→ 用 `Grep` 在 `CLAUDE.md` 搜索 `【人工填写：`（限定 § 🎯 项目概述 节）。命中 → 打印残留行 + 路径，重新弹出同样的 AskUserQuestion；0 命中 → 勾选并进入步骤 E。
  112 + - 用户选择「有疑问想先沟通」→ 回答用户问题后，再次弹出同样的 QA。
  113 +
  114 +0 命中后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：
  115 +- ` - [ ] 项目概述已填写（CLAUDE.md § 🎯 项目概述）`
  116 +
  117 +### E. 提示用户检查默认技术栈并等待
  118 +
  119 +`docs/04-技术规范.md` 已由步骤 A 用模板复制（默认技术栈）。本步骤让用户检查 / 调整 § 零。
  120 +
  121 +向用户输出：
  122 +
  123 +```
  124 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  125 + [lite-init] 技术栈已保存
  126 +
  127 + 📄 文件位置: ./docs/04-技术规范.md（由模板生成）
  128 + 📌 编辑位置: § 零、技术栈总览
  129 +
  130 + 请检查技术栈表：
  131 + - 不需要的行直接删除（如纯后端项目删前端行）
  132 + - 需要替换的技术直接改
  133 + - 需要新增的条目直接加行
  134 + 改完后回来选择「继续」。
  135 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  136 +```
  137 +
  138 +用 `AskUserQuestion` 询问：
  139 +- **question**: `技术栈检查完毕了吗？`
  140 + - 用户选择「继续」→ 进入步骤 F。
  141 + - 用户选择「有疑问想先沟通」→ 回答用户问题后，再次弹出同样的 QA。
  142 +
  143 +完成后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：
  144 +- ` - [ ] 技术栈已确认（docs/04 § 零）`
  145 +
  146 +### F. 提示用户填写需求清单并等待
  147 +
  148 +`docs/01-需求清单/index.md` 已由步骤 A 写入占位符模板，这里让用户补齐模块清单。
  149 +
  150 +向用户输出：
  151 +
  152 +```
  153 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  154 + [lite-init] 请填写需求清单模块索引
  155 +
  156 + 📄 文件位置: ./docs/01-需求清单/index.md
  157 + 📌 编辑位置: § 模块索引（表格）
  158 +
  159 + 请按业务列出所有模块：
  160 + - 每行一个模块（如 SYS 系统管理 / PUR 采购 / SAL 销售）
  161 + - 「核心功能点」只需关键词，CC 会拆分为 REQ 卡片
  162 + 改完后回来选择「继续」。
  163 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  164 +```
  165 +
  166 +用 `AskUserQuestion` 询问：
  167 +- **question**: `需求清单模块索引填写完毕了吗？`
  168 + - 用户选择「继续」→ 进入步骤 G。
  169 + - 用户选择「有疑问想先沟通」→ 回答用户问题后，再次弹出同样的 QA。
  170 +
  171 +完成后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：
  172 +- ` - [ ] 需求清单索引已填写（docs/01-需求清单/index.md）`
  173 +
  174 +### G. 生成 REQ 卡片骨架并停下等人工审阅
  175 +
  176 +1. 用 `Grep` 校验 `docs/01-需求清单/index.md` 无 `【人工填写：` 残留；有则回步骤 F。
  177 +2. 用 `Read` 读 `index.md` 解析模块索引。
  178 +3. **单次 Bash 写入所有文件**（替代 N×9 次 Edit）：
  179 +
  180 + - **每模块推断**：三元组 `{module_code, module_name, module_brief}` + N 个 REQ 的六元组 `{req_id, title, goal, rules, constraints, acceptance}`。`req_id`/`title` 从核心功能点拆分；`goal` 展开 `title`；`rules`/`constraints`/`acceptance` 起草业务语义。**不推断**输入 / 输出（模板原样保留示例）。
  181 + - **单次 Bash**：调 `${CLAUDE_SKILL_DIR}/scripts/render.sh` 落盘所有文件（脚本内部完成模板读取 + 占位符替换 + HTML 注释剥离）。下面是**调用形态**示例，`<MOD>` / `<模块名>` / `<REQ-MOD-NNN>` 等尖括号位置 CC 按 `index.md` 实际值替换：
  182 +
  183 + ```bash
  184 + R="${CLAUDE_SKILL_DIR}/scripts/render.sh"
  185 + # 每个模块：mkdir + 1 个 render module + N 个 render req（每 REQ 一行）
  186 + mkdir -p "docs/01-需求清单/<MOD>-<模块名>"
  187 + bash "$R" module "docs/01-需求清单/<MOD>-<模块名>/_module.md" "<MOD>" "<模块名>" "<module_brief>"
  188 + bash "$R" req "docs/01-需求清单/<MOD>-<模块名>/<REQ-MOD-NNN>.md" "<REQ-MOD-NNN>" "<title>" "<goal>" "<rules>" "<constraints>" "<acceptance>"
  189 + ```
  190 +
  191 + - **兜底**：值含字面 `$xxx` 或 `}}` 的 REQ 单独走 cp + Edit。
  192 +
  193 +4. 用 `Edit` 在 `docs/08-模块任务管理.md` 勾选（计划 ① 子项 + ① 顶层）：
  194 + - ` - [ ] REQ 卡片骨架已生成（docs/01-需求清单/<module>/REQ-*.md）`
  195 + - `- [ ] 计划 ① 初始化 + 范围锁定 — lite-init`
  196 +
  197 +5. 打印停下横幅并**停止**，不自动派发 lite-design：
  198 +
  199 +```
  200 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  201 + [lite-init] ✅ 计划 ① 完成
  202 +
  203 + 产出：
  204 + ✓ CLAUDE.md § 🎯 项目概述
  205 + ✓ docs/04 § 零 技术栈
  206 + ✓ docs/01-需求清单/index.md 模块索引
  207 + ✓ docs/01-需求清单/<module>/_module.md 模块头
  208 + ✓ docs/01-需求清单/<module>/REQ-*.md REQ 卡片骨架
  209 +
  210 + ⏸ 现在请你逐张打开 REQ 卡片：
  211 + - **必改**：输入 / 输出 两段
  212 + · `表1` / `表2` 是模板示例，按本 REQ 业务**改字段 / 增删行 / 增删整张表**
  213 + - **审阅**：目标 / 跨字段规则 / 边界 / 验收（已起草，对照业务校正）
  214 + - **保留**：`TBD` 不要改，由之后流程自动回填
  215 +
  216 + 审阅完成后，运行以下命令进入计划 ②：
  217 + /erp-workflow:plan-start
  218 +
  219 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  220 +```
  221 +
  222 +> **STOP**：此处是人工审阅 REQ 的闸门。停止执行，等待用户运行 `/erp-workflow:plan-start` 后由 plan-start 派发 lite-design。
  223 +
  224 +## 参考
  225 +
  226 +- `${CLAUDE_SKILL_DIR}/templates/CLAUDE-template.md`（项目级 CLAUDE.md 模板）
  227 +- `${CLAUDE_SKILL_DIR}/templates/docs-01-index-template.md`（需求索引初稿）
  228 +- `${CLAUDE_SKILL_DIR}/templates/docs-04-stack-template.md`（默认技术栈）
  229 +- `${CLAUDE_SKILL_DIR}/templates/docs-08-initial-template.md`（计划阶段进度初始化）
  230 +- `${CLAUDE_SKILL_DIR}/templates/req-card-template.md`（REQ 卡片模板）
  231 +- `${CLAUDE_SKILL_DIR}/templates/_module-template.md`（模块头模板）
  232 +- `${CLAUDE_SKILL_DIR}/scripts/render.sh`（步骤 G 渲染助手，dispatch `module` / `req` 两种模式）
  233 +- 下游：人工审阅 REQ 后运行 `/erp-workflow:plan-start`，由 plan-start 派发 `lite-design`（计划 ②）
skills/plan/scope-lock/scripts/render.sh renamed to skills/plan/lite-init/scripts/render.sh
  View file @2ef891d
skills/plan/lite-init/templates/CLAUDE-template.md 0 → 100644
  View file @2ef891d
  1 +# CLAUDE.md — ERP项目 Claude Code 主指令文件
  2 +
  3 +> 本文件是 Claude Code 的"操作手册"。Claude Code 启动时会自动读取此文件。
  4 +
  5 +---
  6 +
  7 +## 🎯 项目概述
  8 +
  9 +- **项目名称**: 【人工填写：公司 + 项目名，例如"XX 公司 ERP 管理系统"】
  10 +- **项目简述**: 【人工填写：一句话描述项目目标，例如"面向中小制造企业的全流程 ERP，涵盖采购/库存/生产/销售/财务"】
  11 +- **目标用户**: 【人工填写：谁会用，例如"企业内部管理人员（采购员、仓管员、生产主管、销售员、财务人员、管理层）"】
  12 +- **部署方式**: 【人工填写：私有化部署 / 云部署 / Docker 容器化 等】
  13 +
  14 +---
  15 +
  16 +## 🔄 编码开发流程（统一循环）
  17 +
  18 +编码阶段入口：`/erp-workflow:coding-start`。所有模块统一走同一个 phase-driver 循环，无前后端分段。
  19 +
  20 +### 阶段路由（coding-start 内，只做分发）
  21 +
  22 +`coding-start` 每次入口扫描 `docs/08 § 二` 的 `里程碑:` 字段 + 本地 `git tag -l 'milestone/<id>'`，找第一个未打里程碑的模块分发到 `phase-driver`；所有模块里程碑均已打 → 输出"全部完成"。
  23 +
  24 +### 统一功能循环
  25 +
  26 +**模块循环（外）**：`phase-driver` → feature 循环 → `milestone`（本地 merge 进默认分支 + 打 `milestone/<id>` tag）→ 自动回调 `coding-start` 路由下一模块（无人工介入）。
  27 +
  28 +**功能循环（内，每个 REQ-XXX-NNN 一遍）**：`feature-spec` → `feature-tdd` → `feature-review`。
  29 +- `feature-review` verdict=approve → 勾选 docs/08 § 二 对应功能子项，继续下一 feature；
  30 +- 模块所有 feature 完成 → 调用 `milestone` 打里程碑 tag + 回调 `coding-start`。
  31 +
  32 +### 里程碑前守门
  33 +
  34 +- `milestone` 在打 tag 前内置测试闸门（后端：`scripts/test.sh`）；红色不得跳过。
  35 +- 测试 / 验证统一派发到 Agent 子会话执行，主会话只接收结构化结论。
  36 +
  37 +---
  38 +
  39 +## ✅ 阶段完成判定规则
  40 +
  41 +`docs/08-模块任务管理.md` 分两段：
  42 +- `§ 一`：计划阶段三段（①②③）进度勾选
  43 +- `§ 二`：编码模块元数据表（每个模块一行 bullet，记录依赖 / 路径 / 里程碑 tag / 功能子项）
  44 +
  45 +**阶段完成判定**统一以 `里程碑:` 字段 + 本地 `git tag -l 'milestone/<id>'` 判定；子项勾选只作可视化进度，不参与完成判定。
  46 +
  47 +### 后端模块格式
  48 +
  49 +每个后端模块在 docs/08 § 二 中长这样：
  50 +
  51 +```markdown
  52 +- module_0 系统管理
  53 + - 依赖: —
  54 + - 路径: backend/module/sys/
  55 + - 里程碑: —
  56 + - 功能:
  57 + - [ ] REQ-SYS-001 用户登录
  58 + - [ ] REQ-SYS-002 用户注册
  59 +```
  60 +
  61 +- `里程碑:` 字段由 `milestone` 在打里程碑 tag 时从 `—` 改为 `milestone/<module_id>`。
  62 +- 每个 `REQ-*` 子项由 `feature-review` 在 verdict=approve 时自动勾选为 `[x]`。
  63 +
  64 +### 状态语义
  65 +
  66 +| `里程碑:` 字段 | `git tag -l` | 含义 | 你（Claude Code）的行为 |
  67 +|---|---|---|---|
  68 +| `—` | tag 不存在 | 该阶段未开始 / 进行中（未打里程碑） | ✅ 开始 / 继续该阶段开发 |
  69 +| `milestone/<id>` | tag 存在 | 阶段**已完成** | 🟢 进入下一未完成模块；全部完成 → 输出完成信息 |
  70 +
  71 +### 模块完成报告
  72 +
  73 +由 `milestone` skill 产出，模板由 milestone skill 持有。CC 不手写模块报告，仅填模板。
  74 +
  75 +---
  76 +
  77 +## 🏷️ 占位符统一约定
  78 +
  79 +项目文档里有 **2 种填写占位** + **1 种提示占位**：
  80 +
  81 +| 格式 | 谁填 | 使用阶段 | 说明 |
  82 +|------|-----|---------|------|
  83 +| `【人工填写：<简短说明>】` | 人 | 仅计划阶段文档 | 密钥 / 账密 / 包名 / 命名约定 / 小版本号等人工才能决定的值；编码阶段 plan/spec 禁止出现，查不到真值时用 `AskUserQuestion` 问用户 |
  84 +| `TBD(<责任人>)` | CC 自动 | 计划或编码 | 后缀附带责任方（如 `TBD(lite-design 自动补)` / `TBD(lite-build-db 自动补)`）；由对应 skill 就地补填 |
  85 +
  86 +**HTML 注释 `<!-- ... -->`**：提示占位，是**插件内部大纲模板**里给 LLM 的**填空提示 / 章节引导**，指引 LLM 按结构填实际内容。skill 生成时会**剥除**这些注释，最终产物里注释不会保留。
  87 +
  88 +---
  89 +
  90 +## 📐 编码行为约束
  91 +
  92 +### 你必须做的 ✅
  93 +
  94 +1. **严格遵循** `docs/04-技术规范.md`——命名 / 编码 / 统一响应 / 异常处理 / 数据访问 / 配置与安全 / 环境配置（含 .env.local 字段说明）等项目专属技术规约全部在此
  95 +2. **每个后端接口** 必须先在 `docs/05-API接口契约.md` 定义，再编码实现
  96 +3. **每个功能可追溯到 `REQ-XXX-NNN`**——commit tag + 代码注释（如 `// REQ-SYS-001: 用户登录`）+ plan/spec 文件名均用此 tag
  97 +4. **遇到跨模块改动**（动到非当前模块的代码）——按 § 🟡 软规则 **S2** 执行（允许改，但必须留痕）
  98 +5. **遇到技术栈外组件引入**（`docs/04 § 零` 技术栈表外的框架 / 中间件 / 关键库），按 § 🟡 软规则 **S1** 执行（允许引入，但必须先 AskUserQuestion）
  99 +
  100 +### 你禁止做的 🚫
  101 +
  102 +1. **主会话直接 `mysql -e` 跑业务 DDL**（只读查询 / 临时本地调试除外）——业务 schema 必须走 `sql/migrations/V_n__*.sql`，详见下方 Schema 演化规约
  103 +2. **手动 Edit `docs/08 § 二` 的 `里程碑:` 字段**，必须由 `milestone` 自动回写
  104 +
  105 +### Schema 演化规约（Flyway migration）
  106 +
  107 +1. **文件命名**：`sql/migrations/V<n>__<snake_case_desc>.sql`，例：`V5__add_user_email_unique_index.sql`
  108 +2. **版本号分配**：建文件前 `ls sql/migrations/V*.sql` 查当前最大 n，新文件 `n_max + 1`
  109 +3. **Apply 方式**：Spring Boot 启动 / 测试启动时 Flyway 自动 apply（项目必须在 `pom.xml` 声明 `flyway-core` + `flyway-mysql` 依赖）。`scripts/setup-test-db.sh` 只负责清空库，不做 apply
  110 +4. **已合并的 migration 永不修改**：发现错了写一个补救 migration（如 `V7__fix_V5_index_name.sql`），旧 `V_n.sql` 不动
  111 +5. **临时调试 DDL**：临时在本地试字段/索引可手动 `mysql -e`，但不写 migration；下次 `setup-test-db.sh` 会 drop+create 清掉
  112 +6. **计划 ③ 生成的 V1**：`V1__initial_schema.sql` 是计划阶段由 `lite-build-db` 从 `docs/03-数据库设计文档.md`（lite-design 正向设计的 schema SSoT）翻译生成的初始版本；后续 V2/V3/... 由编码阶段每个 REQ 按需写入，**同时**反向同步更新 docs/03 对应表小节以保持 SSoT 一致
  113 +
  114 +---
  115 +
  116 +## 🗂️ Git 提交规范
  117 +
  118 +每次提交必须遵循以下格式：
  119 +
  120 +```
  121 +<type>(<scope>): <subject>
  122 +```
  123 +
  124 +- `scope`: 模块名，如 `user` / `inventory` / `order`
  125 +- `subject`: 简短描述；业务类（feat / fix / test）必须带 `REQ-XXX-NNN` 后缀
  126 +
  127 +`type` 含义：
  128 +
  129 +| type | 看到它意味着 |
  130 +|-----|-------------|
  131 +| `feat` | **新能力上线**——用户多了一个功能、接口、页面或业务规则 |
  132 +| `fix` | **修 bug**——原来行为错了，这次改对 |
  133 +| `refactor` | **重构**——外部行为不变，只改代码结构 / 命名 / 抽象 |
  134 +| `docs` | **文档改动**——只动 Markdown / 代码注释，不动实现 |
  135 +| `style` | **格式调整**——空白 / 缩进 / import 顺序，逻辑 0 变化 |
  136 +| `test` | **只动测试代码**——补用例 / 修 fixture，不碰实现 |
  137 +| `chore` | **流程维护**——构建 / 依赖 / 工具 / 证据档案 / 里程碑元数据等非业务动作 |
  138 +
  139 +---
  140 +
  141 +## 🚩 中断机制
  142 +
  143 +功能循环（每个功能 REQ-XXX 的 feature-spec → feature-tdd → feature-review）默认 **静默编程**，但触发以下任何一条必须**立刻停下、记录原因、等人决策**，不得自行绕过：
  144 +
  145 +| # | 中断 | 例子 |
  146 +| - | --- | --- |
  147 +| 1 | **测试反复失败** | 同一测试同一功能内连续 **10 次**修复失败 |
  148 +| 2 | **要改密钥 / 账密 / 包名** | 涉及 .env.local / docs/04 §零环境 中的密钥/账密字段 |
  149 +| 3 | **外部接口不可达** | 第三方 API 无法连接、证书失效等环境问题，并无法自行解决 |
  150 +
  151 +> 其余需要人类判断的场景一律走普通 `AskUserQuestion` Q&A，不中断、不写 Blocker 文件。
  152 +
  153 +**触发中断时的固定动作：**
  154 +
  155 +1. 在当前功能的 spec 文件里追加一节 `## 🚩 Blocker`（报告格式由 `interrupt-check` 的 `interrupt-block-template.md` 持有）
  156 +2. 停止后续所有功能的静默执行
  157 +3. 在主会话输出一句话摘要 + 指向 blocker 文件的路径，等人回复
  158 +
  159 +---
  160 +
  161 +## 🟡 软规则（允许继续，但有强制后续动作）
  162 +
  163 +以下情况 **不触发中断**，CC 可自行继续推进，但必须在约定位置留痕，模块完成时统一审计。
  164 +
  165 +| # | 软规则 | 允许动作 | 强制后续 |
  166 +| - | ----- | ------- | ------- |
  167 +| S1 | **技术栈外组件引入** | 用 `AskUserQuestion` 给用户三选一：接受引入 / 换方案 / 拒绝 | ① **接受** → 同会话直接在 `docs/04 § 零` 追加一行 → 继续流程 ② **换方案 / 拒绝** → 视为常规歧义澄清，继续 Q&A 收敛 ③ 不写 Blocker、不中断流程 |
  168 +| S2 | **跨模块改动** | **默认不改**，仅为当前模块实现所必需时允许修改 | ① hook `log-cross-module.sh` 自动落存根 ② `milestone` 在打里程碑前调用 `interrupt-check` skill 批量补齐「原因 / 影响评估」节 |
  169 +
  170 +---
  171 +
  172 +## 🧭 通用工作准则（General Principles）
  173 +
  174 +### 1. Think Before Coding
  175 +
  176 +**Don't assume. Don't hide confusion. Surface tradeoffs.**
  177 +
  178 +Before implementing:
  179 +- State your assumptions explicitly. If uncertain, ask.
  180 +- If multiple interpretations exist, present them - don't pick silently.
  181 +- If a simpler approach exists, say so. Push back when warranted.
  182 +- If something is unclear, stop. Name what's confusing. Ask.
  183 +
  184 +### 2. Simplicity First
  185 +
  186 +**Minimum code that solves the problem. Nothing speculative.**
  187 +
  188 +- No features beyond what was asked.
  189 +- No abstractions for single-use code.
  190 +- No "flexibility" or "configurability" that wasn't requested.
  191 +- No error handling for impossible scenarios.
  192 +- If you write 200 lines and it could be 50, rewrite it.
  193 +
  194 +Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify.
  195 +
  196 +### 3. Surgical Changes
  197 +
  198 +**Touch only what you must. Clean up only your own mess.**
  199 +
  200 +When editing existing code:
  201 +- Don't "improve" adjacent code, comments, or formatting.
  202 +- Don't refactor things that aren't broken.
  203 +- Match existing style, even if you'd do it differently.
  204 +- If you notice unrelated dead code, mention it - don't delete it.
  205 +
  206 +When your changes create orphans:
  207 +- Remove imports/variables/functions that YOUR changes made unused.
  208 +- Don't remove pre-existing dead code unless asked.
  209 +
  210 +The test: Every changed line should trace directly to the user's request.
  211 +
  212 +### 4. Goal-Driven Execution
  213 +
  214 +**Define success criteria. Loop until verified.**
  215 +
  216 +Transform tasks into verifiable goals:
  217 +- "Add validation" → "Write tests for invalid inputs, then make them pass"
  218 +- "Fix the bug" → "Write a test that reproduces it, then make it pass"
  219 +- "Refactor X" → "Ensure tests pass before and after"
  220 +
  221 +For multi-step tasks, state a brief plan:
  222 +```
  223 +1. [Step] → verify: [check]
  224 +2. [Step] → verify: [check]
  225 +3. [Step] → verify: [check]
  226 +```
  227 +
  228 +Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification.
  229 +
  230 +---
  231 +
  232 +## 🗺️ Skill 索引（erp-workflow-lite，共 11 个）
  233 +
  234 +### 入口
  235 +
  236 +| Skill | 描述 |
  237 +|-------|------|
  238 +| `plan-start` | 计划阶段入口——扫 docs/08 § 一找第一个未完成计划段（①②③）并派发 |
  239 +| `coding-start` | 编码阶段入口——扫 docs/08 § 二找第一个未打里程碑模块并派发 phase-driver |
  240 +
  241 +### 计划阶段
  242 +
  243 +| Skill | 描述 |
  244 +|-------|------|
  245 +| `lite-init` | 计划 ①——项目初始化 + 范围锁定（模板复制、依赖检查、git init、项目概述+技术栈+需求索引、REQ 卡片生成，停下等人工审阅） |
  246 +| `lite-design` | 计划 ②——脚手架 + 数据库设计（docs/04 § 一+、scripts、.env.local、docs/03 DB 设计，停下等人工审阅） |
  247 +| `lite-build-db` | 计划 ③——DB 初始化 + 下游文档（V1 migration apply、docs/05 API 契约、docs/08 § 二模块清单，计划阶段结束） |
  248 +
  249 +### 编码阶段
  250 +
  251 +| Skill | 描述 |
  252 +|-------|------|
  253 +| `phase-driver` | 模块驱动——加载当前模块 REQ 清单，逐个派发 feature 循环 |
  254 +| `feature-spec` | 功能规格——为 REQ 生成 spec 文档（API 签名、数据变更、边界） |
  255 +| `feature-tdd` | TDD 实现——按 spec 写测试先行，再实现，Agent 子会话跑测试 |
  256 +| `feature-review` | AI 代码审查——审查当前 REQ 实现，verdict approve/reject，approve 时勾选进度 |
  257 +| `milestone` | 里程碑——内置测试闸门（Agent 子会话），green 则本地 merge + 打 tag，生成模块完成报告 |
  258 +
  259 +### 守门
  260 +
  261 +| Skill | 描述 |
  262 +|-------|------|
  263 +| `interrupt-check` | 中断检查——触发中断条件时由功能循环 skill 调用，追加 Blocker 节并停止执行 |
  264 +
  265 +### 文档套件（5 文档）
  266 +
  267 +| 文档 | 职责 |
  268 +|------|------|
  269 +| `docs/01-需求清单/` | REQ 卡片目录（模块子目录 + index.md） |
  270 +| `docs/03-数据库设计文档.md` | 表/字段/索引/外键 SSoT（lite-design 生成，编码阶段同步更新） |
  271 +| `docs/04-技术规范.md` | 技术栈总览（§ 零）+ 架构规范 + 环境变量说明（含 .env.local 密钥字段） |
  272 +| `docs/05-API接口契约.md` | 所有后端接口契约（lite-build-db 生成，feature-spec 按需追加） |
  273 +| `docs/08-模块任务管理.md` | 全流程进度跟踪（§ 一计划 / § 二编码） |
skills/plan/scope-lock/templates/_module-template.md renamed to skills/plan/lite-init/templates/_module-template.md
  View file @2ef891d
skills/plan/project-init/templates/docs-01-index-template.md renamed to skills/plan/lite-init/templates/docs-01-index-template.md
  View file @2ef891d
skills/plan/project-init/templates/docs-04-stack-template.md renamed to skills/plan/lite-init/templates/docs-04-stack-template.md
  View file @2ef891d
skills/plan/lite-init/templates/docs-08-initial-template.md 0 → 100644
  View file @2ef891d
  1 +# 08-工作流进度
  2 +
  3 +> 全流程进度跟踪。CC 每完成一项产出就勾选一项。
  4 +> - **§ 一 计划阶段**：`plan-start` 找第一个未勾的计划段（①②③）分发到对应 skill
  5 +> - **§ 二 Coding（模块）**：`coding-start` 扫描 docs/08 § 二 的 `里程碑:` 字段 + 本地 `git tag -l 'milestone/<id>'`，找第一个未打里程碑模块分发。本 § 二 行序无语义，仅作模块元数据表
  6 +
  7 +## 一、计划阶段进度
  8 +
  9 +- [ ] 计划 ① 初始化 + 范围锁定 — lite-init
  10 + - [ ] 项目文件骨架已创建（CLAUDE.md + docs/01 index + docs/04 + docs/08）
  11 + - [ ] 依赖检查通过（git / mysql）
  12 + - [ ] Git 已初始化
  13 + - [ ] 项目概述已填写（CLAUDE.md § 🎯 项目概述）
  14 + - [ ] 技术栈已确认（docs/04 § 零）
  15 + - [ ] 需求清单索引已填写（docs/01-需求清单/index.md）
  16 + - [ ] REQ 卡片骨架已生成（docs/01-需求清单/<module>/REQ-*.md）
  17 +- [ ] 计划 ② 脚手架 + 数据库设计 — lite-design
  18 + - [ ] 架构文档已生成（docs/04 § 一+ ｜ scripts/*.sh ｜ .env.local ｜ sql/migrations/）
  19 + - [ ] docs/03 数据库设计已生成（REQ → 表/字段/索引/外键，回填 REQ 依赖表）
  20 +- [ ] 计划 ③ DB 初始化 + 下游文档 — lite-build-db
  21 + - [ ] V1 migration 已生成并校验 + apply 到本地 MySQL
  22 + - [ ] docs/05 API 契约已生成 + 回填 REQ 依赖接口
  23 + - [ ] docs/08 § 二 模块清单（含 REQ 顺序）已生成
  24 +
  25 +## 二、Coding 阶段（模块循环）
  26 +
  27 +（lite-build-db 填入后，每行一个后端模块。每个模块的 `里程碑:` 字段在 `—` 和 `milestone/<id>` 之间变化，完成由本地 `git tag -l` 判定。`coding-start` 每次扫每模块的里程碑 tag 决定派发。所有模块打里程碑后整体完成。）
  28 +
  29 +<!-- 模块格式示例（由 lite-build-db 追加；功能子项由 feature-review 在 approve 时勾选）：
  30 +- module_0 系统管理
  31 + - 依赖: —
  32 + - 路径: backend/module/sys/
  33 + - 里程碑: —
  34 + - 功能:
  35 + - [ ] REQ-SYS-001 用户登录
  36 + - [ ] REQ-SYS-002 用户注册
  37 +-->
skills/plan/scope-lock/templates/req-card-template.md renamed to skills/plan/lite-init/templates/req-card-template.md
  View file @2ef891d
skills/plan/project-init/SKILL.md deleted
View file @9508a55
1 ----  
2 -name: project-init  
3 -description: A0 项目初始化——从插件模板幂等地复制 CLAUDE.md / docs/01-需求清单/index.md / docs/04-技术规范.md / docs/08-模块任务管理.md（已存在则跳过），并初始化 Git（如未初始化）。session-start 在 docs/08 缺失时派发本 skill。  
4 -user-invocable: false  
5 -allowed-tools: Glob Edit Skill Bash(mkdir *) Bash(cp -n *) Bash(git init) Bash(command -v *) Bash(uname *) Bash(brew *) Bash(apt *) Bash(apt-get *) Bash(yum *) Bash(apk *) Bash(export PATH=*) Bash(echo *) Bash(cat *)  
6 ----  
7 -  
8 -**所有输出必须使用中文。**  
9 -  
10 -你负责在项目目录中创建初始文件结构，已存在的文件不覆盖。  
11 -  
12 -## 执行步骤  
13 -  
14 -### 步骤 0：打印当前位置流程图  
15 -  
16 -用 `Bash` 执行 `cat` 命令向用户展示当前位置流程图（stdout 即 ASCII 框图）：  
17 -  
18 -```bash  
19 -cat "${CLAUDE_PLUGIN_ROOT}/skills/plan/project-init/banners/flow.txt"  
20 -```  
21 -  
22 -### A. 幂等复制模板文件  
23 -  
24 -用 `Bash` 一次性完成。`cp -n` 表示"不覆盖已存在的文件"：  
25 -  
26 -```bash  
27 -mkdir -p docs/01-需求清单  
28 -cp -n "${CLAUDE_SKILL_DIR}/templates/CLAUDE-template.md" CLAUDE.md  
29 -cp -n "${CLAUDE_SKILL_DIR}/templates/docs-01-index-template.md" docs/01-需求清单/index.md  
30 -cp -n "${CLAUDE_SKILL_DIR}/templates/docs-04-stack-template.md" docs/04-技术规范.md  
31 -cp -n "${CLAUDE_SKILL_DIR}/templates/docs-08-initial-template.md" docs/08-模块任务管理.md  
32 -```  
33 -  
34 -完成后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：  
35 -- ` - [ ] 项目文件骨架已创建（CLAUDE.md + docs/01-需求清单/index.md + docs/04-技术规范.md）`  
36 -  
37 -### B. 依赖检查 + 自动安装（命令行工具）  
38 -  
39 -对 **git、mysql** 两个工具依次执行以下流程。  
40 - 1. 如果缺失，尝试自动安装。  
41 - 2. 如果检测到不在 PATH，尝试添加进 PATH，并加载。  
42 -  
43 -全部通过后打印单行汇总再进入步骤 C：  
44 -  
45 -```  
46 -[project-init] 依赖检查: git ✓ mysql ✓  
47 -```  
48 -  
49 -完成后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：  
50 -- ` - [ ] 依赖检查通过`  
51 -  
52 -### C. 初始化 Git（如尚未初始化）  
53 -  
54 -用 `Glob` 检查 `.git/` 目录是否存在。  
55 -- 不存在 → 用 `Bash` 执行 `git init`。  
56 -- 已存在 → 跳过。  
57 -  
58 -完成后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选（A0 子项 + A0 顶层）：  
59 -- ` - [ ] Git 已初始化`  
60 -- `- [ ] A0 项目初始化 — project-init`  
61 -  
62 -### D. 打印完成横幅并进入 A1  
63 -  
64 -向用户输出：  
65 -  
66 -```  
67 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  
68 - [project-init] 项目初始化完成  
69 -  
70 - 已创建：  
71 - ✓ CLAUDE.md（从插件模板复制）  
72 - ✓ docs/01-需求清单/index.md（待人工填写模块索引）  
73 - ✓ docs/04-技术规范.md（默认技术栈，A1 让用户确认）  
74 - ✓ docs/08-模块任务管理.md（全流程进度跟踪）  
75 - 已勾选：A0 项目初始化  
76 -  
77 - 下一步：A1 scope-lock（填写项目概述 + 技术栈 + 需求索引 + REQ 卡片）  
78 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  
79 -```  
80 -  
81 -立即调用 `Skill(scope-lock)` 进入 A1，不等用户手动输入。  
82 -  
83 -## 参考  
84 -  
85 -- `${CLAUDE_SKILL_DIR}/templates/CLAUDE-template.md`（项目级 CLAUDE.md 模板）  
86 -- `${CLAUDE_SKILL_DIR}/templates/docs-01-index-template.md`（需求索引初稿）  
87 -- `${CLAUDE_SKILL_DIR}/templates/docs-04-stack-template.md`（默认技术栈）  
88 -- `${CLAUDE_SKILL_DIR}/templates/docs-08-initial-template.md`（A 阶段进度初始化）  
89 -- 下游：`scope-lock`（A1，自动派发）  
skills/plan/project-init/banners/flow.txt deleted
View file @9508a55
1 -┌────────────────────────────────────────────────────────┐  
2 -│ 📋 阶段 A：规划（一次性） │  
3 -│ │  
4 -│ ▶ A0 初始化项目 │  
5 -│ ↓ │  
6 -│ A1 锁范围（生成 REQ 卡片） → 人工审核 │  
7 -│ ↓ │  
8 -│ A2 生成骨架 │  
9 -│ ↓ │  
10 -│ A3 生成 DB 设计 → 人工审核 │  
11 -│ ↓ │  
12 -│ A4 初始化 DB │  
13 -│ ↓ │  
14 -│ A5 生成下游文档 │  
15 -│ │  
16 -│ 规划阶段到此结束 │  
17 -└────────────────────────────────────────────────────────┘  
skills/plan/project-init/templates/CLAUDE-template.md deleted
View file @9508a55
1 -# CLAUDE.md — ERP项目 Claude Code 主指令文件  
2 -  
3 -> 本文件是 Claude Code 的"操作手册"。Claude Code 启动时会自动读取此文件。  
4 -  
5 ----  
6 -  
7 -## 🎯 项目概述  
8 -  
9 -- **项目名称**: 【人工填写：公司 + 项目名，例如"XX 公司 ERP 管理系统"】  
10 -- **项目简述**: 【人工填写：一句话描述项目目标，例如"面向中小制造企业的全流程 ERP，涵盖采购/库存/生产/销售/财务"】  
11 -- **目标用户**: 【人工填写：谁会用，例如"企业内部管理人员（采购员、仓管员、生产主管、销售员、财务人员、管理层）"】  
12 -- **部署方式**: 【人工填写：私有化部署 / 云部署 / Docker 容器化 等】  
13 -  
14 ----  
15 -  
16 -## 🔄 B 阶段开发流程（后端模块循环 → 前端整体阶段）  
17 -  
18 -B 阶段分两段，**全部固化到 skills**。入口：`/erp-workflow:coding-start`。  
19 -  
20 -### 阶段路由（coding-start 内，只做分发）  
21 -  
22 -`coding-start` 每次入口做两段完成性检查后真值表派发：  
23 -  
24 -- 后端完成性检查 → `backend_done`（扫 docs/08 § 二 里程碑字段 + `git tag -l`）  
25 -- 前端完成性检查 → `frontend_done`（扫 docs/08 § 三 整体里程碑 + `git tag -l`）  
26 -  
27 -| `backend_done` | `frontend_done` | 派发 |  
28 -|---|---|---|  
29 -| `false` | 任意 | `module-start`（写后端） |  
30 -| `true` | `false` | `frontend-start`（写前端） |  
31 -| `true` | `true` | "所有阶段已完成" |  
32 -  
33 -前端阶段前置（prototype/ 门禁）由 `frontend-start` 自带，不在 coding-start。`module-start` 与 `frontend-start` **互不感知对方**。  
34 -  
35 -### 后端阶段（每模块一个里程碑 tag）  
36 -  
37 -- **模块循环（外）**：`module-start` → `test-gate(phase=backend)` → `module-report` → `milestone-tag`（本地 merge 进默认分支 + 打 `milestone/<id>` tag）→ 自动回调 coding-start 路由下一阶段（无人工介入）  
38 -- **功能循环（内，每 REQ-XXX-NNN 一遍）**：`feature-brainstorm` → `feature-plan` → `feature-tdd` → `feature-verify` → `feature-review`  
39 -- 后端阶段任务严格落在 `backend/` 路径下；docs/01 REQ 卡片的 UI 描述在此阶段忽略，UI 推迟到前端阶段。  
40 -  
41 -### 前端阶段（整体一个里程碑 tag，所有后端模块打里程碑后启动）  
42 -  
43 -- **FE 清单（AI 自主推导，无审阅断点）**：`frontend-start` 进入时扫 prototype + docs/01 + docs/05 → AI 自主推导 FE 业务功能清单写入 `docs/08 § 三`（已有则加载）。**FE 是业务功能粒度，与 prototype HTML 文件数无关**——一个 HTML 可拆多个 FE，多个 HTML 也可合成一个 FE。FE 清单的合理性由 fe-feature-review / milestone-tag 在整体里程碑标记时一并校核（全程无人工介入）。  
44 -- **FE 循环（外）**：`frontend-start` → fe-feature 循环 → `test-gate(phase=frontend)` → `module-report(phase=frontend)` → `milestone-tag`（分支 `frontend-phase`，docs/08 § 三 整体里程碑）。  
45 -- **FE 功能循环（内，每个 FE-NN 一遍）**：`fe-feature-brainstorm` → `fe-feature-plan` → `fe-feature-tdd` → `fe-feature-verify` → `fe-feature-review`（专用 `fe-code-reviewer` agent，硬编码 7 维 review checklist）  
46 -- 前端阶段任务严格落在 `frontend/` 路径下；布局以 `prototype/` 为权威。  
47 -  
48 -### 里程碑前测试闸门  
49 -  
50 -- `test-gate`：后端阶段子会话跑 `scripts/test.sh`（含本模块新增 + 已合并模块回归）；前端阶段子会话跑 vitest + playwright。  
51 -- `test-gate` 是打里程碑 tag 前唯一的硬测试门；红色不得跳过进入 `module-report` / `milestone-tag`。  
52 -  
53 ----  
54 -  
55 -## ✅ 阶段完成判定规则  
56 -  
57 -`docs/08-模块任务管理.md` 分两段：  
58 -- `§ 二`：后端模块元数据表（每个模块一行 bullet，记录依赖 / 路径 / 里程碑 tag / 功能子项）  
59 -- `§ 三`：前端阶段元数据（整体里程碑 + FE 子项清单，由 `frontend-start` 在所有后端模块打里程碑后填入）  
60 -  
61 -**阶段完成判定**统一以 `里程碑:` 字段（§ 二 各模块） / `整体里程碑:` 字段（§ 三）+ 本地 `git tag -l 'milestone/<id>'` 判定；子项勾选只作可视化进度，不参与完成判定。  
62 -  
63 -### 后端模块格式  
64 -  
65 -每个后端模块在 docs/08 § 二 中长这样：  
66 -  
67 -```markdown  
68 -- module_0 系统管理  
69 - - 依赖: —  
70 - - 路径: backend/module/sys/  
71 - - 里程碑: —  
72 - - 功能:  
73 - - [ ] REQ-SYS-001 用户登录  
74 - - [ ] REQ-SYS-002 用户注册  
75 -```  
76 -  
77 -- `里程碑:` 字段由 `milestone-tag` 在打里程碑 tag 时从 `—` 改为 `milestone/<module_id>`。  
78 -- 每个 `REQ-*` 子项由 `feature-review` 在 `verdict=approve` 时自动勾选为 `[x]`。  
79 -- 路径限定为后端目录（如 `backend/module/sys/`）；前端代码不在此阶段产生。  
80 -  
81 -### 前端阶段格式（§ 三）  
82 -  
83 -```markdown  
84 -- 整体里程碑: —  
85 -- 功能:  
86 - - [ ] FE-01 用户登录与注册 ｜ 关联 REQ：REQ-SYS-001, REQ-SYS-002 ｜ 关联原型：prototype/auth.html  
87 - - [ ] FE-02 仪表盘总览 ｜ 关联 REQ：REQ-DASH-001 ｜ 关联原型：prototype/dashboard.html  
88 -```  
89 -  
90 -- `整体里程碑:` 字段由 `milestone-tag` 在打前端里程碑 tag 时从 `—` 改为 `milestone/frontend-phase`。  
91 -- "功能:" 列表由 `frontend-start` 进入时由 AI 自主推导写入（无人工审阅断点）。FE 是业务功能粒度，与 prototype HTML 文件数无关；合理性由 fe-feature-review / 整体里程碑标记时统一校核。  
92 -- 每个 `FE-NN` 子项由 `fe-feature-review` 在 `verdict=approve` 时自动勾选为 `[x]`。  
93 -- 进入前端阶段前 `frontend-start` 步骤 1 自带 prototype/ 门禁，强制检查项目根 `prototype/` 至少含 1 个 `*.html` mockup。  
94 -  
95 -### 状态语义（后端模块 + 前端阶段共用）  
96 -  
97 -| `里程碑:` 字段 | `git tag -l` | 含义 | 你（Claude Code）的行为 |  
98 -|---|---|---|---|  
99 -| `—` | tag 不存在 | 该阶段未开始 / 进行中（未打里程碑） | ✅ 开始 / 继续该阶段开发 |  
100 -| `milestone/<id>` | tag 存在 | 阶段**已完成** | 🟢 后端：进入下一未完成模块；后端全完 → 前端阶段；前端已打里程碑 → 全部完成 |  
101 -  
102 -### 模块完成报告  
103 -  
104 -由 `module-report` skill 产出，模板位于 由 module-report skill 持有（12 节标准化，含跨模块改动等 CLAUDE.md 软规则映射节）。CC 不手写模块报告，仅填模板。  
105 -  
106 ----  
107 -  
108 -## 🏷️ 占位符统一约定  
109 -  
110 -项目文档里有 **2 种填写占位** + **1 种提示占位**：  
111 -  
112 -| 格式 | 谁填 | 使用阶段 | 说明 |  
113 -|------|-----|---------|------|  
114 -| `【人工填写：<简短说明>】` | 人 | 仅 A 阶段文档 | 密钥 / 账密 / 包名 / 命名约定 / 小版本号等人工才能决定的值；B 阶段 plan/spec 禁止出现，查不到真值时用 `AskUserQuestion` 问用户 |  
115 -| `TBD(<责任人>)` | CC 自动 | A 或 B | 后缀附带责任方（如 `TBD(A3 自动补)` / `TBD(A5 自动补)`）；由对应 skill 就地补填，`module-report` § ⑦ 检查 `TBD(CC 补)` 残留 |  
116 -  
117 -**HTML 注释 `<!-- ... -->`**：提示占位，是**插件内部大纲模板**里给 LLM 的**填空提示 / 章节引导**，指引 LLM 按结构填实际内容。skill 生成时会**剥除**这些注释，最终产物里注释不会保留。  
118 -  
119 ----  
120 -  
121 -## 📐 编码行为约束  
122 -  
123 -### 你必须做的 ✅  
124 -  
125 -1. **严格遵循** `docs/04-技术规范.md`——命名 / 编码 / 统一响应 / 异常处理 / 数据访问 / 配置与安全 等项目专属技术规约全部在此  
126 -2. **严格遵循** `docs/09-项目目录结构.md`——文件放对位置  
127 -3. **每个后端接口** 必须先在 `docs/05-API接口契约.md` 定义，再编码实现  
128 -4. **每个功能可追溯到 `REQ-XXX-NNN`**——commit tag + 代码注释（如 `// REQ-SYS-001: 用户登录`）+ plan/spec 文件名均用此 tag  
129 -5. **遇到跨模块改动**（动到非当前模块的代码）——按 § 🟡 软规则 **S2** 执行（允许改，但必须留痕）  
130 -6. **遇到技术栈外组件引入**（`docs/04 § 零` 技术栈表外的框架 / 中间件 / 关键库），按 § 🟡 软规则 **S1** 执行（允许引入，但必须先 AskUserQuestion）  
131 -  
132 -### 你禁止做的 🚫  
133 -  
134 -1. **主会话直接 `mysql -e` 跑业务 DDL**（只读查询 / 临时本地调试除外）——业务 schema 必须走 `sql/migrations/V_n__*.sql`，详见下方 Schema 演化规约  
135 -2. **手动 Edit `docs/08 § 二/§ 三` 的 `里程碑:` / `整体里程碑:` 字段**，必须要由 `milestone-tag` 自动回写  
136 -  
137 -### Schema 演化规约（Flyway migration）  
138 -  
139 -1. **文件命名**：`sql/migrations/V<n>__<snake_case_desc>.sql`，例：`V5__add_user_email_unique_index.sql`  
140 -2. **版本号分配**：建文件前 `ls sql/migrations/V*.sql` 查当前最大 n，新文件 `n_max + 1`  
141 -3. **Apply 方式**：Spring Boot 启动 / 测试启动时 Flyway 自动 apply（项目必须在 `pom.xml` 声明 `flyway-core` + `flyway-mysql` 依赖）。`scripts/setup-test-db.sh` 只负责清空库，不做 apply  
142 -4. **已合并的 migration 永不修改**：发现错了写一个补救 migration（如 `V7__fix_V5_index_name.sql`），旧 `V_n.sql`  
143 -5. **临时调试 DDL**：临时在本地试字段/索引可手动 `mysql -e`，但不写 migration；下次 `setup-test-db.sh` 会 drop+create 清掉  
144 -6. **A4 生成的 V1**：`V1__initial_schema.sql` 是 A 阶段由 `db-init` 从 `docs/03-数据库设计文档.md`（A3 正向设计的 schema SSoT）翻译生成的初始版本；后续 V2/V3/... 由 B 阶段每个 REQ 按需写入，**同时**反向同步更新 docs/03 对应表小节以保持 SSoT 一致  
145 -  
146 ----  
147 -  
148 -## 🗂️ Git 提交规范  
149 -  
150 -每次提交必须遵循以下格式：  
151 -  
152 -```  
153 -<type>(<scope>): <subject>  
154 -```  
155 -  
156 -- `scope`: 模块名，如 `user` / `inventory` / `order`  
157 -- `subject`: 简短描述；业务类（feat / fix / test）必须带 `REQ-XXX-NNN` 后缀  
158 -  
159 -`type` 含义：  
160 -  
161 -| type | 看到它意味着 |  
162 -|-----|-------------|  
163 -| `feat` | **新能力上线**——用户多了一个功能、接口、页面或业务规则 |  
164 -| `fix` | **修 bug**——原来行为错了，这次改对 |  
165 -| `refactor` | **重构**——外部行为不变，只改代码结构 / 命名 / 抽象 |  
166 -| `docs` | **文档改动**——只动 Markdown / 代码注释，不动实现 |  
167 -| `style` | **格式调整**——空白 / 缩进 / import 顺序，逻辑 0 变化 |  
168 -| `test` | **只动测试代码**——补用例 / 修 fixture，不碰实现 |  
169 -| `chore` | **流程维护**——构建 / 依赖 / 工具 / 证据档案 / 里程碑元数据等非业务动作 |  
170 -  
171 ----  
172 -  
173 -## 🚩 中断机制  
174 -  
175 -功能循环（每个功能 REQ-XXX 的 Brainstorm → Plan → TDD → Verify → AI 自审）默认 **静默编程**，但触发以下任何一条必须**立刻停下、记录原因、等人决策**，不得自行绕过：  
176 -  
177 -| # | 中断 | 例子 |  
178 -| - | --- | --- |  
179 -| 1 | **测试反复失败** | 同一测试同一功能内连续 **10 次**修复失败 |  
180 -| 2 | **要改密钥 / 账密 / 包名** | `docs/07-环境配置.md` 里由人工标注必须填的字段 |  
181 -| 3 | **外部接口不可达** | 第三方 API 无法连接、证书失效等环境问题，并无法自行解决 |  
182 -  
183 -> 其余需要人类判断的场景一律走普通 `AskUserQuestion` Q&A，不中断、不写 Blocker 文件。  
184 -  
185 -**触发中断时的固定动作：**  
186 -  
187 -1. 在当前功能的 plan 文件里追加一节 `## 🚩 Blocker`（报告格式由 `interrupt-check` 的 `interrupt-block-template.md` 持有）  
188 -2. 停止后续所有功能的静默执行  
189 -3. 在主会话输出一句话摘要 + 指向 blocker 文件的路径，等人回复  
190 -  
191 ----  
192 -  
193 -## 🟡 软规则（允许继续，但有强制后续动作）  
194 -  
195 -以下情况 **不触发中断**，CC 可自行继续推进，但必须在约定位置留痕，模块完成时统一审计。  
196 -  
197 -| # | 软规则 | 允许动作 | 强制后续 |  
198 -| - | ----- | ------- | ------- |  
199 -| S1 | **技术栈外组件引入** | 用 `AskUserQuestion` 给用户三选一：接受引入 / 换方案 / 拒绝 | ① **接受** → 同会话直接在 `docs/04 § 零` 追加一行 → 继续流程 ② **换方案 / 拒绝** → 视为常规歧义澄清，继续 Q&A 收敛 ③ 不写 Blocker、不中断流程 |  
200 -| S2 | **跨模块改动** | **默认不改**，仅为当前模块实现所必需时允许修改 | ① hook `log-cross-module.sh` 自动落存根 ② `module-report` 一次性调用 `cross-module-log` skill 批量补齐「原因 / 影响评估」+ 「跨模块改动」节完整贴入《模块完成报告》 |  
201 -  
202 ----  
203 -  
204 -## 🧭 通用工作准则（General Principles）  
205 -  
206 -### 1. Think Before Coding  
207 -  
208 -**Don't assume. Don't hide confusion. Surface tradeoffs.**  
209 -  
210 -Before implementing:  
211 -- State your assumptions explicitly. If uncertain, ask.  
212 -- If multiple interpretations exist, present them - don't pick silently.  
213 -- If a simpler approach exists, say so. Push back when warranted.  
214 -- If something is unclear, stop. Name what's confusing. Ask.  
215 -  
216 -### 2. Simplicity First  
217 -  
218 -**Minimum code that solves the problem. Nothing speculative.**  
219 -  
220 -- No features beyond what was asked.  
221 -- No abstractions for single-use code.  
222 -- No "flexibility" or "configurability" that wasn't requested.  
223 -- No error handling for impossible scenarios.  
224 -- If you write 200 lines and it could be 50, rewrite it.  
225 -  
226 -Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify.  
227 -  
228 -### 3. Surgical Changes  
229 -  
230 -**Touch only what you must. Clean up only your own mess.**  
231 -  
232 -When editing existing code:  
233 -- Don't "improve" adjacent code, comments, or formatting.  
234 -- Don't refactor things that aren't broken.  
235 -- Match existing style, even if you'd do it differently.  
236 -- If you notice unrelated dead code, mention it - don't delete it.  
237 -  
238 -When your changes create orphans:  
239 -- Remove imports/variables/functions that YOUR changes made unused.  
240 -- Don't remove pre-existing dead code unless asked.  
241 -  
242 -The test: Every changed line should trace directly to the user's request.  
243 -  
244 -### 4. Goal-Driven Execution  
245 -  
246 -**Define success criteria. Loop until verified.**  
247 -  
248 -Transform tasks into verifiable goals:  
249 -- "Add validation" → "Write tests for invalid inputs, then make them pass"  
250 -- "Fix the bug" → "Write a test that reproduces it, then make it pass"  
251 -- "Refactor X" → "Ensure tests pass before and after"  
252 -  
253 -For multi-step tasks, state a brief plan:  
254 -```  
255 -1. [Step] → verify: [check]  
256 -2. [Step] → verify: [check]  
257 -3. [Step] → verify: [check]  
258 -```  
259 -  
260 -Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification.  
skills/plan/project-init/templates/docs-08-initial-template.md deleted
View file @9508a55
1 -# 08-工作流进度  
2 -  
3 -> 全流程进度跟踪。CC 每完成一项产出就勾选一项。  
4 -> - **§ 一 Plan（A0~A5）**：`plan-start` 找第一个未勾 A 子项分发到对应 skill  
5 -> - **§ 二 Coding（模块）**：分发以 `docs/02-开发计划.md § 二 开发顺序清单` 为准；`coding-start` 按 docs/02 顺序扫描，对每个 REQ 所属模块查询本 § 二的 `里程碑:` 字段 + 本地 `git tag -l 'milestone/<id>'`，找第一个未打里程碑模块分发。本 § 二 行序无语义，仅作模块元数据表  
6 -  
7 -## 一、Plan 阶段（一次性）  
8 -  
9 -- [ ] A0 项目初始化 — project-init  
10 - - [ ] 依赖检查通过  
11 - - [ ] 项目文件骨架已创建（CLAUDE.md + docs/01-需求清单/index.md + docs/04-技术规范.md）  
12 - - [ ] Git 已初始化  
13 -  
14 -- [ ] A1 范围锁定 — scope-lock  
15 - - [ ] 项目概述已填写（CLAUDE.md § 🎯 项目概述）  
16 - - [ ] 技术栈已确认（docs/04 § 零）  
17 - - [ ] 需求清单索引已填写（docs/01-需求清单/index.md）  
18 - - [ ] REQ 卡片骨架已生成（docs/01-需求清单/<module>/REQ-*.md，业务内容留待人工填写）  
19 -  
20 -- [ ] A2 骨架生成 — skeleton-gen  
21 - - [ ] 架构文档已生成（docs/04 § 一+、docs/06、docs/07、docs/09）  
22 - - [ ] 工具脚本已生成（scripts/*.sh、.env.local）  
23 - - [ ] .gitignore 已配置  
24 -  
25 -- [ ] A3 DB 设计 + REQ 回填 — db-design-gen  
26 - - [ ] docs/03-数据库设计文档.md 已生成  
27 - - [ ] docs/01 各 REQ 卡片"依赖表" + 模块头"涉及表" 已回填  
28 -  
29 -- [ ] A4 DB 初始化 — db-init  
30 - - [ ] sql/migrations/V1__initial_schema.sql 已生成  
31 - - [ ] DDL 与 docs/03 全量一致  
32 - - [ ] .env.local 凭据已验证（mysql -e "SELECT 1" OK）  
33 - - [ ] setup-test-db.sh 防护通过 + DROP+CREATE + apply V1 已执行  
34 - - [ ] SHOW TABLES 行数 == docs/03 表数量  
35 -  
36 -- [ ] A5 下游文档生成 — downstream-gen  
37 - - [ ] docs/02 开发计划已生成  
38 - - [ ] docs/05 API 契约已生成  
39 - - [ ] docs/06 § 三 页面清单已填入  
40 - - [ ] docs/10 验收清单已生成  
41 - - [ ] 下方模块列表已填入  
42 - - [ ] REQ 卡片依赖接口已回填  
43 -  
44 -## 二、Coding 阶段（后端模块循环）  
45 -  
46 -（A5 填入后，每行一个后端模块。每个模块的 `里程碑:` 字段在 `—` 和 `milestone/<id>` 之间变化，完成由本地 `git tag -l` 判定。`coding-start` 每次按 docs/02 REQ 序扫每模块的里程碑 tag 决定派发。后端模块全部打里程碑后自动进入 § 三 前端阶段。）  
47 -  
48 -<!-- 模块格式示例（由 A5 downstream-gen 追加；功能子项由 feature-review 在 approve 时勾选）：  
49 -- module_0 系统管理  
50 - - 依赖: —  
51 - - 路径: backend/module/sys/  
52 - - 里程碑: —  
53 - - 功能:  
54 - - [ ] REQ-SYS-001 用户登录  
55 - - [ ] REQ-SYS-002 用户注册  
56 --->  
57 -  
58 -## 三、Coding 阶段（前端整体）  
59 -  
60 -（`frontend-start` 进入时扫 prototype/ + docs/01 + docs/05 → AI 自主推导 FE 业务功能清单写到下方"功能:"项（无人工审阅断点；合理性由整体里程碑标记时统一校核）。已有清单则直接加载。整个前端阶段 1 个里程碑 tag，分支 `frontend-phase`。）  
61 -  
62 -- 整体里程碑: —  
63 -- 功能:  
64 - <!-- AI 进入时按以下行格式写入（每行 1 个 FE，可关联多个 REQ / 多份原型）：  
65 - - [ ] FE-NN 功能名 ｜ 关联 REQ：REQ-A, REQ-B ｜ 关联原型：prototype/<file>.html, prototype/<other>.html  
66 -  
67 - 示例：  
68 - - [ ] FE-01 用户登录与注册 ｜ 关联 REQ：REQ-SYS-001, REQ-SYS-002 ｜ 关联原型：prototype/auth.html  
69 - - [ ] FE-02 仪表盘总览 ｜ 关联 REQ：REQ-DASH-001 ｜ 关联原型：prototype/dashboard.html  
70 - -->  
skills/plan/scope-lock/SKILL.md deleted
View file @9508a55
1 ----  
2 -name: scope-lock  
3 -description: A1 计划范围锁定——引导用户填写项目概述 + 技术栈 + 需求索引，并按模块子目录生成 REQ 卡片骨架（CC 推断 req_id/title/goal/rules/constraints/acceptance；输入/输出 各含一句简述 + N 张示例字段表全部原样复制由人工编辑；依赖表/依赖接口模板写死 `TBD(A3/A5 自动补)` 由后续 skill 回填）。  
4 -user-invocable: false  
5 -allowed-tools: Read Edit Grep Skill AskUserQuestion Bash(mkdir *) Bash(cp *) Bash(sed *) Bash(bash *) Bash(cat *)  
6 ----  
7 -  
8 -**所有输出必须使用中文。**  
9 -  
10 -# scope-lock  
11 -  
12 -## 执行步骤  
13 -  
14 -### 步骤 0：打印当前位置流程图  
15 -  
16 -用 `Bash` 执行 `cat` 命令向用户展示当前位置流程图（stdout 即 ASCII 框图）：  
17 -  
18 -```bash  
19 -cat "${CLAUDE_PLUGIN_ROOT}/skills/plan/scope-lock/banners/flow.txt"  
20 -```  
21 -  
22 -### A. 提示用户填写项目概述并等待  
23 -  
24 -向用户输出：  
25 -  
26 -```  
27 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  
28 - [scope-lock] 请填写项目概述  
29 -  
30 - 📄 文件位置: ./CLAUDE.md  
31 - 📌 编辑位置: § 🎯 项目概述  
32 -  
33 - 请将以下占位符替换为实际值：  
34 - - 项目名称  
35 - - 项目简述  
36 - - 目标用户  
37 - - 部署方式  
38 - 改完后回来选择「继续」。  
39 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  
40 -```  
41 -  
42 -用 `AskUserQuestion` 询问：  
43 -- **question**: `项目概述填写完毕了吗？`  
44 - - 用户选择「继续」→ 用 `Grep` 在 `CLAUDE.md` 搜索 `【人工填写：`（限定 § 🎯 项目概述 节）。命中 → 打印残留行 + 路径，重新弹出同样的 AskUserQuestion；0 命中 → 勾选并进入步骤 B。  
45 - - 用户选择「有疑问想先沟通」→ 回答用户问题后，再次弹出同样的 QA。  
46 -  
47 -0 命中后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：  
48 -- ` - [ ] 项目概述已填写（CLAUDE.md § 🎯 项目概述）`  
49 -  
50 -### B. 提示用户检查默认技术栈并等待  
51 -  
52 -`docs/04-技术规范.md` 已由 A0 `project-init` 用模板复制（默认技术栈，见 `project-init/templates/docs-04-stack-template.md`）。本步骤让用户检查 / 调整 § 零。  
53 -  
54 -向用户输出：  
55 -  
56 -```  
57 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  
58 - [scope-lock] 技术栈已保存  
59 -  
60 - 📄 文件位置: ./docs/04-技术规范.md（由 A0 模板生成）  
61 - 📌 编辑位置: § 零、技术栈总览  
62 -  
63 - 请检查技术栈表：  
64 - - 不需要的行直接删除（如纯后端项目删前端行）  
65 - - 需要替换的技术直接改  
66 - - 需要新增的条目直接加行  
67 - 改完后回来选择「继续」。  
68 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  
69 -```  
70 -  
71 -用 `AskUserQuestion` 询问：  
72 -- **question**: `技术栈检查完毕了吗？`  
73 - - 用户选择「继续」→ 进入步骤 C。  
74 - - 用户选择「有疑问想先沟通」→ 回答用户问题后，再次弹出同样的 QA。  
75 -  
76 -完成后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：  
77 -- ` - [ ] 技术栈已确认（docs/04 § 零）`  
78 -  
79 -### C. 提示用户填写需求清单并等待  
80 -  
81 -`docs/01-需求清单/index.md` 已由 `project-init` 写入占位符模板，这里让用户补齐模块清单。  
82 -  
83 -向用户输出：  
84 -  
85 -```  
86 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  
87 - [scope-lock] 请填写需求清单模块索引  
88 -  
89 - 📄 文件位置: ./docs/01-需求清单/index.md  
90 - 📌 编辑位置: § 模块索引（表格）  
91 -  
92 - 请按业务列出所有模块：  
93 - - 每行一个模块（如 SYS 系统管理 / PUR 采购 / SAL 销售）  
94 - - 「核心功能点」只需关键词，CC 会拆分为 REQ 卡片  
95 - 改完后回来选择「继续」。  
96 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  
97 -```  
98 -  
99 -用 `AskUserQuestion` 询问：  
100 -- **question**: `需求清单模块索引填写完毕了吗？`  
101 - - 用户选择「继续」→ 进入步骤 D。  
102 - - 用户选择「有疑问想先沟通」→ 回答用户问题后，再次弹出同样的 QA。  
103 -  
104 -完成后，用 `Edit` 在 `docs/08-模块任务管理.md` 中勾选：  
105 -- ` - [ ] 需求清单索引已填写（docs/01-需求清单/index.md）`  
106 -  
107 -### D. 生成 REQ 卡片骨架并停下等人工审阅  
108 -  
109 -1. 用 `Grep` 校验 `docs/01-需求清单/index.md` 无 `【人工填写：` 残留；有则回步骤 C。  
110 -2. 用 `Read` 读 `index.md` 解析模块索引。  
111 -3. **单次 Bash 写入所有文件**（替代 N×9 次 Edit）：  
112 -  
113 - - **每模块推断**：三元组 `{module_code, module_name, module_brief}` + N 个 REQ 的六元组 `{req_id, title, goal, rules, constraints, acceptance}`。`req_id`/`title` 从核心功能点拆分；`goal` 展开 `title`；`rules`/`constraints`/`acceptance` 起草业务语义。**不推断**输入 / 输出（模板原样保留示例）。  
114 - - **单次 Bash**：调 `${CLAUDE_SKILL_DIR}/scripts/render.sh` 落盘所有文件（脚本内部完成模板读取 + 占位符替换 + HTML 注释剥离）。下面是**调用形态**示例，`<MOD>` / `<模块名>` / `<REQ-MOD-NNN>` 等尖括号位置 CC 按 `index.md` 实际值替换：  
115 -  
116 - ```bash  
117 - R="${CLAUDE_SKILL_DIR}/scripts/render.sh"  
118 - # 每个模块：mkdir + 1 个 render module + N 个 render req（每 REQ 一行）  
119 - mkdir -p "docs/01-需求清单/<MOD>-<模块名>"  
120 - bash "$R" module "docs/01-需求清单/<MOD>-<模块名>/_module.md" "<MOD>" "<模块名>" "<module_brief>"  
121 - bash "$R" req "docs/01-需求清单/<MOD>-<模块名>/<REQ-MOD-NNN>.md" "<REQ-MOD-NNN>" "<title>" "<goal>" "<rules>" "<constraints>" "<acceptance>"  
122 - ```  
123 -  
124 - - **兜底**：值含字面 `$xxx` 或 `}}` 的 REQ 单独走 cp + Edit。  
125 -4. 用 `Edit` 在 `docs/08-模块任务管理.md` 勾选（A1 子项 + A1 顶层）：  
126 - - ` - [ ] REQ 卡片骨架已生成（docs/01-需求清单/<module>/REQ-*.md，业务内容留待人工填写）`  
127 - - `- [ ] A1 范围锁定 — scope-lock`  
128 -5. 打印停下横幅并**停止**：  
129 -  
130 -```  
131 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  
132 - [scope-lock] ✅ A1 范围锁定完成  
133 -  
134 - 产出：  
135 - ✓ CLAUDE.md § 🎯 项目概述  
136 - ✓ docs/04 § 零 技术栈  
137 - ✓ docs/01-需求清单/index.md 模块索引  
138 - ✓ docs/01-需求清单/<module>/_module.md 模块头  
139 - ✓ docs/01-需求清单/<module>/REQ-*.md REQ 卡片骨架  
140 -  
141 - ⏸ 现在请你逐张打开 REQ 卡片：  
142 - - **必改**：输入 / 输出 两段  
143 - · `表1` / `表2` 是模板示例，按本 REQ 业务**改字段 / 增删行 / 增删整张表**  
144 - - **审阅**：目标 / 跨字段规则 / 边界 / 验收（已起草，对照业务校正）  
145 - - **保留**：`TBD` 不要改，由之后流程自动回填  
146 -  
147 - 审阅完成后，运行以下命令继续进入 A2：  
148 - /erp-workflow:plan-start  
149 -  
150 -━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  
151 -```  
152 -  
153 -## 参考  
154 -  
155 -- `CLAUDE.md` § 🎯 项目概述（写入目标）  
156 -- `docs/04-技术规范.md`（技术栈输出，供 skeleton-gen 读取使用）  
157 -- `docs/01-需求清单/index.md`（模块索引输入）  
158 -- `docs/01-需求清单/<module>/_module.md`（模块头输出）  
159 -- `docs/01-需求清单/<module>/REQ-*.md`（REQ 卡片骨架输出，A3 db-design-gen / A5 downstream-gen 会回填 TBD 字段）  
160 -- `${CLAUDE_SKILL_DIR}/templates/req-card-template.md`  
161 -- `${CLAUDE_SKILL_DIR}/templates/_module-template.md`  
162 -- `${CLAUDE_SKILL_DIR}/scripts/render.sh`（步骤 D 渲染助手，dispatch `module` / `req` 两种模式）  
skills/plan/scope-lock/banners/flow.txt deleted
View file @9508a55
1 -┌────────────────────────────────────────────────────────┐  
2 -│ 📋 阶段 A：规划（一次性） │  
3 -│ │  
4 -│ A0 初始化项目 │  
5 -│ ↓ │  
6 -│ ▶ A1 锁范围（生成 REQ 卡片） → 人工审核 │  
7 -│ ↓ │  
8 -│ A2 生成骨架 │  
9 -│ ↓ │  
10 -│ A3 生成 DB 设计 → 人工审核 │  
11 -│ ↓ │  
12 -│ A4 初始化 DB │  
13 -│ ↓ │  
14 -│ A5 生成下游文档 │  
15 -│ │  
16 -│ 规划阶段到此结束 │  
17 -└────────────────────────────────────────────────────────┘