告别多文件混乱：AI编程工具统一文档 AGENT

现在用 AI 写代码，最烦的不是工具少，是工具太多。

Cursor、Trae、QCode、Copilot、Claude Code 各管各的。每个工具都有自己的规则文件，.cursorrules、CLAUDE.md、.trae/rules……全塞进项目里，看着就乱。

问题是，规则一多，AI 反而不会写了。同一个规范要在好几份文件里改，版本对不上；不同工具读不同规则，Cursor 生成的代码能看，Claude Code 直接跑偏；新人上手也懵，根本不知道该听谁的。

解法其实就一个：只留一份 AGENTS.md，当项目的“机器说明书”。

不过不是所有工具都认它。Cursor、Copilot、Codex、QCode 原生支持；Windsurf、RooCode 也能自动加载。但 Trae 桌面版得手动开个开关，Claude Code 和 Aider、Gemini 还得单独配置才能读取。

写这份文件也有讲究。别把 README 的内容全抄进去，AI 自己推断得出的东西一律不写。重点写固定命令、禁止操作、架构红线——控制在 200 行以内，太长 AI 反而记不住。

我的做法是：根目录放一份公共的 AGENTS.md 提交进 Git，个人习惯另起一份本地的 AGENTS.local.md 加进 .gitignore。其他工具的专属文件只做引用，不再重复写规范。

说白了，以后维护的不是五份规则，就这一份。