---
name: cross-module-log
description: 批量补填跨模块改动日志中 hook 留下的 `TBD(CC 补)`（原因 / 影响评估两列）。仅由 module-report § ⑦ 硬验收时调用。
user-invocable: false
allowed-tools: Read Write Edit Bash(git branch *)
---

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

# cross-module-log

软规则 S2 自动留痕：hook `log-cross-module.sh` 在每次对**非当前模块**文件的改动时追加 4 列存根（时间戳 / 目标模块 / 文件 / 改动摘要），「原因」「影响评估」两列写 `TBD(CC 补)`。本 skill 在 `module-report § ⑦` 硬验收阶段一次性推断补齐两列；CC 编辑代码中途不主动调用（节省 LLM 调用次数）。

## 执行步骤

1. 从 `git branch --show-current` 取 `module_id`（去掉 `module-` 前缀；`module-start` 步骤 3 保证此时在 `module-*` 分支）。
2. 打开 `docs/superpowers/module-reports/<module_id>-cross-module.md`。文件不存在 → 输出 `cross-module-log: 无跨模块改动，跳过` 并结束（hook 是日志文件唯一创建者；缺失意味着本模块周期内没有跨模块改动）。
3. 用 `Edit` 逐行替换「原因」或「影响评估」列含 `TBD(CC 补)` 的行：
   - **保持时间戳 / 目标模块 / 文件 / 改动摘要四列不变**
   - **原因**：为什么要改目标模块的代码？当前模块的哪个 REQ 迫使这样做？
   - **影响评估**：目标模块的哪些 API / 行为 / 调用方可能受影响？现有测试是否仍有效？是否需要新测试？（1-3 句话）
   - 推断依据：当前 session 的改动上下文 + REQ 卡片 + 目标模块代码
4. 输出 `cross-module-log: 更新了 N 行`。

## 参考

- `${CLAUDE_SKILL_DIR}/templates/cross-module-log-template.md`（hook 创建日志文件时渲染表头，本 skill 不读）
- `${CLAUDE_SKILL_DIR}/templates/cross-module-log-row-template.md`（行结构参考，hook 拼接用；本 skill 直接 Edit 已有行）
- `CLAUDE.md § 🟡 软规则 S2`
- 上游：`module-report § ⑦`（唯一调用方）
- 下游：`module-report` 把补齐后的日志原文嵌入 § ⑦