Skip to main content
vibecoding.app

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

Zane
6 min read
🇺🇸English version
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 编程工具都能用，这是最核心的价值。

和工具专属文件对比

特性 AGENTS.md CLAUDE.md .cursorrules copilot-instructions.md
跨工具支持 所有主流 Agent 仅 Claude Code 仅 Cursor 仅 Copilot
格式 Markdown Markdown Markdown Markdown
Monorepo 嵌套（就近） 嵌套 单根文件 单文件
治理方 Linux 基金会 Anthropic Cursor GitHub
价格 免费 免费 免费 免费
生态 6 万 + 仓库 Claude Code 用户 Cursor 用户 Copilot 用户

格式都是 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 完整指南。

返回中文博客