AGENTS.md 来了：以后仓库不只写 README，还要写给 AI 同事看的说明书

6月18日，GitHub 发布了一条不算轰动却很重要的更新：Copilot Code Review 正式支持 AGENTS.md 文件。只要你在仓库根目录放一个 AGENTS.md，Copilot 在做代码审查时就会自动读取并参考里面的指令，让 review 反馈更贴合项目的实际规范和团队偏好。

消息一出，不少开发者第一反应是：又多一个要维护的文件？README 还不够吗？为什么现在连代码审查都要专门给 AI 写说明书了？

其实这个变化来得并不突然，而是 Agentic AI 深入代码工作流后的必然结果。

以前 Copilot 做代码审查，主要靠模型的通用知识 + 少量上下文。它经常会提出一些“看起来很合理，但完全不符合我们项目风格”的建议：比如在严格使用双引号的项目里推荐单引号，在团队明确禁用某类模式的地方却大力推荐，或者完全忽略你们项目特有的错误处理、日志规范。开发者 review 时还要花时间解释“这个我们项目不这么做”，效率反而降低。

现在有了 AGENTS.md，情况不一样了。它是仓库级别的持久化指令文件，专门用来告诉 Copilot Code Review：“我们项目是怎么回事”“我们对代码有什么硬性要求”“哪些做法是明确的禁忌”。Copilot 在生成 review 时会优先参考这个文件，让反馈从“通用 AI 视角”变成“懂我们项目的 AI 视角”。

这其实是把“给人类看的文档”和“给 AI 看的文档”做了明确分工。

README 继续服务于新加入的开发者、贡献者、用户，讲清楚项目是什么、怎么跑起来、怎么贡献。 而 AGENTS.md 则更像一份“项目灵魂说明书”，专门写给正在审查代码的 AI。它可以包含：

项目核心架构和设计决策

编码规范与偏好（命名、格式、错误处理、测试风格等）

明确的禁忌和“不要这么做”的规则

团队在安全、性能、可维护性上的硬性要求

甚至可以写“当你看到 X 模式时，请优先推荐 Y 方案”

GitHub 同时还做了两个小而实用的 UI 改进：草稿 PR 可以直接点“Request Copilot review”按钮，以及把部分 Copilot review 事件折叠，减少时间线噪音。这些都是在降低使用摩擦，让更多人愿意把 Copilot 真正用在日常 review 流程里。

影响是双面的。

好的方面很明显：AI review 的质量会显著提升，减少无效讨论，让人类 reviewer 把精力集中在真正需要判断的地方。长期看，那些把 AGENTS.md 写得清晰、具体、可执行的团队，会在 AI 辅助开发中明显占优——AI 不再是“会写代码但不懂我们项目”的外人，而是真正被“训练”过的队友。

但代价也真实存在。开发者又多了一项维护任务。AGENTS.md 不是写一次就完事，它需要和代码、规范一起演进。如果写得太笼统、空洞，反而会误导 AI；如果写得太死板，又可能限制模型的创造力。更重要的是，这本质上把“如何与 AI 高效协作”也变成了团队需要显式管理的知识。

我个人判断是：这是必然的演进，而且是好事，但别让它变成新的形式主义。

未来的代码仓库，不再只是给人看的代码 + README，而是要同时对人类和 AI 都“可读”。那些真正厉害的团队，不会把 AGENTS.md 当成额外负担，而是会把它当成“项目架构和价值观的浓缩版”来认真对待。写好它，本质上是在做更高阶的系统设计和知识管理——把隐性的团队共识变成显性的、可被 AI 消费的规则。

短期内，你可能会觉得麻烦；但当你下次看到 Copilot 给出“这个改动符合你们 AGENTS.md 中关于错误处理的规范”的评论时，你就会明白这个文件真正省下的时间和沟通成本。

AI 已经深度参与代码审查了，与其被动接受它偶尔“离谱”的建议，不如主动告诉它“我们是怎么玩的”。 AGENTS.md 就是目前最直接、最低成本的告诉方式。

以后每个认真对待 AI 协作的仓库，可能都会多出一个文件。 不是因为 GitHub 要求，而是因为现实需要。