大家好,我是云途。
Codex 完成任务后,通常会发来一段总结。先不要只看这段总结,要回到你最初提出的要求,再查看真实改动和检查结果。
即使你还看不懂每一行代码,也可以先检查它改了哪些文件、用户操作有没有变化、页面能不能正常使用。
这节课会带你按固定顺序检查一次交付,并给出一份可以直接复用的完成说明格式。
这节课要完成什么
- 先用任务书判断有没有跑偏;
- 查看文件清单与差异规模;
- 区分必要改动和顺手重构;
- 逐项匹配验收证据;
- 判断遗留风险是否影响交付。
按五层顺序审查
1. 目标:完成的是不是原任务
2. 范围:改了哪些文件与系统
3. 差异:具体增加、删除、移动了什么
4. 证据:每条验收如何被证明
5. 风险:还缺什么、怎样恢复先看文件清单,判断范围是否异常
预期文件
任务直接涉及的页面、共享组件、数据、样式、测试和记录。
间接文件
因共享抽象或类型连接必须修改,应说明原因。
异常文件
锁文件、构建产物、无关页面、生产配置和大量格式化变化。
一个目录折叠任务如果同时改了付款页、数据库配置和数百个无关格式,先不要被“顺手优化”说服。要求解释并移除无关差异。
看差异时问四个问题
- 新增内容是否直接服务目标;
- 删除内容是否得到授权且有替代;
- 旧行为是否被意外改变;
- 有没有硬编码、重复实现或绕过共享规则。
看不懂某种编程语言时,可以让 Codex 按用户操作解释每一处变化,再抽查它提到的真实文件。只说“优化了结构”还不够,要继续问清具体改了什么。
可复制提示词
请按文件解释本轮差异。每个文件说明:为什么必须改、用户行为发生了什么变化、删掉了什么、如何验证、是否存在更小方案。把纯格式化、生成文件和与目标无关的差异单独列出,不要把它们混在功能说明里。
每条完成要求,都要找到检查结果
要求:模块可以单独收起和展开
做法:使用 CodexCourseNavigation 管理状态
检查:用鼠标和键盘操作,查看 aria-expanded 是否变化
结果:通过
要求:390px 宽度下页面不会横向滚动
做法:加入移动端目录样式
检查:比较 scrollWidth 和 clientWidth,并查看真实页面
结果:通过
还没检查:旧版 Safari某条要求没有对应检查结果,就写“还没有验证”。测试文件没有检查这项行为时,也不能把它写成通过。
完成说明应该写哪些内容
- 现在的结果:用户已经可以做什么;
- 修改的文件:每个文件为什么要改;
- 重要选择:为什么采用现在的做法;
- 检查结果:运行了什么命令,操作了哪些页面;
- 还没检查的内容:哪些设备、账号或场景尚未覆盖;
- 撤回方法:如果结果不合适,怎样恢复;
- 文档更新:README、设计规范或工作区状态是否同步。
看到这些表达要继续追问
应该没问题
没有运行对应检查,属于猜测。
已全面优化
范围模糊,要求列出具体差异与必要性。
所有测试通过
要求命令、数量、退出状态、跳过项和真实操作。
仅做小改
与文件数量、行数和用户行为对照。
可以上线
确认快照、生产边界、发布候选和上线后验收是否真实完成。
什么时候接收,什么时候要求继续修改
- 可以接收:完成了原任务,重要要求都已经检查,剩余风险可以接受;
- 继续修改:主要结果正确,但还有局部问题、无关改动或检查缺口;
- 不接收:改错版本、超出权限、可能损坏数据、主要流程失败或无法恢复。
实验页面可以保留少量已经写清楚的待确认项。准备上线的功能必须先解决核心流程和数据安全问题。
视频录制与复习提纲
- 从任务书开始审查一份交付;
- 用文件清单发现范围漂移;
- 逐文件解释差异;
- 把证据挂回验收条件;
- 识别五种模糊交付表达;
- 做出通过、修改或拒绝判断。
审查的是事实与证据,不是报告的语气
- 结果与原始目标一致;
- 所有修改文件都能解释必要性;
- 没有未授权删除或无关重构;
- 每条必须验收都有对应证据;
- 失败、警告和未覆盖项已公开;
- 恢复方式和工作区记录已经说明。