Codex 最佳实践 （干货分享，几句提示词搞定OpenAI Codex5.4 满血节流省token）

admin

Codex 最佳实践 （干货分享，几句提示词搞定OpenAI Codex5.4 满血节流省token）

下面这 3 条，基本可以覆盖大部分日常使用场景。

1. 做好上下文管理

Codex 会持续继承当前会话里的上下文。会话越长，历史信息越多，越容易出现两个问题：

• 无关上下文越来越多，浪费 token
• 旧任务的假设残留，干扰新任务判断
  

最简单的做法是：每次任务完成后执行一次 /new，用新会话开始下一个任务。

适合立即开新会话的场景：

• 一个功能已经改完，准备开始另一个功能
• 刚做完排障，接下来要写新代码
• 上一个任务里贴过很多日志、报错、临时方案
• 你已经明显感觉到模型开始“带着旧问题思考”
  

推荐工作流：

• 当前任务完成
• 用一句话总结结果，便于留痕
• 执行 /new
• 在新会话里重新描述新的目标、约束和验收标准
  

如果新任务确实依赖上一个任务的结果，不要直接复用整段历史，优先在新会话里只给必要信息，例如：

刚完成 A 功能重构，相关改动在 xxx 文件。
现在继续做 B：补测试，并修复分页接口的边界条件。
要求不要改动 API 结构。

这样比把整个旧会话拖进来更稳定。

2. 写好 AGENTS.md

AGENTS.md 的作用不是介绍项目背景，而是告诉 Codex 在这个仓库里应该怎样工作。

写得好的 AGENTS.md，重点应该是“可执行约束”，而不是泛泛而谈。

建议至少写清楚下面几类信息：

• 目录结构：核心代码、配置、生成产物、前端目录分别在哪里
• 常用命令：构建、测试、生成代码、启动开发环境分别用什么命令
• 代码规范：命名、格式化、框架约定、接口字段命名约束
• 提交要求：什么改动必须带测试，什么改动必须同步生成产物
• 风险边界：哪些文件不要随便改，哪些配置不能提交，哪些命令有副作用
  

一个实用的 AGENTS.md 应该尽量具体。例如：

## Build & Test

- 使用 `just` 作为主命令入口
- 后端测试：`go test ./...`
- 修改 proto 后必须执行：`just api && just config && just generate`
- 修改 `frontend/dashboard` 后必须执行：
  `cd frontend/dashboard && bun run test && bun lint && bun format`

## Best Practices

- 不要手改生成代码，统一通过生成命令更新
- API 字段变更时，同时更新前端 `src/services`
- 调用 updateMask 时统一使用 `update_mask`

## Safety

- 不要把敏感信息写入 `configs/config.yaml`
- 不要执行破坏性 Git 命令，除非用户明确要求

写 AGENTS.md 时，建议遵循这几个原则：

• 多写“必须做什么”，少写“项目很复杂”
• 多写命令和路径，少写抽象描述
• 多写例外和边界，少写常识
• 保持更新，避免文档和仓库现状脱节
  

如果团队里已经形成固定流程，直接把流程写进去，不要指望模型自己猜。

3. 用 Plan 模式先设计实现计划

复杂任务不要一上来就让 Codex 直接改代码，先进入 Plan 模式把方案设计清楚，通常更稳。

Plan 模式尤其适合这些场景：

• 需求跨多个模块
• 需要改数据库、接口、前端联动
• 涉及代码生成、迁移、发布步骤
• 你还不确定实现路径，想先比较方案
  

一个有效的计划，通常应包含：

• 目标：这次要解决什么问题
• 范围：哪些目录和模块会改，哪些明确不改
• 步骤：按顺序拆成 3 到 7 个可执行步骤
• 验证：每一步完成后怎么确认是对的
• 风险：哪些点最容易出错，如何规避
  

你可以直接这样让 Codex 先出计划：

先不要写代码，进入 Plan 模式。
帮我为这个需求设计实现计划：
1. 明确影响范围
2. 拆分实施步骤
3. 列出风险和验证方式
4. 等我确认后再开始修改

如果需求比较大，再进一步要求它输出更清晰的计划格式：

请用 Plan 模式输出：
- 背景与目标
- 实现方案
- 分步骤执行计划
- 测试与回滚方案
- 待确认问题

推荐流程是：

• 先用 Plan 模式对齐方案
• 你确认范围、顺序和风险
• 再让 Codex 进入实现
• 实现完成后，新开 /new 会话进入下一个任务
  

这样做的好处是，设计、实现、后续任务三段上下文是分开的，稳定性更高，也更省上下文。

一份简单模板

如果你想马上开始，可以直接照这个思路使用：

1. 先写好仓库根目录的 AGENTS.md
2. 复杂需求先让 Codex 用 Plan 模式出实现计划
3. 确认计划后再开始编码
4. 每个任务完成后执行 /new，开启下一轮会话

核心原则只有一句话：把上下文留给当前任务，把规则写进 AGENTS.md，把复杂问题先变成计划。