DeepDojo.AI发布 2026-11-15English

用 Claude Code 审查大型 PR

Claude CodeAI 编程

你让 Claude Code 审查一个大型 PR,它报回来五个问题,每条都写得有理有据。按惯例,下一步就是逐条去修。

可让它逐条复核之后,结果是这样的:

  • 两条有 diff 和有效推理支持,可以按依据处理;
  • 一条怀疑存在并发问题,需要专门写测试验证;
  • 一条是漏读了已有的判空逻辑,应当撤回;
  • 一条依赖外部服务的行为,本地还没验证过。

五条“问题”,真正能直接动手修的只有两条。如果照单全收,你会花时间修一个不存在的缺陷,还可能把一个只是“怀疑”的判断当成定论写进 PR 讨论。

AI 的审查结论同样是待核对的材料。处理它的办法是分阶段:先建文件地图、按风险分组,把精力集中在权限、迁移这类深水区;再让它逐条复核自己的发现,标出已验证、待测试和撤回。两个代理的结论打架时,回到代码和测试证据去查原因,最后由有权限的人决定哪些结果进入正式项目。

01 先分清哪些动作要你批准

在本地改完代码交给协作者时,要说明四件事:

改了什么 → 为什么改 → 怎么验证 → 出错后怎么回退

Claude Code 可以帮你整理这些信息,也可以查询 PR、读取 CI 日志。查看状态、整理 diff、草拟提交说明,通常只是获取或整理信息;push 和部署会影响共享状态。是否让它直接执行,要看这个动作改变什么、影响谁、出错后能否恢复:

操作类型示例合适处理
只读与整理git status、查看 diff、查询 PR、草拟提交说明可自动处理,结果仍需核对
可恢复的本地变更创建分支、整理提交、运行格式化先检查工作区和恢复路径
影响远端或团队git push、合并、发布、修改 PR 状态人工确认后执行
破坏性或难恢复git reset --hard、force push、删除分支暂停,确认精确目标,优先在隔离环境中进行

可以把边界直接写进请求:

请查看当前 Git 改动并草拟 commit message,停在草稿,等我确认后再提交和 push。

GitHub CLI gh 适合查询仓库状态和创建 PR。创建 draft PR 也会写入远端,需要相应的授权;它能提前把变更信息集中起来,但会不会触发 CI,取决于仓库的工作流是否允许草稿 PR 运行检查:

请创建一个 draft PR。描述中写清变更、测试、风险和待人工确认事项,不要标记 ready for review。

一份合格的 draft PR 描述,至少说明变更目的、主要文件或行为、已运行的测试、已知风险和人工审查状态。协作者据此理解改动,再对照 CI 结果继续审查。

02 大型 PR 先画地图,再按风险分组

审查大型 PR 时,先看它要解决什么问题、涉及哪些文件,再决定哪里需要深入。权限逻辑和数据迁移要追踪行为与失败路径,纯文字调整通常可以较快核对。先分好组,后面就知道哪些地方要仔细读:

PR 元数据与文件列表
  → 变更目的和总体风险
  → 按风险给文件分组
  → 深入关键文件与数据流
  → 运行必要验证
  → 复核结论与不确定点

先获取 PR 信息,gh pr view 的 --json 参数可以只取需要的字段:

gh pr view 123 --json title,body,files

大型 PR 的第一条指令可以是:

先只阅读 PR 描述和文件列表,建立文件地图并按风险分组,不做详细审查。

审查大型变更时,别把精力耗在几十个无关紧要的变量命名上,真正要命的漏洞几乎都藏在深水区。逐组检查时,让它先看风险最高的部分:

优先审查权限、安全、数据迁移、错误处理和缺失测试。
每个问题写出文件位置、原因、实际影响和验证依据。
纯风格建议单独标为低优先级。

本地改动可以先用 /diff 查看,再用 /code-review 检查行为错误和不必要的复杂设计。/review 是它的别名,可以传入 PR 编号,例如 /review 123;按 Claude Code 命令参考,加 --fix 会直接改代码、加 --comment 会往 PR 上发评论,只想审核时这两个参数都不加。也可以通过 gh 分阶段读取。

03 让它逐条复核自己的发现

初查结束后,再要求一轮复核:

逐条复核刚才的问题,区分已经验证的结论、需要运行测试的判断和仍不确定的部分。

开头那五条发现,就是这样分出了去向:两条有依据,按依据修;一条并发怀疑,安排针对性测试;一条漏读了判空逻辑,撤回;一条依赖外部服务,留作补查。修复、测试和补查可以分别安排,撤回的那条也有了记录,后面不会再被翻出来重新争论。

审查之后如果又改了关键逻辑,旧的测试结果只能说明旧版本曾经通过,证明不了新版本可以合并。核对当前的 commit 和运行记录,按新增改动及其影响补上相关检查。

04 两个代理意见相反时

审查也可以交给多个代理分工。本机的 Claude Code 可以作为调度者,在隔离容器的 tmux 会话里再运行一个 Claude Code:

本机 Claude Code
  → 启动 tmux
  → 进入隔离容器
  → 容器内启动 Claude Code
  → 向容器会话发送任务
  → capture-pane 取回结果
  → 主会话与用户审查

容器内可以在可控的边界下使用跳过权限的模式,让实验性任务反复尝试,主系统只接收检查过的结果。这种安排适合长时间研究、失败概率高的脚本、系统提示词实验和独立的代码审查。Claude Code 也可以调度 Codex 等其他 AI 命令行工具,比如一个 worker 检查候选实现,另一个独立审查测试覆盖,主会话再比较两边的证据。

分配之前,先把任务分成两类:

  • 可隔离执行:只读分析、独立原型、测试生成、候选方案比较;
  • 留在主会话:修改共享状态、整合冲突、处理密钥、批准远端动作、作出最终判断。

每个 worker 要有独立的输入范围、输出要求和停止条件。做独立检查时,两边用同一个目标版本和同一套标准,各自拿到必要的代码和验收条件,再比较两份结论的依据。提问时别先给结论:先说一句“这里肯定有竞态”,对方很可能只去找支持这句话的材料。

来看一个并发重构里常见的冲突:负责静态审查的 worker A 断定“这里存在竞态窗口”,负责压测的 worker B 跑了 500 次并发请求,反驳说“没有复现任何不一致”。

很多人会直接相信跑了测试的 B。但竞态条件这类偶发问题,在本地空闲环境里跑上一万次也可能碰不上,部署到多核、高负载的生产环境才会暴露。这 500 次轻量测试只说明它们没有触发问题,竞态风险仍要结合代码和其他证据判断。

这时主控要回到代码核对关键细节:关键状态变更前后有没有锁保护,事务的隔离级别是哪一层。必要时专门写一个在赋值前强制注入 sleep(50ms) 延迟的测试,主动把窗口放大。判断技术冲突时,同时核对代码逻辑、实际的锁边界和测试证据,再由有权限的人决定哪些结果进入正式项目。

05 交付前核对四条证据链

小黑推着变更、验证证据和回退路径一起走向可交付终点

合并或发布前,从四条证据链检查:

  1. 审批:远端、破坏性和发布动作,是否由有权限的人确认?
  2. 隔离:并行任务是否有独立的会话、分支和文件范围?
  3. 验证:测试、PR 审查和 CI 的结论,是否有可以复查的证据?
  4. 回退:失败后,能否恢复本地、远端和部署状态?

发现哪一项缺失,就先补齐,再合并或发布。

一次交付检查可能发现:push 已获授权,两个 worktree 的修改也没有重叠,但报告引用的 CI 结果来自三天前的旧 commit,而且没有写恢复办法。这时要先验证最新的 commit,再补上与改动相符的恢复步骤:纯代码可以考虑 revert 后重新部署,数据库或外部状态的变化要另行恢复。批准、隔离、验证和回退,都要有当前的依据。

CI 的结论怎么读、失败时怎么找根因,用 Claude Code 排查 CI 失败的根因按四层讲了一遍。不同类型的输出各要什么证据,可以对照AI 生成代码的四个检查等级最后那张表。

那五条发现,只有标清已验证、待测试还是已撤回,再分别安排修复、测试和补查,审查才真正帮上了忙。