AI 编程的上下文，为什么都在往仓库里跑——从碎片到收敛的生态全景
你先别急着写下一份CLAUDE.md、.cursorrules或AGENTS.md。停下来想一想：为什么“给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 | 字节跳动 | 自有格式 | IDE 内嵌 |
Kimi Code | 月之暗面 | 自有格式 | IDE 内嵌 |
ZCode | 智谱 | 自有格式 | IDE 内嵌 |
CodeBuddy | 腾讯 | 自有格式 | IDE 内嵌 |
| Cline / Roo Code | 社区 | .clinerules / .roorules | 根目录 |
方向完全一致——所有工具都认为“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 的子目录覆盖？做不到——格式不兼容。
而且国产工具跟进了这件事，却几乎不参与国际标准的讨论。
最让人焦虑的不是分裂，是“不知道会不会一直分裂下去”
团队用的工具越多，这个问题越尖锐。而 2024—2025 年恰恰是工具爆发期——Copilot 免费了、Cursor 出圈了、Claude Code 杀进来了、TRAE 和 Kimi Code 也在抢开发者。
二、AGENTS.md 凭什么结束了这场架
2025 年 8 月 OpenAI 发布 AGENTS.md，看起来只是一个 Markdown 文件。但三个动作让它和之前所有尝试都不一样：
| 动作 | 威力 |
|---|---|
不是独家发布，是联盟发布 | 共建方：Codex + Cursor + Google Jules + Factory。不是“用我的”，是“我们一起定了” |
不取代任何工具规则，而是做最小公约数 | 只定义“项目是什么”——技术栈、构建指令、禁止事项。专属行为留给 CLAUDE.md 等文件 |
四个月后捐进 Linux 基金会 / AAIF | Google、Microsoft、OpenAI、Anthropic 坐在同一张桌上当白金会员 |
AGENTS.md 刻意只做最小公约数，长这样就够了：
# AGENTS.md
## 技术栈
TypeScript + React + Vite
## 构建与测试
- 安装：pnpm install
- 开发：pnpm dev
- 测试：pnpm test
## 禁止事项
- 不要手写数据库迁移，表结构由 ORM 自动同步
- 不要改 .env，环境变量走 CI 注入
第三条是最关键的信号。AAIF 白金会员名单能说明一切：
三、AGENTS.md 只是水面上的冰山
如果把视角从“项目里怎么写规则”拉高到整个 AI 工程生态，会发现同一时间线上还有三件事在并行收敛：
| 标准 / 项目 | 做什么 | 状态 |
|---|---|---|
AGENTS.md | AI 怎么理解项目 | 60,000+ 项目采用，AAIF 托管 |
llms.txt | 网站给 AI 的入口文件 | B2B SaaS Top 1000 中 12% 采用，Anthropic 官方推荐 |
MCP | AI 怎么连外部系统 | 10,000+ server，AAIF 托管，Claude / Cursor / Copilot / Gemini / ChatGPT 全支持 |
Harness Engineering | AI 运行时怎么不出错、出了错怎么纠正 | Anthropic + OpenAI 2026 联合推动 |
逻辑线：AGENTS.md 管“项目是什么”，llms.txt 管“网站有什么”，MCP 管“AI 能连什么”，Harness Engineering 管“系统怎么兜底”。
Anthropic 和 OpenAI 把这条路线总结成三层范式：
| 阶段 | 时间 | 核心问题 |
|---|---|---|
| Prompt Engineering | 2022—2024 | 怎么跟 AI 说话 |
| Context Engineering | 2024—2025 | 给 AI 看什么信息 |
| Harness Engineering | 2026— | 构建什么系统让 AI 可靠工作 |
我们刚才聊的所有东西——规则文件、跨工具标准、网站入口、协议——本质都是 Context Engineering 这一层的产物。
“给 AI 看什么信息”已经从个人手艺变成了有标准答案的工程命题。
四、和你有什么关系
回到那张表——你用的工具在左侧，你项目里的文件在右侧。如果你现在觉得“是该统一了”，说明你和整个行业想到一块去了。
但这里有个容易忽略的细节：
国内工具跟进 AGENTS.md 的速度。
目前 TRAE、Kimi Code、ZCode、CodeBuddy 对 AGENTS.md 的支持程度参差不齐——TRAE 和 Kimi Code 部分支持但路径不透明，ZCode 和 CodeBuddy 还在用自有格式。如果你们团队有国产工具的用户，现阶段需要同时维护 AGENTS.md（给国际工具读）和国产工具的 IDE 内嵌配置（给国产工具读）。
不过方向不会变——
AGENTS.md 已经是 Linux 基金会项目，国内厂商跟进只是时间问题，不是方向问题。
下一篇：
.ai/ 目录怎么建——入口路由、目录骨架、第一条提示语。
你现在项目里同时维护了几种规则文件？评论区聊聊。
