如何使用Codex的Goals机制完成长程任务?
导读
Codex 是 OpenAI 推出的 AI 编程 Agent,擅长在代码仓库中执行明确的单步任务——修 Bug、加测试、解释报错。但现实中的很多工作不是一步能完成的:你需要反复跑基准、排查不稳定的测试、迁移一批依赖、或者复现一篇论文的核心实验。这类任务的特点是——终点明确,路径未知。
过去,你得在每一轮对话后手动催促:"继续""再试一次""跑下测试""还没完"。这本质上是在弥补一个缺失:没有一个持久的"目标"在驱动整个过程。
Goals 就是为了解决这个问题而设计的。它不是更长的提示词,而是一个绑定在对话线程上的完成契约。你定义"什么算做完",Codex 持续验证证据,自动决定下一步,直到目标达成或诚实报告受阻。
具体来说,一个 Goal 通常包含三个核心要素:
• 可度量的结果:不是"优化性能",而是"p95 延迟降到 120ms 以下" • 验证手段:跑哪个基准、过哪套测试、生成什么产物 • 约束条件:不能破坏正确性测试、不能改公共 API
有了这三样东西,Codex 就能在"发现热点→修改代码→跑基准→检查约束"之间形成闭环,不需要你反复介入。
Goals 的典型应用场景包括:
• 性能调优:带着基准指标和约束自动迭代优化 • Bug 追查:复现问题、定位根因、验证修复,全程有证据链 • 依赖迁移:批量升级、修复兼容性问题、确保测试通过 • 研究复现:逐声明验证论文结果,区分精确复现和近似重建
最佳实践也很有意思:如果你描述不清 Goal,可以直接让 Codex 帮你写——把任务用大白话说出来,Codex 会帮你补全验证标准和阻塞条件。Goal 还可以在执行中暂停、恢复,预算用完会自动停止并汇报进展。
简单说:Goals 让 Codex 从"你问一步它走一步"变成"你定终点它自己走到"。对开发者来说,这是从手动驾驶到设定导航的跃迁。
Codex Goals 机制使用指南
Goals 是 Codex 中的持久化目标,让对话线程持续朝着一个预先定义的结果努力。Goal 为 Codex 提供了一个完成条件:目标状态应该是什么、如何验证成功、以及哪些约束必须保持不变。
对于范围明确的编码任务,Codex 已经表现出色:检查仓库、修复 Bug、添加测试、解释失败原因或实现一个聚焦的改动。但 Goals 是为那些需要探索的任务设计的——下一步行动取决于 Codex 在过程中学到什么:性能分析、补丁修复、基准测试、复现不稳定测试,或者将研究问题转化为有证据支持的审计报告。
这些任务不需要更长的提示词。它们需要一个持久化的目标。有了 Goal,Codex 可以将目标时刻放在视野中,评估工作是否完成,并选择下一个有用的行动——无需你在每个中间结果后重新陈述目标。
Goal 不是没有边界的后台自主权。它是一个有范围的、用户可控的完成契约。你定义结果,Codex 依据线程中的证据展开工作,而 Goal 可以被暂停、恢复、清除、完成或触达预算上限后停止。
你将学到什么
完成本指南后,你将能够:
• 判断何时 Goal 比一次性提示更合适 • 编写具有可度量结果、可验证表面和约束条件的 Goal • 使用 /goal、/goal pause、/goal resume和/goal clear管理 Goal 生命周期
前提条件
• 支持 Goals 的 Codex 版本(0.128+) • 带有明确终点的任务,以及可检查的证据源(如测试、基准测试或最终产出物) • 足够多的仓库或研究上下文,使 Codex 能够实际验证进展,而不是仅做叙述
概览
1. 启动一个 Goal 并管理其生命周期 2. 理解 Goal 与一次性提示的区别 3. 编写带有可审计完成条件的 Goals 4. 将这一模式应用于复杂的研究工作 5. 判断何时普通提示仍是更好的工具
图 1:Goal 将单次交互转化为一个以证据验证驱动的持续循环。
快速开始:使用 Goals
当任务有明确的终点但通往终点的路径不确定时,使用 Goal。
适合的场景包括:性能优化、不稳定测试排查、依赖迁移、需要复现的 Bug 追查、多步骤重构、基准驱动调优,以及需要最终产出物的研究任务。对于一次性编辑,普通提示仍然是正确的选择。
要使用 Goals,请安装或更新 Codex 并确认版本。Goals 从 Codex 0.128.0 版本开始可用。
使用 npm 安装:
npm install -g @openai/codex@latest
codex --version使用 Homebrew 安装:
brew update
brew upgrade --cask codex
codex --version然后使用 /goal 加上期望结果来设置 Goal:
/goal 在不破坏正确性测试的前提下,将 p95 延迟降低到 120ms 以下
你可以从同一个命令界面管理生命周期:
/goal 查看当前 Goal
/goal pause 暂停当前 Goal
/goal resume 恢复暂停的 Goal
/goal clear 移除当前 Goal一旦 Goal 激活,Codex 可以检查代码、运行相关命令、做出修改、测试结果,并持续进行直到达到停止条件。停止条件可能是:成功、暂停、清除、中断、预算上限,或需要用户输入的阻塞点。
当你发现自己在每一轮对话后都在重复类似的话时,就应该使用 Goal:
继续。试下一个可能的修复。再跑一次基准测试。现在检查测试。继续直到真正完成。
Goal 让这些意图变得明确。
Goal 与 Prompt 的区别
普通 Prompt 说:做下一件事。
Goal 说:持续工作,直到这个结果为真。
这个区别很关键。在普通请求中,Codex 执行即时指令、报告结果、然后等待。有了 Goal,Codex 的线程上附加了一个持久的目标。一轮对话结束后,它可以检查当前证据,判断目标是否满足。如果答案是否定的,且 Goal 仍处于激活状态并且在预算范围内,Codex 可以从最新状态继续。
这使 Goal 在"下一步正确行动取决于 Codex 刚学到的东西"时最为有用。例如:
/goal 在结账基准测试中将 p95 延迟降至 120ms 以下,同时保持正确性测试套件为绿色通过状态
这不只是改善性能的请求。它给了 Codex 一个可度量的结果、一个验证表面和一个约束条件。Codex 可以运行基准测试、检查热点路径、做出有针对性的修改、再次运行基准测试、运行正确性测试套件,并在结果不够好时继续。
实用的心智模型很简单:
Prompt: 请求 → 工作 → 结果 → 等待
Goal: 工作 → 检查 → 继续或完成
Goal 给了 Codex 一条终点线。但工作成果仍需要对照证据进行审计。
如何编写一个 Goal
一个好的 Goal 不仅仅是更长的提示词。它是一个关于 Codex 应如何工作、什么算成功、以及如果暂时无法达到成功应如何处理的精简契约。
最强的 Goals 通常定义六个要素:
• 结果 (Outcome):工作完成时什么应该为真 • 验证表面 (Verification surface):用于证明成功的测试、基准、报告、产物、命令输出或源材料 • 约束 (Constraints):在 Codex 工作时哪些不能退化 • 边界 (Boundaries):Codex 可以使用哪些文件、工具、数据、仓库或资源 • 迭代策略 (Iteration policy):Codex 在每次尝试后应如何决定下一步做什么 • 阻塞停止条件 (Blocked stop condition):Codex 应在何时停止并报告当前限制下没有可行的路径
一个有用的模式是:
/goal <期望的最终状态> 由 <具体证据> 验证,同时保持 <约束>。使用 <允许的输入、工具或边界>。在迭代之间,<Codex 应如何选择下一个最佳行动>。如果被阻塞或没有可行路径,<Codex 应报告什么以及什么能推进进展>。
例如,这个 Goal 可用但偏单薄:
/goal 在不破坏正确性测试的前提下…