---

name: erp-module-start description: 启动/恢复模块循环。按 docs/02 § 二 REQ 清单定位当前模块及其 REQ 序列，确保处于模块分支，扫描 docs/superpowers/reviews/ 计算已完成 REQ，驱动第一个未完成 REQ 的功能循环；全部完成则调用 erp-local-test-gate。幂等可重入。 user-invocable: false

allowed-tools: Read Write Skill Glob Grep Bash(git branch *) Bash(git checkout *) Bash(git rev-parse *) Bash(glab mr *)

所有输出必须使用中文。

erp-module-start

执行步骤

步骤 1：按 docs/02 § 二 REQ 序 + MR state 定位当前模块 + 本模块 REQ 列表

与 erp-coding-start 步骤 3 同构（完成判定以 MR: 字段 + glab mr view state 为准）：

• 用 Read 读取 docs/02-开发计划.md，用 Grep（pattern ^\|\s*[0-9]+\s*\|\s*\*\*(REQ-[A-Z0-9]+-[0-9]+)\*\*\s*\|\s*(module_\w+)）抽取 § 二 表格数据行，按行号升序得 req_order[]。
• 若 req_order 为空 → 打印"⚠️ docs/02 § 二 REQ 开发顺序清单为空或无法解析，请检查"并停止。
• 初始化 module_merged[module_id → bool] 空缓存。按序遍历 req_order[]：
  • module_merged[module_id] 已缓存为 true → 跳过本 REQ。
  • module_merged[module_id] 已缓存为 false → current_module = module_id，结束遍历。
  • 未缓存 → 读取 docs/08 § 二 该模块条目的 - MR: 字段：
  • MR: — → module_merged[module_id] = false，current_module = module_id，结束遍历。
  • MR: !<iid> → Bash: glab mr view <iid> -F json 2>/dev/null，取 .state：
    • merged → 缓存 true，跳过本 REQ。
    • 其他 → 缓存 false，current_module = module_id，结束遍历。
• 抽取本模块 REQ 序列 req_list[]：从 req_order[] 取出所有 module_id == current_module 的项，按原序组成（同模块 REQ 必须连续，见 A5 约束）。
• 用 Read 读取 docs/08 § 二 该模块行 + 后续缩进行，提取 module_name / depends_on（REQ 列表以 docs/02 为准，不再读取 docs/08）。

步骤 2：所有模块已完成短路

如果 req_order[] 全部遍历完 current_module 仍未赋值（即所有模块都 merged）→ 打印"所有模块已完成"摘要并停止。

步骤 3：确保处于模块分支

• target_branch = module-<module_id>（例 module-module_sys）。
• 用 Bash 执行 git branch --show-current 得 current_branch。
• current_branch == target_branch → 继续步骤 4。
• 否则用 Bash 执行 git rev-parse --verify <target_branch> 2>/dev/null：
  • 存在 → git checkout <target_branch>
  • 不存在 → git checkout -b <target_branch>
• 若当前工作区有未提交改动且 checkout 失败 → 打印错误并停止（请用户手工处理 dirty state）。

步骤 4：初始化跨模块日志（幂等）

docs/superpowers/module-reports/<module_id>-cross-module.md — 不存在则从 ${CLAUDE_SKILL_DIR}/templates/cross-module-log-template.md 创建。

步骤 5：计算已完成 REQ 集合 done_reqs[]（幂等断点恢复关键）

• 对 req_list[] 每个 req_id，用 Glob 查 docs/superpowers/reviews/*-<req_id>.md。
• 命中后用 Grep（pattern ^verdict:\s*approve，-i 不敏感）检查首部 verdict。
• 两者都命中 → 加入 done_reqs[]。

步骤 6：渲染并打印模块横幅

Read ${CLAUDE_SKILL_DIR}/templates/module-start-banner-template.md，填充槽位；reqs[] 每项的 status 字段根据 done_reqs[] 填 x（已完成）或空格（未完成）。

步骤 7：推进主循环

• 从 req_list[] 取第一个不在 done_reqs[] 中的 REQ 作为 next_req。
• 没有 next_req（全部完成）→ 调用 Skill(erp-local-test-gate) 进入模块闸门。
• 有 next_req → 调用 Skill(erp-feature-brainstorm) 启动该 REQ 的功能循环。功能循环链（brainstorm → plan → tdd → verify → review）完成后，erp-feature-review 在 verdict=approve 分支会回调 Skill(erp-module-start) —— 再次进入本 skill 时，步骤 5 会把刚通过的 REQ 加入 done_reqs[]，步骤 7 自动取下一 REQ，形成可重入推进。
• 任何中断（红旗 / 测试持续失败 / review 5 轮仍 request-changes）→ 停止本模块，不要静默跳下一 REQ。

参考

• docs/02-开发计划.md § 二 开发顺序清单（分发权威）
• docs/08-模块任务管理.md § 二（模块元数据，含 MR: 字段；完成判定以 MR state 为准）
• docs/superpowers/reviews/*.md（REQ 级进度事实——verdict=approve 即完成）
• ${CLAUDE_SKILL_DIR}/templates/module-start-banner-template.md
• ${CLAUDE_SKILL_DIR}/templates/cross-module-log-template.md
• 下游：erp-feature-*、erp-local-test-gate