大家好,我是云途。
从这一模块开始,我们学习怎样检查 Codex 做得对不对。先记住一个简单习惯:每改完一小步,就马上检查,不要等整个页面全部改完。
一次小修改,加上一次对应检查,可以叫作一个“小闭环”。这样即使结果出错,你也更容易知道问题出在哪一步。
这节课会用课程目录为例,带你把一项大改动拆开,并说明每一步应该怎样检查。
这节课要完成什么
- 记下修改前的页面和测试状态;
- 把大任务拆成可以单独检查的小步;
- 每一步只完成一个主要变化;
- 每改完一步就查看差异并检查结果;
- 检查失败时先修好当前步骤再继续。
每改一步,就检查一步
查看:先看清现在是什么样
↓
修改:只完成一个明确变化
↓
检查:确认结果是否符合要求
↓
记录:记下改了什么、结果怎样这里的“记录”可以很短,例如一条计划更新、一条 Git 提交、几行测试结果,或者一张带说明的截图。它只需要让你和 Codex 知道下一步从哪里继续。
怎样判断一步是不是太大
太大
同时改目录结构、文章内容、页眉、页脚、颜色、路由和移动端,任何失败都难定位。
合适
先建立课程数据;再接共享目录;再接动态文章;最后补响应式与测试。
太小
每改一个空格都停下汇报,验证成本高于风险收益。
一步是否合适,可以看四点:目标清楚、涉及文件有限、结果能够单独检查,失败时也容易找到原因。
开始前,先记住原来的样子
修改前的真实状态叫作“基线”。它就是你之后判断页面有没有被改坏的参照。
- 页面基线:现在从哪里进入,点击后会发生什么;
- 代码基线:这项功能由哪些文件、组件和数据组成;
- 检查基线:原来的测试是否通过,控制台是否已经有错误。
先运行原有检查,才能分清哪些错误原本就有,哪些错误是这次修改带来的。
一次只改变一个主要变量
步骤 1:建立 17 节统一课程数据
验证:顺序、模块、slug 唯一
步骤 2:建立树状折叠组件
验证:总目录与模块可独立折叠
步骤 3:接入所有文章
验证:当前章节与前后导航正确
步骤 4:移动端和视觉细化
验证:390px 无溢出,键盘可操作每一步完成后先验证再继续。这样选中态出错时,优先检查数据与当前路由;手机溢出时,优先检查布局层,而不是重新设计整个目录。
改了什么,就检查什么
数据结构
唯一性检查、顺序断言、渲染所有条目。
组件逻辑
状态测试、键盘操作、ARIA 展开状态。
路由
逐路由返回 200、标题与前后链接正确。
视觉
真实浏览器比较桌面、手机、长标题和展开状态。
内容
与课程计划和官方事实逐项核对。
检查失败,先停在当前这一步
- 指出哪一条要求没有通过;
- 确认这个问题在修改前是否已经存在;
- 只查看当前这一步改过的内容;
- 去掉与当前问题无关的改动;
- 修好以后,重新检查当前步骤和上一步;
- 全部通过后再继续。
当前这一步还没有检查通过,就先不要继续往后改。
让 Codex 按闭环推进
可复制提示词
请把本任务拆成 3—6 个可以独立验证的小步。每一步先写目标、预计修改文件和验证方式;完成后立即运行对应检查并更新结果。任何一步失败时先定位和修复,不继续叠加后续改动。最终再运行全量检查和真实用户路径。
视频录制与复习提纲
- 展示一个过大的整页改造任务;
- 把它拆成四个小闭环;
- 运行修改前基线;
- 演示一步失败时停止推进;
- 比较差异、自动检查和真实浏览器证据;
- 形成最终全量回归。
每一步都有起点和证据,长任务才不会失控
- 我记录了行为、代码和测试基线;
- 每一步只承担一个主要变化;
- 每一步都有独立验证方法;
- 失败时我会停止后续改动;
- 我能回到最近正确状态;
- 局部闭环完成后仍会运行全量回归。