AI Agent / 系统课时
审查并修正改动
审查并修正改动
Codex 完成一次编码任务后,真正需要确认的不是“它说做完了”,而是改动范围、关键差异和验证结果是否共同证明任务已完成。本课把审查变成一条可重复的闭环:先看证据,再补充最小修正指令,最后重新验证。
学习目标
- 能从变更文件、关键差异和验证结果判断一次改动是否可接受
- 能识别遗漏、误改和验证失败,并把问题改写成可执行的补充指令
- 能在修正后重新检查范围,避免“修一个问题又带来一个问题”
先把“完成”拆成可检查证据
审查时不要只读 Codex 的总结。总结适合快速定位,但最终应回到实际改动和验证结果。最少检查四件事:是否只改了允许的文件、实现是否覆盖需求、是否出现无关重构或删除、已有验证是否真正通过。

从变更范围开始审查
先确认“改了什么”,再讨论“改得对不对”。假设本轮任务只应修改购物车实现和对应测试,可以在仓库根目录检查变更文件,并同时排除常见空白错误。
git diff --name-only
git diff --check预期输出
src/cart.ts
tests/cart.test.tsgit diff --check 正常通过时不输出内容并返回退出码 0;实际文件名会随任务不同而变化。如果列表出现配置、锁文件或无关模块,应先判断这些修改是否必要,再继续阅读关键差异,而不是直接接受整批改动。
接着逐段检查 diff:新增逻辑是否位于正确分支,旧行为是否被意外删除,错误处理是否仍然成立,测试是否覆盖本次新增条件。大范围格式化、顺手改名和与需求无关的重构都会增加审查噪声,应单独说明理由。
用补充指令只修当前差异
发现问题后,不必重新描述完整需求。更有效的做法是指出“当前结果与验收条件之间的差异”,同时明确哪些已经正确的改动必须保留。
补充指令示例(非命令):
保留当前购物车折扣逻辑,只修正以下问题:
1. 空购物车仍会进入折扣分支,应直接返回 0。
2. 不要修改 price-format.ts,本任务与展示格式无关。
3. 为“空购物车”补一条回归测试。
完成后重新运行本仓库针对购物车的现有测试,并报告失败项;如果无法运行,请说明原因。这类指令同时包含保留项、修正项、禁止范围和验证要求,能减少模型为了“重新完成任务”而扩大改动面的概率。若问题来自测试失败,还应把失败测试名、错误信息和相关输入一起提供,而不是只说“测试没过”。
重新验证后再决定是否接受
修正完成后,要重新做一遍范围和结果检查,不能默认“第二次一定正确”。验收至少确认:无额外文件被误改;原需求和补充条件都满足;相关测试、类型检查或构建结果符合仓库要求;没有遗留调试输出、临时注释或绕过测试的改动。
如果验证仍失败,下一轮补充指令只围绕新的证据继续收敛。审查的目标不是把 Codex 的输出逐字阅读完,而是建立“差异可解释、验证可复现、问题可继续定位”的证据链;只有这三点同时成立,改动才适合进入后续提交或评审。