---
name: erp-mr-create
description: 模块报告完成后，验证当前分支为 module-<id> + worktree 干净，push 推代码和所有 evidence，创建 GitLab MR（报告嵌入描述），把 MR URL 追加到模块报告 § ⑫ 并 commit，把 MR iid 回写到 docs/08 该模块 `MR:` 字段并 commit，再次 push 同步。完成信号由 MR merged state 判定（docs/08 无 checkbox）。停下等待人工审核。
user-invocable: false
allowed-tools: Read Write Edit Skill Bash(git *) Bash(glab *) Bash(sed *) Bash(awk *) Bash(cat *) Bash(echo *) Bash(mkdir -p .tmp) Bash(mv .tmp/*) Bash(rm -f .tmp/*)
---

**所有输出必须使用中文。**

# erp-mr-create

## 前置条件

- `erp-module-report` 已生成报告文件并 commit 到 module 分支。
- `erp-local-test-gate` 返回了绿色，test-gate.md 已 commit 到 module 分支。
- 当前分支 = `module-<module_id>`（由 `erp-module-start` 步骤 3 负责切入）。

## 执行步骤

### 步骤 0：红旗检查

调用 `Skill(erp-red-flag-check)` → 命中则停止。

### 步骤 1：验证当前分支

- `Bash`: `git branch --show-current` → `current_branch`。
- `current_branch` 必须匹配 `module-*`；否则打印错误并**停止**（不自动建分支——分支职责在 `erp-module-start` 步骤 3）。
- 从 `current_branch` 取 `module_id = current_branch` 去掉 `"module-"` 前缀。

### 步骤 2：验证 worktree 干净（防止 evidence 文件漏 commit）

- `Bash`: `git status --porcelain`
- 输出非空 → 打印 dirty 文件清单并**停止**：
  ```
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   [erp-mr-create] ⚠️ worktree 不干净，无法 push

   以下文件有未提交改动：
   <git status 输出>

   push 前所有 evidence 必须已 commit 到 module 分支。检查点：
   - erp-local-test-gate 步骤 3b 是否已 commit test-gate.md？
   - erp-module-report 步骤 5b 是否已 commit 模块报告 + cross-module log？
   - 本 skill 前没人跑过额外的 Edit/Write？

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

### 步骤 3：push 推送全部已 commit 内容

`git push -u origin <current_branch>` — **不要**使用 `--no-verify`（hook `deny-no-verify.sh` 会拦截）。

此 push 包含：代码 commit（erp-feature-tdd 产出）+ 模块 review fix commit（erp-feature-review 产出）+ test-gate evidence commit（erp-local-test-gate 产出）+ 模块完成报告 commit（erp-module-report 产出）。

### 步骤 4：读取 MR 标题模板

用 `Read` 读取 `${CLAUDE_SKILL_DIR}/templates/mr-title-template.md`，填充 `module_id`、`module_name`，得到 MR 标题字符串（一行，较短，进上下文 OK）。

### 步骤 5：生成 MR 描述文件（纯 shell，不读模块报告内容进上下文）

```bash
mkdir -p .tmp
DESC_FILE=.tmp/mr-desc.md
REPORT="docs/superpowers/module-reports/<date>-<module_id>.md"

# 先用 sed 替换 description 模板的简单槽位
sed -e "s|{{test_gate_conclusion}}|<值>|g" \
    -e "s|{{test_subagent_id}}|<值>|g" \
    -e "s|{{module_id}}|<值>|g" \
    -e "s|{{date}}|<值>|g" \
    "${CLAUDE_SKILL_DIR}/templates/mr-description-template.md" > "$DESC_FILE"

# 把模块报告完整内容直接管道注入，替换 {{module_report_contents}} 所在行
awk -v report="$REPORT" '
  /\{\{module_report_contents\}\}/ { while ((getline line < report) > 0) print line; close(report); next }
  { print }
' "$DESC_FILE" > .tmp/mr-desc.final
mv .tmp/mr-desc.final "$DESC_FILE"
```

关键：**模块报告内容只经 awk 管道流过**，从不进入 LLM 上下文。

### 步骤 6：创建 MR

```bash
TITLE_FILE=.tmp/mr-title.txt
echo "<步骤 4 得到的标题>" > "$TITLE_FILE"
glab mr create --title "$(cat "$TITLE_FILE")" --description "$(cat "$DESC_FILE")"
rm -f .tmp/mr-title.txt .tmp/mr-desc.md
```

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

- 解析返回的 MR URL 和 IID（`<iid>`）。
- `Edit docs/superpowers/module-reports/<date>-<module_id>.md` 的 § ⑫：把 `{{mr_url}}` 占位替换为实际 URL（若已替换过，追加一行）。
- `Bash`: `git add docs/superpowers/module-reports/<date>-<module_id>.md && git commit -m "docs(<module_id>): record MR !<iid> link in module report"`。

### 步骤 8：回写 docs/08 的 MR 字段并 commit

- `Edit docs/08-模块任务管理.md`：把当前模块条目的 `  - MR: —` 改为 `  - MR: !<iid>`（只改一行）。docs/08 § 二每模块是 bullet（`- module_id ...`，无 checkbox），`MR:` 字段是唯一动态字段。
- `Bash`: `git add docs/08-模块任务管理.md && git commit -m "chore(<module_id>): record MR !<iid> in docs/08"`。

### 步骤 9：再次 push

步骤 3 的 push 之后，步骤 7 和 8 又产生了两个新 commit（MR link + docs/08 MR iid）。必须再次 push 让 MR 自动更新 commit 列表 + diff：

`Bash`: `git push origin <current_branch>`

### 步骤 10：向会话打印 MR URL

### 步骤 11：停止 — 等待人工 Approve + Merge

用户合并后再跑 `/erp-workflow:erp-coding-start`，入口会自动检测 MR merged → `git checkout main` + `git pull --ff-only` 同步远程 + 派发下一模块。

## 设计要点

- **main 是 protected branch**，只能通过 MR 修改。MR diff 包含：代码 + 模块报告 + test-gate evidence + cross-module log + docs/08 的 `MR: !<iid>` 字段。
- **完成信号由 MR state 判定**——docs/08 § 二每模块是 bullet（无 checkbox），没有可翻勾的地方。从结构上消除"用户抢跑 coding-start 跳过未合并模块"的 ordering bug。仅 `MR:` 字段在 `—` / `!<iid>` 之间变化。
- **worktree 干净前置**（步骤 2）：保证 test-gate.md、module-report.md、cross-module log.md 都已进 repo，审计证据完整；防止下次 coding-start `git checkout main` 遇到 dirty state。

## 参考

- `${CLAUDE_SKILL_DIR}/templates/mr-title-template.md`
- `${CLAUDE_SKILL_DIR}/templates/mr-description-template.md`
- 上游：`erp-module-report`
- 守门：`erp-red-flag-check`
- 下游闸门：用户手工 MR Approve + Merge