---

name: module-start description: 后端模块循环入口。定位当前未完成（未打里程碑 tag）模块与未完成 REQ，派发 feature-brainstorm 或 test-gate；幂等可重入。阶段路由由 coding-start 负责，本 skill 不感知前端阶段。 user-invocable: false

allowed-tools: Read Write Skill Glob Grep Bash(git branch *) Bash(git checkout *) Bash(git rev-parse *) Bash(git status *) Bash(git symbolic-ref *) Bash(git tag *)

所有输出必须使用中文。

module-start

职责说明

本 skill 单一职责：推进后端模块循环。coding-start 已在派发前确认存在未完成后端模块；本 skill 不再做"后端是否全完"的判定，也不感知前端阶段。

执行步骤

步骤 1：定位当前模块与本模块 REQ 列表

按 docs/02 § 二 开发顺序清单 的 REQ 顺序扫描，找到第一个所属模块尚未打里程碑 tag 的模块作为 current_module，并抽取本模块 REQ 序列。

模块状态判定（里程碑: 字段 + git tag -l 'milestone/<module_id>' 存在性）参见 CLAUDE.md § ✅ 阶段完成判定规则 § 状态语义。

找到 current_module 后，从 docs/02 § 二 的 REQ 列表里取出所有 module_id == current_module 的项，按原序得 req_list[]（A5 约束保证同模块 REQ 连续）。模块名、需求卡目录等其它字段由后续步骤按需从 docs/08 § 二 或 docs/01-需求清单/ 取，不在本步骤预读。

约束：

• 模块完成 = docs/08 § 二 该模块 里程碑: 字段为 milestone/<module_id> 且 git tag -l 能查到该 tag；二者任一缺失即视为未完成
• 任何文件读取或解析失败 → 打印错误并停止 [ERP-HALT]

步骤 2：找不到未完成后端模块的处理

如果步骤 1 没找到任何未完成的后端模块——理论上不应触达此分支（coding-start 步骤 3 已确认存在未完成模块才会派发到本 skill），属于异常调用：

• 打印诊断："module-start 未发现未完成后端模块。请通过 /erp-workflow:coding-start 入口重新驱动——coding-start 会按 docs/08 § 二/§ 三 自动路由到正确阶段（后端 / 前端 / 全部完成）。"
• 结束本 skill，不派发下游

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

确保工作树位于 target_branch = module-<module_id>（例 module-module_sys）。

• 已在该分支 → 继续步骤 4
• 该分支已存在但当前不在 → checkout 过去
• 该分支不存在 → 先把工作树切到本地默认分支（main 或 master，已由 milestone-tag 的本地 merge 累积所有已完成模块），作为新分支的干净 base，再 git checkout -b 创建模块分支

任何错误（定位不到默认分支 / 切换前工作树脏 / checkout 失败）一律停下并打印诊断信息，不自动 stash、不强制覆盖。[ERP-HALT]

步骤 4：计算已完成 REQ 集合 done_reqs[]

对 req_list[] 中每个 REQ，检查 docs/superpowers/reviews/ 下是否存在该 REQ 的 review 文件、且其 verdict 字段为 approve。两条件都满足 → 收入 done_reqs[]，步骤 6 推进时跳过这些 REQ。

每次进入本 skill 都重新计算（不缓存），保证中断/重跑后能从最新进度继续。

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

按 ${CLAUDE_SKILL_DIR}/templates/module-start-banner-template.md 渲染输出。

步骤 6：派发

• 还有未完成 REQ → 同一 turn 内立即调用 Skill(feature-brainstorm) 启动该 REQ 的功能循环（不要先输出"已完成 / 接下来 / 请检查 / 等你确认"之类桥接叙述——会被解读为 turn 结束信号、害用户手敲 continue）
• 本模块 REQ 全部完成 → 同一 turn 内立即调用 Skill(test-gate) 进入模块测试闸门（不要先输出"已完成 / 接下来 / 请检查 / 等你确认"之类桥接叙述——会被解读为 turn 结束信号、害用户手敲 continue）

参考

• docs/02-开发计划.md § 二 开发顺序清单（分发权威）
• docs/08-模块任务管理.md § 二（后端模块元数据，含 里程碑: 字段；完成判定以 tag 存在为准）
• docs/superpowers/reviews/*.md（REQ 级进度事实——verdict=approve 即完成）
• ${CLAUDE_SKILL_DIR}/templates/module-start-banner-template.md
• 下游：
  • feature-brainstorm（每个未完成 REQ）
  • test-gate（本模块全部 REQ approve 后；phase=backend 由分支推断）
• 上游：coding-start（步骤 3 派发到此；后端模块全部打里程碑时不会派发到此）