AI Agent / 系统课时

审查并收敛改动

审查并收敛改动

功能写完并不等于任务完成。Claude Code 可能遗漏验收条件,也可能为了完善实现而扩大修改范围。本节建立一套收敛流程:先用差异确认事实,再按验收标准分类问题,用补充指令做最小修正,直到改动范围和测试结果同时稳定。

学习目标

  • 用 Claude Code 的差异视图和 Git 命令确认实际改动范围
  • 按遗漏、错误和过度修改三类问题审查验收标准
  • 编写窄范围补充指令,并通过复验判断是否真正收敛

先看差异再评价结果

在 Claude Code 中可以用 /diff 打开未提交改动和逐轮差异的交互视图。审查时先确认“哪些文件被动过”,再判断“改动是否正确”,不要先问 Claude Code 自己是否完成。沿用 --dry-run 示例,可以先在终端做一个快速范围检查:

bash
printf 'FILES\n'
git diff --name-only
printf '\nWHITESPACE\n'
git diff --check && echo OK

预期输出

text
FILES
src/cli.ts
src/runner.ts
test/cli.test.ts

WHITESPACE
OK

如果验收范围只允许这三个文件,而输出多出 src/logger.ts、配置文件或 README,就应该先把它标记为越界改动,再决定是否保留。git diff --check 只能检查空白等补丁问题,不能证明业务逻辑正确。

按验收标准给问题分类

审查差异时,把每个发现归入三类会比一句“再检查一下”更有效:遗漏表示验收条件没有实现,错误表示已经修改但行为不符合预期,过度修改表示功能可能正确,却触碰了无关代码或引入不必要重构。三类问题的修正策略不同,不能用同一条模糊指令处理。

Claude Code 改动审查与收敛闭环

审查清单不必很长,但必须可判定。例如 --dry-run 的验收标准可以是:参数能被解析;开启后不执行真实写入;关闭时保持原行为;对应测试通过;不修改日志格式和无关模块。只要其中任何一项无法从差异或测试中得到证据,就还没有完成验收。

用补充指令做最小修正

发现问题后,不要重新描述整个需求。补充指令只指出证据、修正目标和禁止范围,让 Claude Code 在现有实现上收敛,而不是再次自由发挥。下面的指令同时处理一个遗漏和一个越界改动:

text
基于当前差异只修正两个问题:
1. test/cli.test.ts 缺少“未传 --dry-run 时仍执行真实写入”的回归测试,请补上。
2. src/logger.ts 与本功能无关,请撤销本轮由你引入的改动;如果该文件在本轮开始前已有用户改动,不要覆盖,先报告差异。
除上述内容外不要重构或改名。完成后运行 test/cli.test.ts,并报告是否还有超出 src/cli.ts、src/runner.ts、test/cli.test.ts 的改动。

预期结果:Claude Code 只补回归测试并处理确认属于本轮的越界修改;如果检测到 src/logger.ts 存在先前用户改动,应先报告而不是直接覆盖。

复验直到差异稳定

每轮补充修改后都重新跑同一组验收命令。重复使用同一套检查比不断新增检查项更容易判断是否收敛。以下仍以 Jest 示例为准:

bash
git diff --check
npx jest test/cli.test.ts --runInBand
git diff --name-only

预期输出

text
PASS test/cli.test.ts
Tests:       4 passed, 4 total
src/cli.ts
src/runner.ts
test/cli.test.ts

这里 git diff --check 成功时本身没有输出,因此第一行可见内容来自测试。测试通过且文件集合回到允许范围后,再在 /diff 中做最后一次逐块审查;如果同一补丁在连续复验中不再新增无关文件、验收条件都有证据,就可以认为改动已经收敛。

需要整体回退时再用检查点

如果某一轮方向完全错误,Claude Code 的 /rewind 可以回到较早的会话或代码检查点;但它适合“整轮不要了”,不适合精确保留其中一半修改。局部问题优先使用窄范围补充指令,整体方向错误再考虑回退。

收敛的终点不是“Claude Code 说完成”,而是三个事实同时成立:差异只覆盖约定范围、验收条件逐条有证据、定向测试稳定通过。只要其中一项不成立,就继续修正当前差异,而不是扩大需求或重新生成整个实现。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

审查并收敛改动

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通