本篇目标是跑通最小修改闭环:明确任务 -> 限定范围 -> 修改 -> 解释 diff -> 判断接受。
> 前置教程:第一次让 Codex 阅读项目
> 依据来源:OpenAI Codex 官方手册中关于提示词、任务上下文、验证和审查 diff 的说明。
任务选择原则
- 推荐:修改 README、首页文案、按钮文字、静态提示语。
- 避免:修复杂 Bug、新增完整功能、一次改多个文件。
第 1 步:启动并确认状态
进入项目目录启动 Codex:
``bash
codex
`
发送确认请求:
`markdown
在开始修改前,请先只读确认当前项目是否适合做第一次小修改。
请检查:项目路径、Git 是否干净、首页文案位置、建议只改哪 1 个文件。
要求:不要修改、不要构建、不要安装、不要提交。
`
第 2 步:发出明确的修改指令
如果是改 Vite 首页标题:
`markdown
请完成一个小的首次修改任务。
目标:把首页默认标题改成 “Codex Demo”。
范围:
- 先定位文件。
- 是否只改了 1 个文件。
2. 只允许修改 1 个文件。
3. 不要修改样式、不安装依赖、不运行构建、不提交 Git。
4. 修改后自己检查 Git 状态和 diff 并中文解释。
完成后格式汇报:修改文件、修改内容、原因、diff 总结。
`
第 3 步:等待并审查结果
看它的总结,确认:
2. 是否有原文案和新文案对比。
3. 是否偷跑了命令。
第 4 步:解释 Git 状态和 diff
如果它没主动解释,追问:
`markdown
请检查本次修改后的 Git 状态和 diff 并用中文解释。
要求:列出修改文件、原因、总结 diff、判断是否只改了 1 个文件、判断是否有超出范围的改动。
`
第 5 步:判断是否接受
理想 diff 应该很小且只包含预期修改。如果改多了,要求解释:
`
我要求只改 1 个文件,但现在有多个变化。请逐个解释原因,不要继续修改。
`
如何撤回修改?
如果改错了,指定文件撤回:
`markdown
请撤回本次对 [文件路径] 的修改。
要求:只撤回该文件,不改其他,撤回后检查 Git 状态并告诉我。
``
下一篇看:让 Codex 完成任务验收。