目录
- 一、AI 编程上下文分裂:十余工具各搞一套规则文件
- 能力不对齐才是最麻烦的
- 二、AGENTS.md 凭什么结束了这场架
- 三、AGENTS.md 只是水面上的冰山
- 四、和你有什么关系
你给 AI 写了那么多规矩文件——CLAUDE.md、.cursorrules、AGENTS.md……有没有想过:为什么"给 AI 一段项目说明"这么简单的需求,需要一整年才找到一个跨工具的答案?
一年半的分歧在 2025 年 12 月正式结束。AGENTS.md 被 OpenAI、Google、Microsoft、Anthropic 同时捐进 Linux 基金会,AI 编程的上下文格式之争画上句号。现在不是"选哪家",是"你的项目什么时候跟上"。
| 章节 | 核心问题 | 一句话结论 |
|---|---|---|
| 分歧 | 十余工具为何各搞一套 | 方向一致,格式分裂是权力之争 |
| 收敛 | AGENTS.md 凭什么收场 | 联盟发布 + 2025.12 捐进 AAIF |
| 全景 | 还有哪些标准在并行 | 项目 / 网站 / 连接 / 兜底四层基础 |
| 行动 | 和你项目的关系 | 先建 AGENTS.md,国产工具过渡期双维护 |
一、AI 编程上下文分裂:十余工具各搞一套规则文件
十余个工具,无一例外都做了"规则文件进仓库"。但格式、路径、能力边界全不互通:
| 工具 | 厂商 | 入口 | 路径 |
|---|---|---|---|
| Claude Code | Anthropic | CLAUDE.md | 项目根目录 |
| Cursor | Anysphere | .cursorrules→.cursor/rules/*.mdc | 根目录 + 子目录 |
| GitHub Copilot | Microsoft | copilot-instructions.md | .github/下 |
| Windsurf | Codeium | .windsurfrules | 根目录 |
| Gemini CLI | GEMINI.md | 根目录 | |
| Qoder | 开源社区 | .qoder/rules.md | 项目目录内 |
| TRAE / Kimi Code / ZCode / CodeBuddy | 国产 | 自有格式 | IDE 内嵌 |
方向完全一致——所有工具都认为"AI 该知道项目约定",但没有任何两个工具用同一个文件。
这场分裂不是能力问题,是权力问题:谁的文件成为标准,谁就握住了 AI 编程的"默认上下文入口"。
同一套规则想同时服务多家工具?路径对照一眼就能看出来有多碎:
项目根/ ├── AGENTS.md # 跨工具最小公约数(2025 起) ├── CLAUDE.md # Claude Code 专属 ├── GEMINI.md # Gemini CLI 专属 ├── .cursor/rules/*.mdc # Cursor 专属(支持 glob 触发) ├── .github/copilot-instructions.md ├── .windsurfrules / .clinerules / .roorules … └── (国产 IDE 内嵌配置,路径不公开)能力不对齐才是最麻烦的
| 能力 | CLAUDE.md | .cursor/rules/*.mdc | GEMINI.md | Qoder | 国产工具 |
|---|---|---|---|---|---|
| 全量加载 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 子目录覆盖 | ✅ | ❌ | ❌ | ❌ | ❌ |
| glob 按需触发 | ❌ | ✅ | ❌ | ❌ | 部分 |
| 前端元数据 | ❌ | ✅(frontmatter) | ✅(TOML 命令) | ❌ | 不公开 |
| 跨工具共享 | ❌ | ❌ | ❌ | ❌ | ❌ |
同一套规则想同时服务 Cursor 的 glob 触发和 Claude Code 的子目录覆盖?做不到——格式不兼容。
而且国产工具跟进了这件事,却几乎不参与国际标准的讨论。这不是技术问题——是国内厂商对"标准该由谁定"的天然迟疑。
如果标准继续碎片化,"给 AI 写规则"这件事永远只能靠人力手动同步——一个不该有技术含量的问题,被制度拖成了痛点。
二、AGENTS.md 凭什么结束了这场架
2025 年 8 月 OpenAI 发布AGENTS.md,看起来只是一个 Markdown 文件。但三个动作让它和之前所有尝试都不一样:
| 动作 | 威力 |
|---|---|
| 不是独家发布,是联盟发布 | 共建方:Codex + Cursor + Google Jules + Factory |
| 不取代任何工具规则,而是做最小公约数 | 只定义"项目是什么"——技术栈、构建指令、禁止事项 |
| 四个月后捐进 Linux 基金会 / AAIF | Google、Microsoft、OpenAI、Anthropic 坐在同一张桌上当白金会员 |
AGENTS.md刻意只做最小公约数,长这样就够了:
# AGENTS.md ## 技术栈 TypeScript + React + Vite ## 构建与测试 - 安装:pnpm install - 开发:pnpm dev - 测试:pnpm test ## 禁止事项 - 不要手写数据库迁移,表结构由 ORM 自动同步 - 不要改 .env,环境变量走 CI 注入四家最大的 AI 厂商坐在同一个基金会的同一张桌子上,管着同一套标准。分歧结束,接下来是工程问题。
三、AGENTS.md 只是水面上的冰山
如果把视角从"项目里怎么写规则"拉高到整个 AI 工程生态,会发现同一时间线上还有三件事在并行收敛:
| 标准 / 项目 | 做什么 | 状态 |
|---|---|---|
| AGENTS.md | AI 怎么理解项目 | 60,000+ 项目采用,AAIF 托管 |
| llms.txt | 网站给 AI 的入口文件 | B2B SaaS Top 1000 中 12% 采用,Anthropic 官方推荐 |
| MCP | AI 怎么连外部系统 | 10,000+ server,AAIF 托管,主流工具全支持 |
| Harness Engineering | AI 运行时怎么不出错、出了错怎么纠正 | Anthropic + OpenAI 2026 联合推动 |
逻辑线:AGENTS.md 管"项目是什么",llms.txt 管"网站有什么",MCP 管"AI 能连什么",Harness Engineering 管"系统怎么兜底"。四件事加起来,构成了 AI Agent 运行环境的完整基础层。
Anthropic 和 OpenAI 把这条路线总结成三层范式:
| 阶段 | 时间 | 核心问题 |
|---|---|---|
| Prompt Engineering | 2022—2024 | 怎么跟 AI 说话 |
| Context Engineering | 2024—2025 | 给 AI 看什么信息——AGENTS.md、llms.txt、MCP 全落在这一层 |
| Harness Engineering | 2026— | 构建什么系统让 AI 可靠工作 |
我们刚才聊的所有东西——规则文件、跨工具标准、网站入口、协议——本质都是 Context Engineering 这一层的产物。
四、和你有什么关系
回到那张表——你用的工具在左侧,你项目里的文件在右侧。如果你现在觉得"是该统一了",说明你和整个行业想到一块去了。
但这里有个容易忽略的细节:国内工具跟进 AGENTS.md 的速度。
目前 TRAE、Kimi Code、ZCode、CodeBuddy 对 AGENTS.md 的支持程度参差不齐——TRAE 和 Kimi Code 部分支持但路径不透明,ZCode 和 CodeBuddy 还在用自有格式。如果你们团队有国产工具的用户,现阶段需要同时维护AGENTS.md(给国际工具读)和国产工具的 IDE 内嵌配置(给国产工具读)。
不过方向不会变——AGENTS.md 已经是 Linux 基金会项目,国内厂商跟进只是时间问题,不是方向问题。
分歧结束了。现在不是"选哪家",是你的项目什么时候把这个目录建起来。
下一篇:.ai/目录怎么建——入口路由、目录骨架、第一条提示语。
你现在项目里同时维护了几种规则文件?评论区聊聊。