如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
Codex

Codex 使用场景

持续推进目标

为 Codex 设定一个目标,让它在整个长期任务中始终围绕这个目标工作。

难度 Advanced
时间跨度 Long-running

如果任务需要 Codex 在多轮对话中持续工作,直到满足可验证的结束条件,请使用 /goal。

最适合

  • 耗时较长、成功条件明确且可反复验证结果的编码任务。
  • Codex 可以在既定范围内持续推进的工作,例如代码迁移、大规模重构、部署失败后的循环重试、实验、游戏开发和业余项目。
  • 需要按明确的成功标准开展长期实验的团队。

目录

    ← 所有使用场景

    持续推进目标

    为 Codex 设定一个目标,让它在整个长期任务中始终围绕这个目标工作。

    如果任务需要 Codex 在多轮对话中持续工作,直到满足可验证的结束条件,请使用 /goal。

    Advanced
    Long-running

    如果任务需要 Codex 在多轮对话中持续工作,直到满足可验证的结束条件,请使用 /goal。

    Advanced
    Long-running

    最适合

    • 耗时较长、成功条件明确且可反复验证结果的编码任务。
    • 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 根据评测结果优化提示词。Codex 可以分析失败用例、修改提示词并重新运行评测,持续迭代,直到分数提高或满足您设定的停止条件。

    /goal 优化 [prompt file or directory] 中的提示词,直到评测达到 [target score or pass rate]。每次修改后,运行 [eval command] 并分析失败用例。只对提示词做必要且有针对性的修改。达到目标后停止。如果进一步修改提示词需要产品或政策方面的指导,也请停止。

    相关使用场景