AGENTS.md 开放规范——给 AI 编码代理的 README

工具链

案例概述

AGENTS.md 是给 AI 编码代理的"README"开放格式,由 OpenAI Codex、Amp、Google Jules、Cursor、Factory 联合发起,现由 Linux 基金会旗下 Agentic AI Foundation 托管,官网称已被 6 万+ 开源项目采用、23 个主流编码代理原生支持。本次收录官网全部正文(Why/四步使用工序/完整官方样例/8 条 FAQ 含冲突裁决规则与 Aider、Gemini CLI 配置/生态列表),加上规范仓库自用 AGENTS.md,以及官方精选的 openai/codex 与 apache/airflow 两份生产级范例全文。纯 Markdown 无必填字段,可直接套用为任意项目的代理指引模板。

为什么它是顶尖

• ✦事实标准:官网实证 60k+ 开源项目采用、23 个主流编码代理(Codex/Cursor/Copilot/Gemini CLI/Devin/Windsurf 等)原生读取,是 agent 指引文件领域的通用格式
• ✦出身权威且许可干净:OpenAI/Google/Cursor/Factory/Amp 联合制定,Linux 基金会 Agentic AI Foundation 中立托管,MIT 许可零障碍复用
• ✦拿来即用的完整梯度:从首屏极简模板、官方标准样例、规范库自用 dogfooding 版,到 openai/codex(20.9KB)与 apache/airflow(30.8KB)两份生产级真实范例全文,覆盖起步到大型 monorepo(嵌套 AGENTS.md,OpenAI 主仓 88 个)的写法
• ✦规则清晰可执行:冲突裁决(最近文件优先/用户对话指令最高)、列出的测试命令代理会自动执行并修复、AGENT.md 迁移 symlink 与 Aider/.gemini 配置全部给出可操作命令

原作 / 参考链接

• AGENTS.md 官方站点
• 官方仓库 agentsmd/agents.md
• LICENSE(MIT)
• 真实范例:openai/codex AGENTS.md
• 真实范例:apache/airflow AGENTS.md
• 60k+ 项目范例检索