---

name: mr-create description: 模块报告完成后，把 module 分支推到远程并创建 GitLab MR，把 MR iid 回写 docs/08 + URL 回写报告 § ⑫，停下等人工 Approve + Merge。 user-invocable: false

allowed-tools: Read Edit Bash(git *) Bash(bash *)

所有输出必须使用中文。

mr-create

前置条件

• module-report 已生成报告并 commit 到 module 分支
• test-gate 绿色，test-gate.md 已 commit 到 module 分支
• 当前分支 = module-<module_id>（由 module-start 步骤 3 切入）

执行步骤

步骤 1：验证当前分支

git branch --show-current 必须匹配 module-*，否则停下报错（不自动建分支——分支职责在 module-start 步骤 3）。从分支名取 module_id = 去掉 module- 前缀。

步骤 2：验证 worktree 干净

git status --porcelain 输出非空 → 停下打印 dirty 文件清单：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 [mr-create] ⚠️ worktree 不干净，无法 push

 <git status 输出>

 push 前所有 evidence 必须已 commit。检查点：
 - test-gate 步骤 3 是否已 commit test-gate.md？
 - module-report 步骤 5 是否已 commit 报告 + cross-module log？

 修复：git add <files> && git commit -m "..."，然后重跑 /erp-workflow:coding-start。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

步骤 3：初次 push

git push -u origin <current_branch>——禁用 --no-verify。

步骤 4：调脚本创建（或复用）MR

bash "${CLAUDE_SKILL_DIR}/scripts/create-mr.sh" <module_id> <current_branch> <YYYY-MM-DD>

脚本内部完成：加载 .env.local → 探测目标分支 → 从 docs/08 取 module_name 与 test-gate.md 取结论 → 渲染 description → 查已有 opened MR → 否则创建新 MR。

输出（stdout）：单行 <MR_IID> <MR_URL>，由本步骤捕获供后续步骤使用。失败时脚本写诊断到 stderr 并 exit 1，本 skill 停下。

步骤 5：回写 docs/08 MR 字段并 commit

先于步骤 6 执行——若步骤 6 失败，重跑时步骤 4 脚本能识别已有 MR + docs/08 已含 IID，状态一致。

Edit docs/08-模块任务管理.md：把当前模块的 - MR: — 改为 - MR: !<MR_IID>。

git add docs/08-模块任务管理.md
git commit -m "chore(<module_id>): record MR !<MR_IID> in docs/08"

步骤 6：追加 MR URL 到模块报告 § ⑫ 并 commit

Edit docs/superpowers/module-reports/<date>-<module_id>.md 的 § ⑫，把 {{mr_url}} 替换为 <MR_URL>（已替换则追加一行）。

git add docs/superpowers/module-reports/<date>-<module_id>.md
git commit -m "docs(<module_id>): record MR !<MR_IID> link in module report"

步骤 7：再次 push 同步新 commits

步骤 5、6 产生了两个新 commit，必须再 push 让 MR 自动更新 commit 列表 + diff：

git push origin <current_branch>

步骤 8：打印 MR URL，停下等 Approve + Merge

向会话打印 <MR_URL>，结束本 skill。用户在 GitLab merge 后再运行 /erp-workflow:coding-start，入口扫描到 state=merged 后自动推进下一模块。

参考

• ${CLAUDE_SKILL_DIR}/scripts/create-mr.sh（步骤 4 主流程脚本）
• ${CLAUDE_SKILL_DIR}/templates/mr-title-template.md
• ${CLAUDE_SKILL_DIR}/templates/mr-description-template.md
• 上游：module-report
• 下游闸门：用户手工 MR Approve + Merge