---
name: module-report
description: 本地测试闸门通过后，生成标准化 12 节模块完成报告并 commit 到 module 分支供 MR 嵌入。
user-invocable: false
allowed-tools: Read Write Glob Grep Skill Bash(git diff *) Bash(git log *) Bash(git add *) Bash(git commit *)
---

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

# module-report

`test-gate` 绿色后渲染 12 节模块完成报告，commit 到 module 分支供 MR 嵌入。**只读摘要，不读 diff 正文进上下文**。

## 执行步骤

1. 验证上游 `test-gate` 已绿；红色则停。
2. 收集输入（核心约束：取 git 摘要而非 diff 正文）：
   - § ③ 文件变更：用 `git diff --stat` / `--name-status` / `git log --oneline` 摘要（区间：module 分支起点 → HEAD）
   - § ② / § ⑨：直接 Read `docs/superpowers/{specs,plans,reviews}/<日期>-<本模块的 REQ>.md`（小文件可全读）
   - § ⑤：Read `docs/superpowers/module-reports/<module_id>-test-gate.md`
   - § ⑥ Migration：`git diff --name-only --diff-filter=A -- 'sql/migrations/V*.sql'` 列新增 migration，每个 Read 第一行作说明
   - § ⑦ 跨模块改动：Read `docs/superpowers/module-reports/<module_id>-cross-module.md`（如存在）
   - § ④ 读写的表：用 grep 定位涉 SQL 的文件后按需读片段，**不全量读 docs/03**
3. 按 `${CLAUDE_SKILL_DIR}/templates/module-report-template.md` 渲染 12 节。
4. **硬验证**：
   - § ⑦：跨模块日志中任何 `TBD(CC 补)` 或敷衍填充 → 调用 `Skill(cross-module-log)` 一次性批量补齐，补完回本步骤重验（**整模块周期内唯一补 TBD 的时机**）
   - § ⑧：必须列举所有偏离规格之处；若无，写"无偏离"
5. 写入 `docs/superpowers/module-reports/<YYYY-MM-DD>-<module_id>.md`，连同跨模块日志（如存在）一起 commit 到 module 分支：
   ```bash
   git add docs/superpowers/module-reports/<YYYY-MM-DD>-<module_id>.md
   [ -f docs/superpowers/module-reports/<module_id>-cross-module.md ] && \
     git add docs/superpowers/module-reports/<module_id>-cross-module.md
   git commit -m "docs(<module_id>): add module completion report + cross-module log"
   ```
   commit 是必需的——`mr-create` 的 worktree-clean 前置条件依赖此步。
6. 调用 `Skill(mr-create)` 推送并创建 MR。

## 参考

- `${CLAUDE_SKILL_DIR}/templates/module-report-template.md`（12 节）
- 上游：`test-gate`（绿色时派发）
- 下游：`mr-create`