过去三年，换一个 AI 编程工具，往往要重写一遍"项目须知"：Cursor 配一套提示词，Copilot 贴一段评审要求，接手新项目还得先读两小时 README。规则被锁死在工具里，迁移成本本身就是护城河。
9 月 19 日，Claude Code 团队在 2.1.277 版本中做了一件看起来很小、但方向很关键的事：它现在会先去项目根目录找一份叫 AGENTS.md 的文件，把它当作智能体的共享规则层。
从工具私有配置到跨工具公约
CLAUDE.md 一直是 Claude Code 的专属配置，里面写着工作流、MCP 服务、子智能体和命令。问题在于它只对一家工具生效，换工具就作废。
AGENTS.md 不一样——它不绑定任何模型或厂商。只要在仓库根目录放一份，无论是 Claude Code、Codex 还是其他编码智能体，都能读同一份规则、照同样的约定执行。覆盖的内容也一致：工作流、MCP、子智能体、命令四类。
这件事的意义不在"少写几个字"，而在把"怎么跟 AI 协作"这层配置从工具私有物，变成了项目资产。规则跟着代码仓库走，而不是跟着某个 IDE 走。对多人协作和长期维护的项目尤其明显：新人拉下代码，智能体就知道该遵守什么约定，不用再口头交代一遍。
一份文件撑不起治理
不过，把规则搬进仓库只是第一步，接下来会遇到三个现实问题。
一是规则冲突。项目里同时有 AGENTS.md、.cursorrules、CLAUDE.md，甚至团队 wiki 里还有一份约定，内容一旦不一致，模型该听谁的？目前各家工具的处理顺序并不统一，要么靠优先级约定，要么靠人手动清理旧文件。标准化的价值恰恰在这里：有人先做统一，混乱才会收敛。
二是上下文预算。规则文件越长，占掉的上下文越多。一份 5000 字的"项目须知"塞进去，模型能用来读代码的空间就被压缩了。所以真正有效的规则文件通常很短——写清楚构建命令、测试怎么跑、哪些目录别碰、提交信息格式，而不是把整个开发手册复制一遍。
三是可执行性。写在 Markdown 里的约定，本质是"建议"，不是"约束"。模型可能遵守，也可能忽略。要让规则真的生效，还得配合可以自动跑的检查——lint、类型检查、CI 里的测试。规则文件负责"告诉它该怎么做"，自动化检查负责"发现它没这么做"。两者缺一，规范就只是文档。
为什么是现在
智能体编程的战场正在往下沉。当"让 AI 改一行代码"已经不是门槛，竞争就转向"怎么让 AI 稳定地按团队规矩办事"。规则文件标准化，是这条链路上的基础设施——它让智能体的行为可被版本管理、可被 review、可被继承。
Anthropic 工程师 Thariq Shihipar 在 X 平台公开宣布了这一变化。从社区反应看，开发者最买账的不是功能本身，而是"终于不用为每个工具维护一份平行配置文件"这件事。
一点判断
AGENTS.md 未必会成为唯一标准，但它指出的方向很清楚：智能体的协作约定应该像 README、.gitignore 一样，成为仓库的一等公民。当规则能被第三方框架和任意模型读取，工具的切换成本就被摊薄了——对开发者是好事，对把规则锁进私有格式的工具则是一次松绑。