AI Agent / 系统课时

审查云端任务结果

审查云端任务结果

Codex 云端任务完成并不等于代码可以直接合并。本课建立一套可重复的审查顺序:先核对任务总结,再确认测试证据,逐文件检查代码差异,最后用后续指令只修正尚未满足的部分,直到结果达到可交付状态。

学习目标

  • 能从任务总结中区分“Codex 声称完成”与“已有证据证明完成”
  • 能结合测试结果和 Git 差异判断修改是否正确、完整且没有越界
  • 能写出范围明确的后续指令,让 Codex 在原任务上下文中继续改进

从总结判断任务是否真正完成

先把原始任务要求当作验收清单,再读 Codex 给出的总结。重点不是看它写了多少,而是确认每个要求是否能对应到具体修改、测试或说明。若总结提到“修复完成”“已覆盖边界条件”,应继续在差异和测试记录中寻找证据。

还要检查它是否暴露了未完成事项,例如依赖无法安装、某项测试没有运行、环境变量缺失或只做了静态检查。没有运行测试与测试通过不是同一件事;环境受限时应把限制记录下来,并在可用环境中补做验证。

把测试结果当作证据

审查测试时至少确认三件事:运行了什么命令、命令是否真正结束成功、覆盖范围是否与本次修改匹配。只跑格式化或单个静态检查,不能替代与行为变化直接相关的单元测试、集成测试或项目既有验证命令。

如果任务分支已经拉到本地,可以先做一个与语言无关的 Git 基线检查。下面以远端默认分支为 main 为例;若仓库使用其他默认分支,请替换 origin/main。

bash
BASE=$(git merge-base origin/main HEAD)
git diff --check $BASE HEAD
git diff --stat $BASE HEAD

预期结果

text
<PATH> | <VALUE> +++++-----
<VALUE> files changed, <VALUE> insertions(+), <VALUE> deletions(-)

git diff --check 在没有空白错误时不会输出内容;随后 git diff --stat 才会打印变更统计。实际文件路径和数字会因任务而异。它不能证明业务逻辑正确,但能帮助你快速发现异常的大范围改动,并确定后续该看哪些文件。

按文件审查代码差异

不要只看“新增多少行、删除多少行”,而要判断每个变更是否服务于原任务。先看核心实现,再看对应测试,最后看配置、依赖锁文件、迁移脚本和生成文件。若一个小修复顺带改了大量无关格式、重命名或依赖版本,评审成本和回归风险都会上升。

特别注意边界行为:错误分支是否被吞掉、默认值是否改变、公开接口是否兼容、并发与重试是否产生副作用。对于删除代码,要确认删除的是冗余路径,而不是把原有保护条件一起删掉;对于新测试,要确认它真的会在修复回退时失败。

用后续指令做最小修正

发现问题后,优先在同一个云端任务中继续追问,这样 Codex 能保留已有仓库与任务上下文。好的 follow-up 应同时说明具体问题、期望行为、允许修改的范围以及需要重新运行的验证,不要只说“再优化一下”。

只修复当前差异中导致 <TEST_NAME> 失败的问题,不要重构无关文件。修复后重新运行同一测试,并在总结中列出修改文件、测试命令和结果。

如果第一次修正仍然扩大了范围,就继续收窄指令,例如明确“不要修改公开 API”“不要升级依赖”“保持数据库结构不变”。后续任务的目标不是让差异越来越多,而是让未满足的验收条件逐项归零。

什么时候可以接受结果

至少应满足:任务总结与原始要求一致,关键测试有明确通过证据,差异中没有无法解释的无关改动,配置或依赖变化已被单独审查,之前指出的问题也已在新差异中关闭。达到这些条件后,再进入创建拉取请求或合并流程,能显著减少把“看起来完成”误当成“已经验证”的风险。

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

目录与阅读设置

阅读设置

17

记录一个想法

审查云端任务结果

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

登录哪都通