AGENTS.md 标准评测：AI 编程代理的开放配置标准

如果你做过一段时间 vibe coding，应该遇到过这种事：AI 干了一件「读懂项目就不会这么做」的蠢事。跑错了测试命令、用了已废弃的 API、写出和代码库风格不一致的代码。AGENTS.md 就是解决这个的开放标准。本文给一份独立评测，看它到底值不值得加进你的项目。

AGENTS.md 是什么

AGENTS.md 是放在仓库根目录的纯 markdown 文件，告诉 AI 编程代理项目的关键上下文：怎么构建、怎么跑测试、用什么代码风格、哪些模式要避开。

你的 README.md 是写给人看的，AGENTS.md 是写给 AI 看的。

这个标准目前由 Linux 基金会下的 Agentic AI Foundation 托管，相比工具专属格式多了机构背书。GitHub 上已经有超过 6 万个仓库采用，包括 OpenAI、Apache Airflow、Temporal 等知名项目。

不用装工具、不用订阅、不用 CLI。建一个文件叫 AGENTS.md，写好 markdown，提交。结束。

一份合格的 AGENTS.md 长啥样

# AGENTS.md

## 构建与运行
- 安装：`pnpm install`
- 开发：`pnpm dev`
- 构建：`pnpm build`
- Lint：`pnpm lint`

## 测试
- 全部测试：`pnpm test`
- 单个测试：`pnpm test -- path/to/test.ts`
- 提交改动前要跑相关测试

## 代码风格
- TypeScript 严格模式，禁止 any
- 用具名导出，禁止默认导出
- React 组件：函数组件 + Hooks
- 文件命名：kebab-case；组件：PascalCase

## 项目结构
- /src/app：Next.js 页面（App Router）
- /src/components：共享 React 组件
- /src/lib：工具函数和数据
- /content：markdown 内容

## 边界
- 不要随意改 package.json 依赖
- 不要删测试文件
- 提交前必须 lint

Monorepo 可以在子目录再放一份，Agent 会用离当前代码最近的那一份。OpenAI 内部 monorepo 据说用了 88 份 AGENTS.md。

哪些 Agent 支持

• Claude Code：原生支持，和自己的 CLAUDE.md 并存
• OpenAI Codex：原生支持，自动读取
• Google Jules：原生支持
• GitHub Copilot（VS Code）：作为工作区上下文读取
• Cursor：原生支持，与 .cursorrules 并存
• Aider：通过 .aider.conf.yml 里 read: AGENTS.md 启用
• Amp、Factory、CodeRabbit：原生支持
• 国内工具：通义灵码、字节 TRAE 也在逐步跟进

跨平台覆盖很广。你写一份 AGENTS.md，市面上几乎每个主流 AI 编程工具都能用，这是最核心的价值。

和工具专属文件对比

格式都是 markdown，内容基本通用。差异在覆盖范围，AGENTS.md 是唯一为「全场景通吃」设计的。

多工具团队的实用做法是把主配置写在 AGENTS.md，再用软链接接到工具专属文件名：

ln -s AGENTS.md CLAUDE.md
ln -s AGENTS.md .cursorrules

谁应该用

多工具团队：成员有的用 Claude Code、有的用 Cursor，一份 AGENTS.md 大家共享。

开源维护者：贡献者会用各种 AI 工具，一份 AGENTS.md 让所有人的 Agent 都理解项目约定。

做正经项目的 vibe coder：给 Agent 加项目上下文是最高杠杆的单一动作，AGENTS.md 是最简单的实现方式。

单工具的个人开发者：以后换工具或加第二个工具时，配置自动迁移。零成本，没有理由不写。

不足之处

老实说几个槽点：

• 没有 schema 或校验：任何叫 AGENTS.md 的 markdown 都算数，质量全靠作者
• 效果取决于写法：研究显示人工写的好 AGENTS.md 能小幅提升任务成功率，但让 AI 自动生成的反而可能拖累表现，建议自己写
• 会占 token：每次请求都要算进上下文，文件太大会增加成本
• 还在演进：最佳实践还在摸索，GitHub Copilot 团队分析过 2500+ 份样本，质量差异巨大

结论

AGENTS.md 解决的是真实问题。在它出现之前，多工具团队要维护多份重复配置。现在有了 Linux 基金会背书的统一开放标准，主流 Agent 全支持，几万项目在用。

免费。写一份认真的 30 分钟。Claude Code、Codex、Jules、Cursor、Copilot 都能用。如果你在用 AI 编程工具做任何认真的事，没有理由不加一份。

唯一的注意点：自己写，不要让 AI 自动生成。AGENTS.md 的价值在于编码你的项目知识，那些对你显而易见、但对 Agent 完全隐形的东西。

写法细节看 AGENTS.md 完整指南。