AGENTS.md 与代码智能体：开发者的新工具

从自动补全到智能体

短短几年，编码辅助的性质发生了变化：从逐行建议，走向能够读完整个代码库、运行测试、开一个 pull request 的智能体。问题不再是「生成代码」，而是给智能体正确的上下文——构建命令、约定、架构。

AGENTS.md：一个用 Markdown 写的开放标准

这正是 AGENTS.md 所解决的：项目根部一个简单的 Markdown 文件，向任何智能体说明在这里如何工作——构建与测试命令、代码风格、框架、架构决策。没有强加的模式，没有要安装的工具：任何读到它的智能体都能立刻受益。

该格式于 2025 年 8 月正式确立，随后于 2025 年 12 月捐赠给 Linux Foundation 旗下的 Agentic AI Foundation。到 2025 年底，已有 6 万多个开源项目采用，二十多种工具支持它——GitHub Copilot（自 2025 年 8 月起原生支持）、OpenAI Codex、Cursor、Gemini 与 Jules、Windsurf、Zed，等等。时代的信号：Next.js 16.2 现在会在 create-next-app 里生成一个 AGENTS.md。

为什么它不只是一阵风

没有上下文的智能体，每次都要重新发现项目：猜命令、无视你的约定、产出需要返工的代码。一份写得好的 AGENTS.md 能消除这个发现阶段：生成的代码从一开始就遵循你的标准，评审的来回往返随之减少。

说到底，这与一份好的入职文档是同一个想法——只不过这里的新人，是一台读得快、什么都不忘的机器。

我的立场

我常说：AI 是我的工具之一，而非我的根基。一个装备精良的智能体能加速研究、原型和机械性的工作。但写 AGENTS.md 的、决定架构的、评审并确认的，是开发者。工具不能替代判断：它放大判断。

智能体有多好，取决于你给它多少上下文。AGENTS.md 就是这份上下文，与代码一同纳入版本管理。