模块 3 · 检查 Codex 的交付

查看、修改、验证
的小闭环

把大任务拆成几次小修改。每改完一处就马上检查,确认正确以后再继续。

预计阅读 25 分钟视频建议 22—28 分钟登录后免费核验于 2026.08.18

大家好,我是云途。

从这一模块开始,我们学习怎样检查 Codex 做得对不对。先记住一个简单习惯:每改完一小步,就马上检查,不要等整个页面全部改完。

一次小修改,加上一次对应检查,可以叫作一个“小闭环”。这样即使结果出错,你也更容易知道问题出在哪一步。

这节课会用课程目录为例,带你把一项大改动拆开,并说明每一步应该怎样检查。

这节课要完成什么

  1. 记下修改前的页面和测试状态;
  2. 把大任务拆成可以单独检查的小步;
  3. 每一步只完成一个主要变化;
  4. 每改完一步就查看差异并检查结果;
  5. 检查失败时先修好当前步骤再继续。

每改一步,就检查一步

一次小修改的完整过程FLOW
查看:先看清现在是什么样
  ↓
修改:只完成一个明确变化
  ↓
检查:确认结果是否符合要求
  ↓
记录:记下改了什么、结果怎样

这里的“记录”可以很短,例如一条计划更新、一条 Git 提交、几行测试结果,或者一张带说明的截图。它只需要让你和 Codex 知道下一步从哪里继续。

怎样判断一步是不是太大

太大

同时改目录结构、文章内容、页眉、页脚、颜色、路由和移动端,任何失败都难定位。

合适

先建立课程数据;再接共享目录;再接动态文章;最后补响应式与测试。

太小

每改一个空格都停下汇报,验证成本高于风险收益。

一步是否合适,可以看四点:目标清楚、涉及文件有限、结果能够单独检查,失败时也容易找到原因。

开始前,先记住原来的样子

修改前的真实状态叫作“基线”。它就是你之后判断页面有没有被改坏的参照。

  1. 页面基线:现在从哪里进入,点击后会发生什么;
  2. 代码基线:这项功能由哪些文件、组件和数据组成;
  3. 检查基线:原来的测试是否通过,控制台是否已经有错误。

先运行原有检查,才能分清哪些错误原本就有,哪些错误是这次修改带来的。

一次只改变一个主要变量

课程目录的四步实现PLAN
步骤 1:建立 17 节统一课程数据
验证:顺序、模块、slug 唯一

步骤 2:建立树状折叠组件
验证:总目录与模块可独立折叠

步骤 3:接入所有文章
验证:当前章节与前后导航正确

步骤 4:移动端和视觉细化
验证:390px 无溢出,键盘可操作

每一步完成后先验证再继续。这样选中态出错时,优先检查数据与当前路由;手机溢出时,优先检查布局层,而不是重新设计整个目录。

改了什么,就检查什么

数据结构

唯一性检查、顺序断言、渲染所有条目。

组件逻辑

状态测试、键盘操作、ARIA 展开状态。

路由

逐路由返回 200、标题与前后链接正确。

视觉

真实浏览器比较桌面、手机、长标题和展开状态。

内容

与课程计划和官方事实逐项核对。

检查失败,先停在当前这一步

  1. 指出哪一条要求没有通过;
  2. 确认这个问题在修改前是否已经存在;
  3. 只查看当前这一步改过的内容;
  4. 去掉与当前问题无关的改动;
  5. 修好以后,重新检查当前步骤和上一步;
  6. 全部通过后再继续。
当前这一步还没有检查通过,就先不要继续往后改。

让 Codex 按闭环推进

可复制提示词

请把本任务拆成 3—6 个可以独立验证的小步。每一步先写目标、预计修改文件和验证方式;完成后立即运行对应检查并更新结果。任何一步失败时先定位和修复,不继续叠加后续改动。最终再运行全量检查和真实用户路径。

视频录制与复习提纲

  1. 展示一个过大的整页改造任务;
  2. 把它拆成四个小闭环;
  3. 运行修改前基线;
  4. 演示一步失败时停止推进;
  5. 比较差异、自动检查和真实浏览器证据;
  6. 形成最终全量回归。
完成检查

每一步都有起点和证据,长任务才不会失控

  • 我记录了行为、代码和测试基线;
  • 每一步只承担一个主要变化;
  • 每一步都有独立验证方法;
  • 失败时我会停止后续改动;
  • 我能回到最近正确状态;
  • 局部闭环完成后仍会运行全量回归。

官方依据与延伸阅读

Codex 使用案例与工程工作流