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	Google	GEMINI.md	根目录
Qoder	开源社区	.qoder/rules.md	项目目录内
TRAE	字节跳动	自有格式	IDE 内嵌
Kimi Code	月之暗面	自有格式	IDE 内嵌
ZCode	智谱	自有格式	IDE 内嵌
CodeBuddy	腾讯	自有格式	IDE 内嵌
Cline / Roo Code	社区	.clinerules / .roorules	根目录

这场分裂不是能力问题，是权力问题：

同一套规则想同时服务多家工具？路径对照一眼就能看出有多碎：

项目根/
├── 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 的子目录覆盖？做不到——格式不兼容。

TRAE 有规则配置但路径不公开，Kimi Code 和 ZCode 嵌在 IDE 里不和文件系统交互，CodeBuddy 走的也是封闭路线。这不是技术问题——是国内厂商对“标准该由谁定”的天然迟疑。

最让人焦虑的不是分裂，是“不知道会不会一直分裂下去”

团队用的工具越多，这个问题越尖锐。而 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 联合推动

四件事加起来，构成了 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 这一层的产物。

---

四、和你有什么关系

回到那张表——你用的工具在左侧，你项目里的文件在右侧。如果你现在觉得“是该统一了”，说明你和整个行业想到一块去了。

但这里有个容易忽略的细节：

目前 TRAE、Kimi Code、ZCode、CodeBuddy 对 AGENTS.md 的支持程度参差不齐——TRAE 和 Kimi Code 部分支持但路径不透明，ZCode 和 CodeBuddy 还在用自有格式。如果你们团队有国产工具的用户，现阶段需要同时维护 AGENTS.md（给国际工具读）和国产工具的 IDE 内嵌配置（给国产工具读）。

不过方向不会变——

---

下一篇：

你现在项目里同时维护了几种规则文件？评论区聊聊。