本篇目标是跑通最小修改闭环:明确任务 -> 限定范围 -> 修改 -> 解释 diff -> 判断接受

> 前置教程:第一次让 Codex 阅读项目

> 依据来源:OpenAI Codex 官方手册中关于提示词、任务上下文、验证和审查 diff 的说明。

任务选择原则

  • 推荐:修改 README、首页文案、按钮文字、静态提示语。
  • 避免:修复杂 Bug、新增完整功能、一次改多个文件。

第 1 步:启动并确认状态

进入项目目录启动 Codex:

``bash

codex

`

发送确认请求:

`markdown

在开始修改前,请先只读确认当前项目是否适合做第一次小修改。

请检查:项目路径、Git 是否干净、首页文案位置、建议只改哪 1 个文件。

要求:不要修改、不要构建、不要安装、不要提交。

`

第 2 步:发出明确的修改指令

如果是改 Vite 首页标题:

`markdown

请完成一个小的首次修改任务。

目标:把首页默认标题改成 “Codex Demo”。

范围:

  1. 先定位文件。
  2. 2. 只允许修改 1 个文件。

    3. 不要修改样式、不安装依赖、不运行构建、不提交 Git。

    4. 修改后自己检查 Git 状态和 diff 并中文解释。

    完成后格式汇报:修改文件、修改内容、原因、diff 总结。

    `

    第 3 步:等待并审查结果

    看它的总结,确认:

    1. 是否只改了 1 个文件。
    2. 2. 是否有原文案和新文案对比。

      3. 是否偷跑了命令。

      第 4 步:解释 Git 状态和 diff

      如果它没主动解释,追问:

      `markdown

      请检查本次修改后的 Git 状态和 diff 并用中文解释。

      要求:列出修改文件、原因、总结 diff、判断是否只改了 1 个文件、判断是否有超出范围的改动。

      `

      第 5 步:判断是否接受

      理想 diff 应该很小且只包含预期修改。如果改多了,要求解释:

      `

      我要求只改 1 个文件,但现在有多个变化。请逐个解释原因,不要继续修改。

      `

      如何撤回修改?

      如果改错了,指定文件撤回:

      `markdown

      请撤回本次对 [文件路径] 的修改。

      要求:只撤回该文件,不改其他,撤回后检查 Git 状态并告诉我。

      ``

      下一篇看:让 Codex 完成任务验收