Codex /goal 小白使用指南：怎么开、怎么写、怎么用

Codex /goal 小白使用指南：怎么开、怎么写、怎么用 Codex /goal 小白使用指南：怎么开、怎么写、怎么用 Modified June 6 方法二：如果看不到 /goal 💡 如果输入 /goal 后命令列表没有出现，通常是功能开关没打开。 CLI 开启方式 Bash Copy codex features enable goals 手动配置方式： /.codex/config.toml TOML Copy [features] goals = true 开启后重启 Codex，再在输入框里试 /goal。在 Codex App 里，目标运行时会在输入框上方显示进度区域，并提供暂停、继续、编辑、清除等按钮。 一条好 goal 长什么样 组成部分 你要写什么 例子 目标 最终要交付什么 把项目从 JavaScript 迁移到 TypeScript 范围 哪些文件、模块、页面或功能要覆盖 只处理 src 和 tests，不改 docs 验收 怎么证明完成了 strict mode 编译通过，测试全绿 边界 哪些事不要做 不要引入新框架，不要重写认证逻辑 ✅ 推荐模板：/goal 完成 [具体结果]。范围：[要覆盖什么]。验收标准：[如何验证]。限制：[不要做什么]。 坏例子 vs 好例子 不推荐 • 帮我优化一下 • 把项目弄好 • 修所有问题 问题：太模糊，Codex 不知道哪里算完成。 推荐 • 把首页首屏加载时间降到 1 秒以内，并说明验证方法 • 修复 CI 中失败的 lint 和 test，最终给出通过记录 • 把支付模块重构为更小的函数，并保持现有测试通过 优点：结果清楚，能验证，能收尾。 可直接复制的案例 案例 1：修 bug 并补测试 复制到 Codex Plain Text Copy /goal 修复用户登录后偶尔跳回登录页的问题。请先复现和定位原因，再实现修复，补充回归测试。验收标准：相关测试通过，手动说明复现路径和修复结果。 适用场景：问题不是一眼能改完，需要读代码、定位、修改、验证。 案例 2：修 CI 复制到 Codex Plain Text Copy /goal 让当前分支 CI 恢复通过。请读取失败日志，逐个修复 lint、typecheck、test 问题，不做无关重构。验收标准：本地等价命令通过，并列出改动摘要。 适用场景：CI 失败项较多，可能需要几轮修复和验证。 案例 3：代码迁移 复制到 Codex Plain Text Copy /goal 将这个项目从 JavaScript 迁移到 TypeScript。范围：src 和 tests。验收标准：TypeScript strict mode 编译通过，不新增显式 any，现有测试通过。 适用场景：迁移工作大、涉及多文件，目标需要持续挂着。 案例 4：性能优化 复制到 Codex Plain Text Copy /goal 把首页 Time to Interactive 优化到 1 秒以内。请先建立当前基线，再做最小必要改动。验收标准：给出前后数据、验证命令和风险说明。 适用场景：需要先测量、再优化、再对比结果。 案例 5：整理资料成文档 复制到 Codex Plain Text Copy /goal 把当前文件夹里的会议记录整理成一份面向新同事的入门文档。要求：结构清楚、术语解释友好、保留关键链接，最后生成飞书文档。 适用场景：有资料搜集、信息筛选、成稿和发布几个阶段。 案例 6：先计划再执行 第一步：先让 Codex 帮你打磨目标 Plain Text Copy /plan 我想重构订单模块，但不确定怎么拆步骤。请先问我必要问题，然后给出可执行计划。 第二步：确认计划后再设 goal Plain Text Copy /goal 按刚才确认的计划重构订单模块。验收标准：订单创建、取消、退款流程测试通过，不改变外部 API。 适用场景：你只知道大方向，还不知道合理的完成标准。 什么时候用，什么时候别用 场景 建议 原因 一句话能解决 不用 /goal 普通提示更快，例如“解释这个函数”。 需要多轮执行和验证 用 /goal 目标会持续存在，Codex 更不容易跑偏。 目标还很模糊 先用 /plan 先把范围和验收标准说清楚，再启动长期任务。 你临时想问个旁支问题 用普通追问或 side chat 避免打断主目标。 长说明超过 4000 字符 放进文件，再让 goal 指向文件 官方说明中，goal 文本必须非空且最多 4000 字符。 ❗ 实用提醒：不要把整份需求文档都塞进 /goal。更稳的写法是：把长需求保存成文件，然后写“按 docs/需求说明.md 完成迁移，验收标准如下……”。 常见问题 Q1：/goal 会替代普通聊天吗？ 💡 不会。/goal 是给长期任务用的。目标运行期间，你仍然可以继续发消息补充约束、指定方案、要求状态汇报。 Q2：/goal 会一直运行不停吗？ 💡 不会。Codex 会围绕目标推进，直到完成、暂停、需要你补充信息，或者你主动清除目标。 Q3：目标中能写预算或 token 限制吗？ 💡 可以写你明确需要的限制，但不建议随手加 token 预算。更适合新手的限制是时间、范围、验收命令、不要修改哪些文件。 Q4：目标完成后要做什么？ 检查 Codex 的最终摘要和文件改动。 运行它给出的验证命令，或让它补跑验证。 确认没问题后，用 /goal clear 清除当前目标。 来源与版本说明 来源 用于确认什么 OpenAI Codex App Commands App 中 /goal 的开启方式、进度区域、暂停/继续/编辑/清除控件，以及 features.goals 开关。 OpenAI Codex CLI Slash Commands CLI 中 /goal <objective 、/goal、/goal pause、/goal resume、/goal clear 的用法，以及 4000 字符限制。 OpenAI Codex Prompting / Goal mode Goal mode 的定义、适用场景、好目标应包含具体结果和验收标准。 本机命令检查 codex cli 0.134.0；codex features list 显示 goals stable true。 💡 最终口诀：小任务直接说；大任务先 /plan；目标清楚后用 /goal；完成后看验证、清目标。 OpenAI Codex App Commands OpenAI Codex CLI Slash Commands OpenAI Codex Prompting / Goal mode 方法二：如果看不到 /goal 💡 如果输入 /goal 后命令列表没有出现，通常是功能开关没打开。 如果输入 /goal 后命令列表没有出现，通常是功能开关没打开。 开启后重启 Codex，再在输入框里试 /goal。在 Codex App 里，目标运行时会在输入框上方显示进度区域，并提供暂停、继续、编辑、清除等按钮。 一条好 goal 长什么样 组成部分 你要写什么 例子 目标 最终要交付什么 把项目从 JavaScript 迁移到 TypeScript 范围 哪些文件、模块、页面或功能要覆盖 只处理 src 和 tests，不改 docs 验收 怎么证明完成了 strict mode 编译通过，测试全绿 边界 哪些事不要做 不要引入新框架，不要重写认证逻辑 组成部分 组成部分 你要写什么 你要写什么 例子 例子 目标 目标 最终要交付什么 最终要交付什么 把项目从 JavaScript 迁移到 TypeScript 把项目从 JavaScript 迁移到 TypeScript 范围 范围 哪些文件、模块、页面或功能要覆盖 哪些文件、模块、页面或功能要覆盖 只处理 src 和 tests，不改 docs 只处理 src 和 tests，不改 docs 验收 验收 怎么证明完成了 怎么证明完成了 strict mode 编译通过，测试全绿 strict mode 编译通过，测试全绿 边界 边界 哪些事不要做 哪些事不要做 不要引入新框架，不要重写认证逻辑 不要引入新框架，不要重写认证逻辑 ✅ 推荐模板：/goal 完成 [具体结果]。范围：[要覆盖什么]。验收标准：[如何验证]。限制：[不要做什么]。 推荐模板：/goal 完成 [具体结果]。范围：[要覆盖什么]。验收标准：[如何验证]。限制：[不要做什么]。 坏例子 vs 好例子 不推荐 • 帮我优化一下 • 把项目弄好 • 修所有问题 问题：太模糊，Codex 不知道哪里算完成。 推荐 • 把首页首屏加载时间降到 1 秒以内，并说明验证方法 • 修复 CI 中失败的 lint 和 test，最终给出通过记录 • 把支付模块重构为更小的函数，并保持现有测试通过 优点：结果清楚，能验证，能收尾。 不推荐 • 帮我优化一下 • 把项目弄好 • 修所有问题 问题：太模糊，Codex 不知道哪里算完成。 不推荐 • 帮我优化一下 • 把项目弄好 • 修所有问题 问题：太模糊，Codex 不知道哪里算完成。 推荐 • 把首页首屏加载时间降到 1 秒以内，并说明验证方法 • 修复 CI 中失败的 lint 和 test，最终给出通过记录 • 把支付模块重构为更小的函数，并保持现有测试通过 优点：结果清楚，能验证，能收尾。 推荐 • 把首页首屏加载时间降到 1 秒以内，并说明验证方法 • 修复 CI 中失败的 lint 和 test，最终给出通过记录 • 把支付模块重构为更小的函数，并保持现有测试通过 优点：结果清楚，能验证，能收尾。 可直接复制的案例 案例 1：修 bug 并补测试 适用场景：问题不是一眼能改完，需要读代码、定位、修改、验证。 案例 2：修 CI 适用场景：CI 失败项较多，可能需要几轮修复和验证。 案例 3：代码迁移 适用场景：迁移工作大、涉及多文件，目标需要持续挂着。 案例 4：性能优化 适用场景：需要先测量、再优化、再对比结果。 案例 5：整理资料成文档 适用场景：有资料搜集、信息筛选、成稿和发布几个阶段。 案例 6：先计划再执行 适用场景：你只知道大方向，还不知道合理的完成标准。 什么时候用，什么时候别用 场景 建议 原因 一句话能解决 不用 /goal 普通提示更快，例如“解释这个函数”。 需要多轮执行和验证 用 /goal 目标会持续存在，Codex 更不容易跑偏。 目标还很模糊 先用 /plan 先把范围和验收标准说清楚，再启动长期任务。 你临时想问个旁支问题 用普通追问或 side chat 避免打断主目标。 长说明超过 4000 字符 放进文件，再让 goal 指向文件 官方说明中，goal 文本必须非空且最多 4000 字符。 场景 场景 建议 建议 原因 原因 一句话能解决 一句话能解决 不用 /goal 不用 /goal 普通提示更快，例如“解释这个函数”。 普通提示更快，例如“解释这个函数”。 需要多轮执行和验证 需要多轮执行和验证 用 /goal 用 /goal 目标会持续存在，Codex 更不容易跑偏。 目标会持续存在，Codex 更不容易跑偏。 目标还很模糊 目标还很模糊 先用 /plan 先用 /plan 先把范围和验收标准说清楚，再启动长期任务。 先把范围和验收标准说清楚，再启动长期任务。 你临时想问个旁支问题 你临时想问个旁支问题 用普通追问或 side chat 用普通追问或 side chat 避免打断主目标。 避免打断主目标。 长说明超过 4000 字符 长说明超过 4000 字符 放进文件，再让 goal 指向文件 放进文件，再让 goal 指向文件 官方说明中，goal 文本必须非空且最多 4000 字符。 官方说明中，goal 文本必须非空且最多 4000 字符。 ❗ 实用提醒：不要把整份需求文档都塞进 /goal。更稳的写法是：把长需求保存成文件，然后写“按 docs/需求说明.md 完成迁移，验收标准如下……”。 实用提醒：不要把整份需求文档都塞进 /goal。更稳的写法是：把长需求保存成文件，然后写“按 docs/需求说明.md 完成迁移，验收标准如下……”。 常见问题 Q1：/goal 会替代普通聊天吗？ 💡 不会。/goal 是给长期任务用的。目标运行期间，你仍然可以继续发消息补充约束、指定方案、要求状态汇报。 不会。/goal 是给长期任务用的。目标运行期间，你仍然可以继续发消息补充约束、指定方案、要求状态汇报。 Q2：/goal 会一直运行不停吗？ 💡 不会。Codex 会围绕目标推进，直到完成、暂停、需要你补充信息，或者你主动清除目标。 不会。Codex 会围绕目标推进，直到完成、暂停、需要你补充信息，或者你主动清除目标。 Q3：目标中能写预算或 token 限制吗？ 💡 可以写你明确需要的限制，但不建议随手加 token 预算。更适合新手的限制是时间、范围、验收命令、不要修改哪些文件。 可以写你明确需要的限制，但不建议随手加 token 预算。更适合新手的限制是时间、范围、验收命令、不要修改哪些文件。 Q4：目标完成后要做什么？ 检查 Codex 的最终摘要和文件改动。 运行它给出的验证命令，或让它补跑验证。 确认没问题后，用 /goal clear 清除当前目标。 来源与版本说明 来源 用于确认什么 OpenAI Codex App Commands App 中 /goal 的开启方式、进度区域、暂停/继续/编辑/清除控件，以及 features.goals 开关。 OpenAI Codex CLI Slash Commands CLI 中 /goal <objective 、/goal、/goal pause、/goal resume、/goal clear 的用法，以及 4000 字符限制。 OpenAI Codex Prompting / Goal mode Goal mode 的定义、适用场景、好目标应包含具体结果和验收标准。 本机命令检查 codex cli 0.134.0；codex features list 显示 goals stable true。 OpenAI Codex App Commands OpenAI Codex CLI Slash Commands OpenAI Codex Prompting / Goal mode 来源 来源 用于确认什么 用于确认什么 OpenAI Codex App Commands OpenAI Codex App Commands OpenAI Codex App Commands OpenAI Codex App Commands App 中 /goal 的开启方式、进度区域、暂停/继续/编辑/清除控件，以及 features.goals 开关。 App 中 /goal 的开启方式、进度区域、暂停/继续/编辑/清除控件，以及 features.goals 开关。 OpenAI Codex CLI Slash Commands OpenAI Codex CLI Slash Commands OpenAI Codex CLI Slash Commands OpenAI Codex CLI Slash Commands CLI 中 /goal <objective 、/goal、/goal pause、/goal resume、/goal clear 的用法，以及 4000 字符限制。 CLI 中 /goal <objective 、/goal、/goal pause、/goal resume、/goal clear 的用法，以及 4000 字符限制。 OpenAI Codex Prompting / Goal mode OpenAI Codex Prompting / Goal mode OpenAI Codex Prompting / Goal mode OpenAI Codex Prompting / Goal mode Goal mode 的定义、适用场景、好目标应包含具体结果和验收标准。 Goal mode 的定义、适用场景、好目标应包含具体结果和验收标准。 本机命令检查 本机命令检查 codex cli 0.134.0；codex features list 显示 goals stable true。 codex cli 0.134.0；codex features list 显示 goals stable true。 💡 最终口诀：小任务直接说；大任务先 /plan；目标清楚后用 /goal；完成后看验证、清目标。 最终口诀：小任务直接说；大任务先 /plan；目标清楚后用 /goal；完成后看验证、清目标。 ✅ 一句话结论：/goal 是 Codex 的“长期任务目标模式”。普通提示像“让 Codex 做一件事”，/goal 像“给 Codex 贴一张任务卡”，它会把目标一直挂在当前线程里，边做边检查有没有达成。 最适合：迁移、重构、修 CI、性能优化、长文档整理、多轮测试这类需要很多步骤的任务。 一句话结论：/goal 是 Codex 的“长期任务目标模式”。普通提示像“让 Codex 做一件事”，/goal 像“给 Codex 贴一张任务卡”，它会把目标一直挂在当前线程里，边做边检查有没有达成。 最适合：迁移、重构、修 CI、性能优化、长文档整理、多轮测试这类需要很多步骤的任务。 先看 30 秒速查 你想做什么 输入什么 结果是什么 设置目标 /goal 修复登录失败问题，补测试，并确保 npm test 通过 Codex 开始围绕这个目标持续工作。 查看目标 /goal 显示当前线程正在追踪的目标。 暂停目标 /goal pause 临时停下，不再继续推进这个目标。 继续目标 /goal resume 恢复之前暂停的目标。 清除目标 /goal clear 移除当前线程的目标。 你想做什么 你想做什么 输入什么 输入什么 结果是什么 结果是什么 设置目标 设置目标 /goal 修复登录失败问题，补测试，并确保 npm test 通过 /goal 修复登录失败问题，补测试，并确保 npm test 通过 Codex 开始围绕这个目标持续工作。 Codex 开始围绕这个目标持续工作。 查看目标 查看目标 /goal /goal 显示当前线程正在追踪的目标。 显示当前线程正在追踪的目标。 暂停目标 暂停目标 /goal pause /goal pause 临时停下，不再继续推进这个目标。 临时停下，不再继续推进这个目标。 继续目标 继续目标 /goal resume /goal resume 恢复之前暂停的目标。 恢复之前暂停的目标。 清除目标 清除目标 /goal clear /goal clear 移除当前线程的目标。 移除当前线程的目标。 💡 本机确认：当前机器的 codex features list 显示 goals 是 stable true，也就是 Goal 功能已开启。 本机确认：当前机器的 codex features list 显示 goals 是 stable true，也就是 Goal 功能已开启。 /goal 到底是什么 普通提示 你说一句，Codex 做一轮。适合简单、短平快的任务。 例：解释这个函数、改一个按钮文字、跑一次测试。 /goal 把“最终要完成什么”挂到当前线程上。适合多步骤、可能中断、需要持续验证的任务。 例：完成迁移并保证测试通过、修完 CI、把一份资料整理成可发布文档。 普通提示 你说一句，Codex 做一轮。适合简单、短平快的任务。 例：解释这个函数、改一个按钮文字、跑一次测试。 普通提示 你说一句，Codex 做一轮。适合简单、短平快的任务。 例：解释这个函数、改一个按钮文字、跑一次测试。 例：解释这个函数、改一个按钮文字、跑一次测试。 /goal 把“最终要完成什么”挂到当前线程上。适合多步骤、可能中断、需要持续验证的任务。 例：完成迁移并保证测试通过、修完 CI、把一份资料整理成可发布文档。 /goal 把“最终要完成什么”挂到当前线程上。适合多步骤、可能中断、需要持续验证的任务。 例：完成迁移并保证测试通过、修完 CI、把一份资料整理成可发布文档。 例：完成迁移并保证测试通过、修完 CI、把一份资料整理成可发布文档。 Unable to load the board. Please refresh and try again.Copy ErrorRefresh Nothing on the board yet 💡 新手理解法：/goal 不只是“开始干活”，它还是“验收标准”。你写得越像“完成后应该是什么样”，Codex 越容易判断自己该停在哪里。 新手理解法：/goal 不只是“开始干活”，它还是“验收标准”。你写得越像“完成后应该是什么样”，Codex 越容易判断自己该停在哪里。 怎么开启 /goal 方法一：直接输入 1. 打开 Codex App、IDE 插件或 CLI 的输入框。 2. 输入 /goal，后面接你的目标。 3. 按回车，Codex 会把这句话作为当前线程的持续目标。