模块 3 · 检查 Codex 的交付

如何审查改动
和交付报告

不要只看 Codex 最后一条“已完成”。回到原任务,查看改了哪些文件、页面是否能用,还有什么没有检查。

预计阅读 27 分钟视频建议 24—30 分钟登录后免费核验于 2026.08.18

大家好,我是云途。

Codex 完成任务后,通常会发来一段总结。先不要只看这段总结,要回到你最初提出的要求,再查看真实改动和检查结果。

即使你还看不懂每一行代码,也可以先检查它改了哪些文件、用户操作有没有变化、页面能不能正常使用。

这节课会带你按固定顺序检查一次交付,并给出一份可以直接复用的完成说明格式。

这节课要完成什么

  1. 先用任务书判断有没有跑偏;
  2. 查看文件清单与差异规模;
  3. 区分必要改动和顺手重构;
  4. 逐项匹配验收证据;
  5. 判断遗留风险是否影响交付。

按五层顺序审查

交付审查顺序FLOW
1. 目标:完成的是不是原任务
2. 范围:改了哪些文件与系统
3. 差异:具体增加、删除、移动了什么
4. 证据:每条验收如何被证明
5. 风险:还缺什么、怎样恢复

先看文件清单,判断范围是否异常

预期文件

任务直接涉及的页面、共享组件、数据、样式、测试和记录。

间接文件

因共享抽象或类型连接必须修改,应说明原因。

异常文件

锁文件、构建产物、无关页面、生产配置和大量格式化变化。

一个目录折叠任务如果同时改了付款页、数据库配置和数百个无关格式,先不要被“顺手优化”说服。要求解释并移除无关差异。

看差异时问四个问题

  1. 新增内容是否直接服务目标;
  2. 删除内容是否得到授权且有替代;
  3. 旧行为是否被意外改变;
  4. 有没有硬编码、重复实现或绕过共享规则。

看不懂某种编程语言时,可以让 Codex 按用户操作解释每一处变化,再抽查它提到的真实文件。只说“优化了结构”还不够,要继续问清具体改了什么。

可复制提示词

请按文件解释本轮差异。每个文件说明:为什么必须改、用户行为发生了什么变化、删掉了什么、如何验证、是否存在更小方案。把纯格式化、生成文件和与目标无关的差异单独列出,不要把它们混在功能说明里。

每条完成要求,都要找到检查结果

完成要求检查表REPORT
要求:模块可以单独收起和展开
做法:使用 CodexCourseNavigation 管理状态
检查:用鼠标和键盘操作,查看 aria-expanded 是否变化
结果:通过

要求:390px 宽度下页面不会横向滚动
做法:加入移动端目录样式
检查:比较 scrollWidth 和 clientWidth,并查看真实页面
结果:通过

还没检查:旧版 Safari

某条要求没有对应检查结果,就写“还没有验证”。测试文件没有检查这项行为时,也不能把它写成通过。

完成说明应该写哪些内容

  1. 现在的结果:用户已经可以做什么;
  2. 修改的文件:每个文件为什么要改;
  3. 重要选择:为什么采用现在的做法;
  4. 检查结果:运行了什么命令,操作了哪些页面;
  5. 还没检查的内容:哪些设备、账号或场景尚未覆盖;
  6. 撤回方法:如果结果不合适,怎样恢复;
  7. 文档更新:README、设计规范或工作区状态是否同步。

看到这些表达要继续追问

应该没问题

没有运行对应检查,属于猜测。

已全面优化

范围模糊,要求列出具体差异与必要性。

所有测试通过

要求命令、数量、退出状态、跳过项和真实操作。

仅做小改

与文件数量、行数和用户行为对照。

可以上线

确认快照、生产边界、发布候选和上线后验收是否真实完成。

什么时候接收,什么时候要求继续修改

  1. 可以接收:完成了原任务,重要要求都已经检查,剩余风险可以接受;
  2. 继续修改:主要结果正确,但还有局部问题、无关改动或检查缺口;
  3. 不接收:改错版本、超出权限、可能损坏数据、主要流程失败或无法恢复。

实验页面可以保留少量已经写清楚的待确认项。准备上线的功能必须先解决核心流程和数据安全问题。

视频录制与复习提纲

  1. 从任务书开始审查一份交付;
  2. 用文件清单发现范围漂移;
  3. 逐文件解释差异;
  4. 把证据挂回验收条件;
  5. 识别五种模糊交付表达;
  6. 做出通过、修改或拒绝判断。
完成检查

审查的是事实与证据,不是报告的语气

  • 结果与原始目标一致;
  • 所有修改文件都能解释必要性;
  • 没有未授权删除或无关重构;
  • 每条必须验收都有对应证据;
  • 失败、警告和未覆盖项已公开;
  • 恢复方式和工作区记录已经说明。

官方依据与延伸阅读

Codex 使用案例:审查与质量