For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主导航
Codex

Codex use case

持续推进目标

为 Codex 设定一个持久目标,用于需要长时间运行的工作。

Difficulty 高级
Time horizon 长时间运行

当任务需要 Codex 跨多个轮次持续工作,直至满足可验证的停止条件时,请使用 /goal

最适合

  • 有明确成功条件和验证循环、需要长时间运行的编码工作。
  • 代码迁移、大型重构、部署重试循环、实验、游戏和业余项目;在这些工作中,Codex 可以在明确范围内持续取得进展。
  • 需要按明确成功标准开展长期实验的团队。

Contents

    ← 全部使用场景

    持续推进目标

    为 Codex 设定一个持久目标,用于需要长时间运行的工作。

    当任务需要 Codex 跨多个轮次持续工作,直至满足可验证的停止条件时,请使用 /goal

    高级
    长时间运行

    当任务需要 Codex 跨多个轮次持续工作,直至满足可验证的停止条件时,请使用 /goal

    高级
    长时间运行

    最适合

    • 有明确成功条件和验证循环、需要长时间运行的编码工作。
    • 代码迁移、大型重构、部署重试循环、实验、游戏和业余项目;在这些工作中,Codex 可以在明确范围内持续取得进展。
    • 需要按明确成功标准开展长期实验的团队。

    入门提示

    /goal 完成 [objective],在达到 [verifiable end state] 之前不要停止。
    /goal 完成 [objective],在达到 [verifiable end state] 之前不要停止。

    简介

    当您希望 Codex 围绕一个持久目标持续推进,而不是在一个常规轮次结束后停止时,请使用 /goal。它适合目标明确、具备验证循环,并且有足够空间让 Codex 自行推进而无需您逐步指导的工作。使用 /goal 后,Codex 可以在无需您输入的情况下独立工作多个小时。

    使用 /goal <objective> 设定目标,使用 /goal 查看当前目标;需要控制本次运行时,请使用 /goal pause/goal resume/goal clear

    如果 /goal 未出现在斜杠命令列表中,请启用 features.goals 配置(位于 config.toml 中):

    [features]
    goals = true

    您也可以在 CLI 中运行 codex features enable goals,或让 Codex 运行该命令。

    选择合适的任务

    合适的目标,其范围应超出单个提示所能覆盖的内容,但又不能宽泛到像一份没有明确边界的待办列表。它应明确 Codex 要实现什么、不应更改什么、如何验证进展,以及何时停止。

    适用场景包括:

    • 目标技术栈、一致性检查和约束均已明确的代码迁移
    • Codex 可以在每个检查点后运行测试的大型重构
    • Codex 可以持续改进可用成果的实验、游戏或原型

    避免使用目标来处理一组彼此无关的零散工作。

    建立工作循环

    1. 明确一个目标和一个停止条件。
    2. 向 Codex 指明它必须先阅读的文件、文档、议题、日志或计划。
    3. 明确用于证明进展的命令或产物。
    4. 让 Codex 按检查点推进,并保留简短的进度日志。
    5. 运行期间,使用 /goal 查看状态。
    6. 当运行完成、受阻或需要调整方向时,请暂停、恢复或清除目标。

    关键在于约定。Codex 应在开始前就知道“完成”意味着什么。如果目标是迁移,“完成”可能意味着新路径通过契约测试,同时旧路径仍保留回滚方案。如果目标是游戏或原型,“完成”可能意味着应用可以构建和启动,并且与所提供的参考内容或预期行为一致。

    请 Codex 提供帮助:先与它讨论您想要 构建的内容,然后让它直接设定目标并开始工作。

    让 Codex 独立工作

    在目标执行期间,请 Codex 提供简洁的进度报告,以便您放心地让它继续运行。实用的状态更新应说明当前检查点、已验证的内容、剩余工作,以及 Codex 是否受阻。 如果状态变得含糊,请进一步明确目标,而不是添加更多一次性指令。请明确告诉 Codex 接下来哪个检查点最重要、用哪条命令可加以验证,以及在什么情况下应暂停。

    Codex 持续推进目标时,可以在无需您查看进展的情况下连续独立工作多个小时。它会在确信已达到停止条件时停止运行,因此,您应将 /goal 视为一项无需监控的后台任务。

    目标示例

    迁移

    无论您是将游戏迁移到新的技术栈、将移动应用迁移到新平台,还是将代码库迁移到新框架,都可以使用 /goal 让 Codex 执行迁移:

    /goal 将此项目从 [legacy stack or system] 迁移到 [target stack or system]。确保所有屏幕的视觉效果保持完全一致,并使用 playwright interactive 验证输出。

    创建原型

    无论您是从零开始创建新应用、新游戏还是新功能,都可以使用 /goal 让 Codex 完成一个精心打磨的首个版本。您可以使用 PLAN.md 文件指导首个版本的创建,并在其中准确描述您想要构建的内容。

    /goal 实现 PLAN.md 中的计划,为每个里程碑创建测试,并使用 playwright interactive 验证输出。 [include reference screens as needed]

    提示优化

    有评测套件后,您可以使用 /goal 根据评测结果优化提示。Codex 可以检查失败项、更新提示、重新运行评测,并不断迭代,直到分数提高或满足您设定的停止条件。

    /goal 优化 [prompt file or directory] 中的提示,直到评测套件达到 [target score or pass rate]。每次更改后,运行 [eval command],检查失败用例,并且只对提示做最少且有针对性的修改。达到目标,或需要产品或政策方面的指导才能进一步修改提示时,请停止。

    相关使用场景