Skip to content

Codex 工作流最佳实践

1. 一套通用节奏

不管你是在 CLI、IDE 扩展还是 App 里工作,都建议保持这套节奏:

  1. 先给上下文
  2. 先让 Codex 说计划
  3. 再进入实现
  4. 最后运行验证并汇报剩余风险

如果你把这四步练熟,Codex 的稳定性会明显提升。

2. 一条最值得复用的 Prompt 模板

text
先阅读 AGENTS.md、相关目录和已有实现。
先不要立刻写代码,请先输出:
1. 当前问题的理解
2. 计划修改哪些文件
3. 准备如何验证
4. 哪些地方可能有回归风险

确认后再开始实现。实现时请保持改动最小,并在结束时汇报:
- 实际修改了什么
- 运行了哪些验证
- 还有什么没有验证

3. 什么时候该用哪种执行模式

模式最适合什么任务
Local改字、补文案、小 bug、小范围重构
Worktree新功能试验、中风险修改、并行对比方案
Cloud耗时长、你不想盯着的后台任务

一个常见误区是:什么都在 Local 里做。
更稳的做法通常是:先在 Worktree 里试,再决定要不要合并回主工作区。

4. 什么时候该拆成 Subagents

当任务天然能拆成不同职责时,就值得并行:

  • 一个代理做实现
  • 一个代理做测试与回归
  • 一个代理做安全和边界条件
  • 一个代理做文档和交付总结

可以直接这样说:

text
请把这个任务拆成并行协作流程:
- 主代理负责整体方案、集成与最终汇报
- 一个 subagent 负责测试与回归检查
- 一个 subagent 负责安全和边界条件审查
- 一个 subagent 负责文档与交付说明
先给出拆分方案,再开始执行。

5. 结束时一定要要回来的 3 项信息

很多人让 Codex 写完就结束,真正容易出问题的地方恰恰在这里。

结束时至少要让它说明:

  1. 改了哪些文件
  2. 跑了哪些验证
  3. 还有什么没验证

这会让你的 review 成本低很多。

6. 跟实战页怎么配合

一个更实用的读法是:

  1. 先在本页学节奏
  2. 再去实战页套场景

官方参考