36 · 最佳实践：那些“正确的废话”之外，真正能落地的几条

最佳实践不是口号。 如果一句话不能指导你下一步怎么做，它就没用。

这一篇只保留能落地的做法。

先用这 5 条判断今天有没有跑偏

每次用 Codex 做项目，先看这 5 条：

1. 任务有没有一句话说清楚？
2. 范围有没有限制住？
3. 改完有没有检查？
4. 结果有没有截图或链接？
5. 不懂的地方有没有记录下来？

这 5 条做到，进步会很快。

第一次练习：连续 7 天只练一件事

不要一次背完所有最佳实践。 接下来 7 天，每次让 Codex 做事前，都先填这张小卡片：

今天要完成：
允许修改：
不允许修改：
完成后检查：

第一步，只写一个结果，例如“修好首页手机端文字重叠”。

第二步，明确允许它碰哪些文件；不知道文件名，就写“先检查并告诉我，不要直接修改”。

第三步，写出你能看懂的验收方式，例如“打开手机预览，标题和按钮不重叠”。

第四步，任务结束后问自己：

1. Codex 有没有改到范围外？
2. 它有没有真的检查结果？
3. 我能不能用一句话说清这次完成了什么？

连续做 7 次，你会比背 20 条原则更快形成习惯。

01 先换个心态：Codex 是你要调教的队友，不是一次性工具

不要把 Codex 当一次性问答工具。

你要持续训练它理解：

1. 你的项目是什么。
2. 你的读者是谁。
3. 你的写作标准是什么。
4. 你的安全边界是什么。

02 把 AGENTS.md 写到位：让它自动“带着上下文”干活

项目长期规则写进 AGENTS.md。

最低要包含：

• 项目目标。
• 常用命令。
• 写作风格。
• 修改边界。
• 验证方式。

03 提示别靠灵感：目标 + 上下文 + 约束 + 验收，四件套填空

模板：

目标：
上下文：
约束：
验收：

每次任务都填。 别靠临场发挥。

04 复杂活儿先出计划，再动手

复杂任务先让 Codex 说计划。

开始修改前，请先给我计划。
包括要改哪些文件、为什么改、怎么验证。
我确认后再动手。

05 权限分档：默认从严，按场景逐步放宽

最稳顺序：

1. 只读。
2. 小范围写入。
3. 运行检查。
4. 安装依赖。
5. 部署或外部操作。

不要一步到最高权限。

06 让它自验证：测、查、审，别只让它“写完”

任务最后加：

完成后请运行能证明结果的最小检查。
如果无法运行，请告诉我原因和手动检查方式。

没有验证，就不算完成。

07 线上任务先拿证据链，再谈修复

线上问题不要急着改。

先拿证据：

1. 错误截图。
2. 日志。
3. 复现步骤。
4. 最近改动。
5. 回滚方案。

08 重活拆给子代理，一条线程只干一件事

复杂任务可以拆。 但每条线只干一件事。

比如：

• 文章可读性检查。
• 安全风险检查。
• 构建错误排查。

默认先只读检查。

09 上手清单：踩坑 / 正确做法 对照表

踩坑	正确做法
“帮我优化一下”	写清目标、范围、验收
不看 diff	每次都看改动
直接给高权限	默认只读，小步放开
不跑检查	让它自验证
把密钥发给 AI	用占位符和环境变量
一次改太多	一个任务一个目标

10 小结

真正能落地的最佳实践只有一句：

让 Codex 做事前说清楚，做事中看得见，做事后能验证。