大家好，我是你的老朋友——一个每天跟代码打交道的伪程序员。最近看到 OpenAI Codex 产品负责人 Derrick Choi ，说他们把之前内部分享的最佳实践正式上线到开发者文档了。
这不就是我一直想要的“Codex 使用说明书”吗？以前用 Codex 经常“随手一问、碰运气”，有时候秒出神代码，有时候改了半天还得我自己擦屁股。干脆花了整整一个晚上，把这篇官方指南从头到尾精读了一遍！
今天这篇微信公众号文章，就是我给自己学知识的真实笔记，边读边想“这个我能怎么用在日常项目里”的心得分享。读完后，我已经迫不及待地在本地 repo 里建了 AGENTS.md 文件，准备明天就开始实践！
走起，一起学～
1. 强力开局：Prompt 别再乱写了！
指南第一部分直接戳中我痛点：Codex 已经够聪明了，但你给它的“任务上下文”决定了结果天差地别。
我以前的 prompt 就是一句“帮我加个登录功能”，结果它经常猜错架构、漏掉安全要求。现在官方教的方法超级实用：每次 prompt 必须包含 4 个元素：
Goal：我要达成什么？（改什么、建什么）
Context：相关文件、文件夹、文档、报错 @ 提出来
Constraints：遵守什么规范、安全要求、团队约定
Done when：什么情况下算完成？（测试通过？行为改变？bug 消失？）
我学到这里，立刻试着用语音输入（Codex App 里直接说话）重写了一个老任务，效果提升明显！
我的小 tips：任务简单就用 Low reasoning，复杂调试就切 Medium/High，超级难的就 Extra High。别死磕打字，用语音 dictation 更快！
2. 复杂任务先“画蓝图”Plan 模式
以前我直接让 Codex 动手，结果经常半路卡壳。现在官方推荐：先让它规划，再写代码！
三种我最爱的玩法：
1. 直接开 /plan 模式（Shift + Tab），它会主动问问题、收集上下文、输出完整计划
2. 让它“面试”我：把模糊想法丢给它，让它疯狂提问，把需求 concretize
3. 用 PLANS.md 模板（高级玩家）
我读到这儿恍然大悟：原来我以前的“失败案例”大多是因为跳过了规划步！明天我就试试在复杂重构里先开 Plan 模式。
3. AGENTS.md —— 我的“AI 队友使用说明书”（重磅推荐！）
这部分让我直接high了！AGENTS.md 就是给 Codex 写的永久 README，它会自动加载到上下文，以后不用每次重复啰嗦。
学到的结构（最最实用部分）：
1. 项目布局 + 重要目录
2. 如何运行、构建、测试、lint 的命令
3. 团队编码规范、PR 要求
4. 禁止事项（do-not rules）
5. “Done” 的定义和验证方式
官方还给了一键初始化命令：`codex /init` —— 直接生成 starter 文件，我已经跑过了！
实践起来：把项目里最常踩的坑全部写进 AGENTS.md 了，以后 Codex 再犯错，我就让它写 retrospective，然后更新文件。循环优化，爽！
4. 配置 Codex，让它“懂你”
指南说：配置不是可选项，是必选项**。
我以前从来没碰过 config.toml，现在知道：
- 个人默认放 `~/.codex/config.toml`
- 项目专属放 `.codex/config.toml`
- 里边可以设模型、reasoning level、sandbox 权限、MCP、profiles……
我读完立刻打开设置，把 sandbox 权限收紧（新手别乱给全权限！），还让 Codex 帮我改了默认 reasoning 为 Medium。以后跨设备都一致，舒服！
5. 别只生成代码，还要它“自测 + 自审”
最打动我的一句话：Codex 不只是代码生成器，它还能帮你测试、运行检查、review diff。
现在我会要求它：
- 写测试
- 跑对应 test suite
- 检查 lint/format/type
- 用 /review 命令做 PR 式审查
我已经在 AGENTS.md 里加了“code_review.md”引用，团队以后 review 风格统一了！
6. MCP：让 Codex 连外部系统（神器！）
以前我老是复制粘贴 Jira ticket、数据库数据。现在用 Model Context Protocol (MCP)**，Codex 可以直接调用外部工具！
官方说：只加真正能省重复劳动的工具就够。我计划先接一个“自动拉最新 PR 评论”的 MCP，省得我每次手动贴。
7. 把重复劳动变成 Skill
重复 3 次以上？直接打包成 Skill！
SKILL.md 文件 + 清晰描述 + 输入输出，Codex 以后一句话就能调用。
官方给的 starter：`$skill-creator` 和 `$skill-installer` 技能，超级贴心。我已经想好第一个 Skill：自动生成周报！
8. Automations：让 Codex 自己跑定时任务
工作流稳定后，直接在 Codex App 里建 Automation：
- 每天总结 commit
- 扫描潜在 bug
- 自动起草 release notes
技能定义方法，自动化定义时间表——绝配！
9. 会话管理 & 常见坑
最后学到：用 /fork、/compact、/resume 管理长线程；多代理并行处理子任务。
避坑清单我直接截图保存了（尤其是“别在同一文件上跑 live thread，用 git worktree！”）。
学习总结 & 下一步行动计划
读完这篇官方指南，我最大的感触是：Codex 不是工具，是可以一起进化的队友。把 AGENTS.md、Skill、Automation 用起来，真的能让开发效率提升 20-30%（官方隐含数据 + 我自己的预感）。
开始行动：
1. 今天就建好 AGENTS.md
2. 这周试一个 Skill + 一个 Automation
3. 下周在团队里推广
你还在等什么？
官方指南直达链接：
https://developers.openai.com/codex/learn/best-practices
读完记得回来评论区告诉我：你最想先试哪一条？
我也会持续更新我的实践心得，咱们一起把 Codex 玩出花！
点赞 + 在看 + 转发，就是对我最大的鼓励～
（本文为个人学习笔记整理，所有内容基于 OpenAI 官方文档。如有更新，以官网为准）
