---
title: "短而准的 AGENTS.md 胜过长篇政策"
summary: "只写 agent 会重复踩的坑。把规划模板、审查清单、架构说明拆成被引用的独立文件。"
category: agents-md
level: starter
surfaces: [cli, app, ide]
tags: ["简洁", "引用", "维护"]
canonical: /tips/keep-agents-md-short/
---

# 短而准的 AGENTS.md 胜过长篇政策

只写 agent 会重复踩的坑。把规划模板、审查清单、架构说明拆成被引用的独立文件。

主文件保持「命令 + 边界 + 完成定义」。容易膨胀的内容外置：

- `docs/code_review.md`：审查清单
- `docs/PLAN_TEMPLATE.md`：长任务规划格式
- `docs/architecture.md`：系统设计

然后在 `AGENTS.md` 里写：「审查时遵循 `docs/code_review.md`」。

官方建议：发现同样的错误出现第二次，再加规则。预防性长文很少被遵守。

## 来源

- [OpenAI · Best practices](https://developers.openai.com/codex/learn/best-practices)