---

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 把补齐后的日志原文嵌入 § ⑦