Codex /goal 怎么用：创建、暂停、继续和清除

先确认版本支持 Goal

OpenAI Cookbook 说明 Goals 自 Codex 0.128.0 起提供。先运行 codex --version；若版本低于 0.128.0，不要把命令缺失误判成任务配置错误，先按官方安装渠道升级再重新打开 Codex。

把目标写成结果、证据和停止条件

不要只写‘继续优化项目’。一个可控示例是：‘让 tests/search.test.ts 通过；只修改搜索实现和对应测试；每轮先读最新失败；当 focused test 与 git diff --check 都退出 0 时停止；不得发布、安装依赖或清理其他改动。’ 停止条件必须能由命令输出确认。

1. 创建 Goal

   操作

   在 Codex 中输入 /goal，并把结果、允许范围、验证命令、失败处理和停止条件填完整。

   你应该看到

   界面显示一个活动 Goal，内容包含明确的完成与停止证据。

   如何确认

   逐项确认目标没有无限词语，且每个完成声明都能对应输出。

   卡住时

   • 如果 /goal 不可用，先核对 codex --version 是否至少为 0.128.0。
   • 如果目标写成‘做到最好’，改成具体测试、文件或外部状态。

需要检查时用 /goal pause

输入 /goal pause 会暂停自动继续，适合查看 diff、确认外部账号、处理新风险或修改任务范围。暂停不是失败，也不是清除；当前目标仍保留。不要在目标正在修改文件时用另一条并行任务改同一文件。

解决阻塞后用 /goal resume

输入 /goal resume 让已暂停的 Goal 继续。继续前先把最新测试输出、已确认边界和仍未完成项放回当前上下文，避免它根据旧失败反复工作。

1. 带着最新状态继续

   操作

   修复阻塞后粘贴最新失败或通过结果，再输入 /goal resume。

   你应该看到

   Goal 从未完成的检查点继续，而不是重新创建另一条目标。

   如何确认

   下一轮先引用最新证据，并在停止条件满足时结束。

   卡住时

   • 如果继续后仍重复旧动作，先 pause，明确指出最新输出取代旧输出，再 resume。
   • 如果范围已经发生实质变化，clear 旧 Goal 后重新定义，不要悄悄扩大权限。

完成或作废时用 /goal clear

输入 /goal clear 清除当前 Goal。只有当停止条件已满足、目标已作废或你明确决定放弃时才清除；clear 不是撤销文件改动，也不会替你恢复工作树。清除前保存测试结果、diff 和未验证项。

用停止条件防止无限循环

每轮结束都检查：目标测试是否退出 0；git diff --check 是否退出 0；是否出现越界文件；是否仍有未验证外部状态；继续一轮是否还能产生新证据。前两项通过且没有范围内未完成工作时停止。连续重复相同阻塞而没有新证据时先 pause，不要用更多轮数掩盖问题。

本站本次实测：只验证版本与任务内状态读取

版本：Codex CLI 0.138.0。输入：运行 codex --version，并分别在拥有 Goal 的主任务和隔离子任务读取 Goal 状态。关键输出：主任务返回 status=active 与 createdAt/updatedAt；子任务返回 goal=null，说明状态按任务隔离。退出码：版本命令为 0，两次状态读取均正常返回。验收结论：局部通过，只证明版本门槛和 active 状态可读。失败项：交互式 /goal、/goal pause、/goal resume、/goal clear 没有在本次非交互环境执行，因此整篇仍标记未实测。公开脱敏记录：https://www.buildmemobrick.com/benchmarks/guides/goal-partial-run.json。

来源与转换边界

版本 0.128.0、/goal、/goal pause、/goal resume 和 /goal clear 来自 OpenAI 官方说明。本文新增的目标模板与停止清单是本站按可核验工作流独立整理，不代表所有任务都适合持续运行，也不承诺节省固定时间。状态读取的局部实测不能替代交互式全流程验证。