Codex 工作流最佳实践
1. 一套通用节奏
不管你是在 CLI、IDE 扩展还是 App 里工作,都建议保持这套节奏:
- 先给上下文
- 先让 Codex 说计划
- 再进入实现
- 最后运行验证并汇报剩余风险

如果你把这四步练熟,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 写完就结束,真正容易出问题的地方恰恰在这里。
结束时至少要让它说明:
- 改了哪些文件
- 跑了哪些验证
- 还有什么没验证
这会让你的 review 成本低很多。
6. 跟实战页怎么配合
- 用 Codex 完成常见开发任务 更偏任务场景
- 本页更偏协作节奏和工程方法
一个更实用的读法是:
- 先在本页学节奏
- 再去实战页套场景