Appearance
17 · 最佳实践七条法则
📚 系列导航：上一篇 16 Capstone 综合实战 带你走了一趟完整工程流。这一篇不教新功能，教「怎么用得好」。
法则一：把 Codex 当队友，不是一次性工具
用 Codex 的效果，一大半取决于你把它当什么。把它当持续调教的队友——给 AGENTS.md、告诉它怎么跑怎么测、踩错了纠正它一次让它记住。调教得越久，它越顺手。
法则二：AGENTS.md 写到位
持久的规矩写进 AGENTS.md，一次性的需求写进提示。 AGENTS.md 短而准，胜过长而虚。每行自问「删了它 Codex 会犯错吗？」不会就删。
TIP
当 Codex 同一个错误犯了第二次，就让它做个复盘、把教训补进 AGENTS.md。
法则三：四件套填空
目标 + 上下文 + 约束 + 验收，四件套照着填。尤其别漏验收——不给标准，它凭「看着对」就收工。
法则四：先出计划再动手
越复杂越模糊的活儿，越要先 /plan 出计划、确认方向，再让它动手。返工一段代码比改几行计划贵得多。
法则五：权限默认从严
新手就用默认权限起步。等你摸清了某个工作流、确实需要更顺手了，再针对可信场景放宽，而不是一把全开。
法则六：让它自验证
让 Codex 把写测试、跑测试、跑 lint、审 diff 一起干了再交付。前提是用提示或 AGENTS.md 告诉它「好」的标准。
法则七：一条线程只干一件事
一个任务一条线程，完成任务就归档。有边界的杂活甩给子代理，别让主线程的上下文越堆越肥。
踩坑对照表
| ❌ 踩坑 | ✅ 正确做法 |
|---|---|
| 把持久规则塞进提示里 | 持久规则搬进 AGENTS.md |
| 没告诉它构建/测试命令 | 在 AGENTS.md 里写清 |
| 复杂任务跳过规划直接写 | 先 /plan 出计划 |
| 还没摸清工作流就给满权限 | 默认从严，逐步放宽 |
| 一个项目一条万能线程 | 一个任务一条线程 |
| 本地测试通过就宣布完成 | 从原用户路径复查 |
NOTE
下一篇：18 速查表：安装、快捷键、命令、配置全量速查。