第 5 章 · 问题 3:页面能打开,不等于每次修改都可靠
Codex 一次改了很多文件和内容。不会写代码的人,怎样知道它到底改了什么、有没有改错、下次还会不会忘记规则?
你不需要逐行读懂代码。先学三件够用的事:看改动前后、只盯高风险变化、把长期规矩写进 AGENTS.md。
01“Diff”就是修改前后对照,不是考试题
绿色“+”是新内容,红色“−”是被替换或删除的内容。先判断事实有没有被改强。
新版客户端支持在 diff 里直接编辑、添加行内批注,并让 Codex 修改你选中的内容。小白最实用的用法不是读懂所有标签,而是点住有问题的那一句,直接写“这条仍未确认,恢复为风险表述”。
把这个能力真正用起来:diff 不只是给你看的,还是能直接下手改的文稿。一两个字的问题——措辞不对、一处该标“待确认”没标——你在 diff 里点住那行改掉就完事,不用来回喊话“把第三块里那句话的 XX 改成 YY”。成片的问题才发回去让它重做。分工记成一句话:小错你顺手改,大错说清楚让它改。改它的产出,比描述“怎么改”快得多。
侧栏里的 Pull Request review 和“多仓库项目”是什么?我用不上吧?
办公场景确实用不上,别慌,但值得知道名字。Pull Request(拉取请求)是程序员团队的协作单:谁想改动共享的代码,先提交一份“我改了这些,请大家审”的请求,队友在上面逐行批注,通过了才正式合入。新版 Codex 把这套审查搬进了侧栏,不用切到别的网站;多仓库项目则是让一个项目同时装下几个代码仓库,跨仓库干活。这两样都是给开发者的。
那为什么还要认识它们?因为你这一课练的事——看改动对照、按规矩审查、留下记录——和程序员做代码审查是同一件事的不同难度档。哪天你和开发同事协作,对方说“你来 review 一下”,你不但听得懂,手上还真有这个习惯。
02每次审查优先看四类高风险变化
预约数、转化率、发布日期、会议时间。
最终价格、渠道同步、漏水和保温结论。
修改应该集中在 02_Codex成品 和规则文件。
本课要求单文件离线打开,不应依赖 CDN、外部字体或图片。
除了你这双眼睛,还有一道机器闸:auto-review 会在涉及连接工具和接口的重要动作执行前,用最强的一批模型先审一遍,标出风险再执行,这道闸在 Codex 侧同样生效。但要分清两道闸各管什么:auto-review 审的是“这个动作危不危险”,上面四类审的是“这处内容对不对”——数字被改值、未知被写成确定,机器闸不拦,只能靠你。两道闸叠着用,别拿任何一道当全部。
03把每次都要重复说的话,写进 AGENTS.md
# 工作范围 - 00_素材只读,禁止改名、移动、覆盖、删除 - Work成品只放01_Work成品 - Codex工具只放02_Codex成品 # 事实规则 - 未确认的价格、渠道和检测条件必须标“待确认” - 所有关键数字能回到来源文件 # 网页规则 - 双击index.html直接打开,不依赖外部资源 - 390px宽度不得横向溢出 # 每次交工 - 列出改动文件 - 说明运行过的检查和结果 - 写出仍未确认的事项
这份规矩要一条条手打吗?有没有更省事的起步方式?
不用从空白开始。新版客户端有个 /init 命令:在项目里输入它,Codex 会先自己看一遍文件夹结构,替你起草一份 AGENTS.md 初稿——它猜哪些是成品区、哪些像是不能动的原始材料、这个项目大概在做什么。
但初稿只是初稿,别直接用。它猜不到“179 和 199 是待确认价格不能写死”这种只有你知道的业务规矩。正确用法是:让 /init 打个草稿,你再照上面那份范例把禁区、事实规则、交工要求一条条改准。让机器干“搭架子”的力气活,把“定规矩”这件只有你能拍板的事留给自己。
请根据“Work到Codex交接单.md”“交付标准.md”和刚完成的看板,在项目根目录创建 AGENTS.md。
只写长期稳定的项目规矩:文件夹职责、00_素材只读、待确认事实的写法、单文件网页要求、移动端要求、每次交工必须报告什么。不要把“这一次把风险卡移到首屏”这类临时要求写进去。
创建后请读取 AGENTS.md,复述其中最重要的 5 条,并检查当前看板是否违反任何一条。
04让 Codex 自检,但要留下能复查的记录
请对当前项目做一次交工检查,并在根目录创建“改动审查记录.md”。
记录必须包含:本次查看或修改的文件;没有修改的原始素材文件数量;index.html 是否存在;是否引用外部网络资源;浏览器控制台是否报错;390px 是否横向溢出;价格、渠道和检测条件是否仍标待确认;README 是否完整;仍需人工检查的事项。
如果发现问题先修复,再把修复前的问题、修复动作和最终结果写进记录。不要只写“检查通过”。
0 / 4 · 审查还没结束
用 /init 让它起草,再照“禁区 / 命名 / 自检”三类各写两条:哪些文件绝对不能碰、文件和文件夹按什么规矩命名、每次交工前必须自查什么。提示:写完让它复述最重要的 5 条,看它有没有理解偏。
让 Codex 改一处内容时,故意在任务里埋一个“把待确认价格写成最终价格”的坑,然后走一遍 diff 审查。提示:这是练你的眼睛——机器闸 auto-review 不会拦这种“内容错”,只有你的四类高风险审查会。
禁区(哪里不能碰)、命名(文件怎么起名)、自检(交工前查什么)——一份好的 AGENTS.md 就这三类。下次开新项目,照这三格填,就是给 AI 配了一本员工手册。
下一课把刚才的好结果拆成一张五格任务卡,让下一次不必靠记忆重来。
下一课:做一张可复用的五格任务卡 →最后验收
不要只确认“AI 说做完了”,请打开真实结果检查。
AGENTS.md + 改动审查记录.md + 一次检查结果回到当前 Work 或 Codex 任务,请它打开成品;也可以在访达 / 资源管理器里按下面的路径找到并双击。查看参考样例 ↗