如何用 Codex 完成一次可审核的代码修改
教你把一个模糊需求拆成 Codex 能执行的任务,让 AI 改代码、跑测试、整理结果,最后得到一份可人工审核的修改记录。
教你把一个模糊需求拆成 Codex 能执行的任务,让 AI 改代码、跑测试、整理结果,最后得到一份可人工审核的修改记录。
- 难度
- 实战
- 预计耗时
- 35 分钟
- 路径
- 效率
难度实战
预计耗时35 分钟
学习路径效率
你会获得
- 写出 Codex 任务卡
- 控制 AI 修改范围
- 跑测试并记录结果
- 整理提交前说明
教程目标
学完后,你可以让 Codex 帮你完成一次小型代码修改,并且留下清楚的任务说明、改动范围、测试结果和人工验收清单。
最终产出
- 一张 Codex 任务卡
- 一次限定范围的代码修改
- 一段测试/构建结果记录
- 一份提交前说明
准备材料
- 一个本地代码项目
- 一个明确的小需求,例如:改首页文案、修复按钮样式、给后台加一个字段
- 能运行的测试命令或构建命令,例如
npm run build、npm test
第 1 步:把需求写成任务卡
不要直接说“帮我优化一下”。Codex 最适合接收边界清楚的任务。复制下面模板:
任务:修改 [具体页面/功能]
目标:用户最终能看到/完成 [具体结果]
范围:只允许修改 [文件/模块]
不做:不重构无关代码,不改数据库结构,不改部署配置
验收:运行 [命令] 通过,并检查 [页面/接口/截图]
输出:列出改了哪些文件、怎么验证
示例:
任务:把首页底部文案改成“AI资讯技能站”
目标:用户打开首页能看到新的页脚文案
范围:只允许修改 src/App.tsx 和静态页生成器
不做:不改数据库、不改后台登录、不改样式主题
验收:npm run build 通过,线上首页源码不再出现旧文案
输出:说明修改文件和验证结果
第 2 步:让 Codex 先读代码,不急着改
给 Codex 的第一句话可以这样写:
先不要改文件。请先找出这个需求涉及哪些文件,说明你准备怎么改,列出验证命令。
你要检查它的回答是否满足三点:
- 找到的文件和需求相关
- 没有扩大修改范围
- 验证命令能在本机运行
第 3 步:确认修改范围后再执行
确认后再让 Codex 修改:
按刚才的范围修改。修改前先说明会动哪些文件;修改后运行构建或测试,最后给我结果。
如果它想改很多无关文件,立刻停下来,让它缩小范围:
范围太大。只保留完成这个目标必须修改的文件,其他不动。
第 4 步:看结果,不只看它说成功
至少做三类检查:
- 文件检查:确认只改了任务范围内的文件
- 命令检查:构建或测试通过
- 页面检查:打开页面确认真实效果
常用命令:
npm run build
npm test
rg -n "旧文案|新文案" src server
第 5 步:让 Codex 输出提交前说明
复制下面模板:
请按这个格式总结:
1. 改了什么
2. 为什么这样改
3. 修改了哪些文件
4. 运行了什么验证命令
5. 还有什么风险
最终结果示例
改了首页页脚文案和静态页页脚文案。
修改文件:src/App.tsx、server/src/static-pages.ts。
验证:npm run build 通过;线上首页没有旧文案。
风险:如果后台站点设置里手动写了旧文案,需要在后台再保存一次。
验收清单
- 需求是否能一句话说明最终结果
- Codex 是否只改了必要文件
- 是否运行了测试或构建
- 是否打开页面/接口确认真实效果
- 是否留下了可复查的总结
常见错误
- 一开始就让 AI “随便优化”
- 没有限制文件范围
- 只看 AI 总结,不跑命令
- 让 AI 同时做设计、后端、部署和文案,导致范围失控