Claude Code 代码审查

可复现实践

允许自动修复前先审查受控 Diff

冻结预期 diff，以 read-first 方式本地审查，复现 finding，再独立决定修复。

准备

• 可信仓库和已知 base branch。
• 可以复现改变行为的测试。
• Review scope 内无无关未提交改动。

执行步骤

1. 冻结 scope evidence

   请求 review 前记录 commit 和 working-tree change。

   git status --short
   git diff --stat
   git diff --check

2. Read-first 本地 review

   调用不带 `--fix` 的 `/code-review`；本次审查未执行模型或产生用量。

3. 复现每个 candidate

   打开引用行并运行最小相关测试，拒绝无法通过代码证据成立的 finding。

4. 分开执行修复

   只处理已接受 finding，重跑定向和广域 gate，再对照冻结的 scope。

预期结果

每个接受的 finding 都有位置和可复现失败或强代码路径证据，review 本身不修改工作树。

验证

• 比较 review 前后的 `git status --short`。
• 记录确认 finding 的命令或代码路径。
• 修复后运行仓库测试，不以另一次 model review 替代。

失败处理

清理或回退

• 检查 patch 后只丢弃 review 自动产生的编辑，保留用户无关工作。
• 删除包含私有代码或 identifier 的临时 review note。

边界与不适用场景

• 托管 Code Review 是 research preview，受 plan 和 provider 限制。
• 一次 clean review 只是单一方法证据，不能证明没有 defect。