最佳实践 / 🛠️ 工程 / 开发
📋

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

AGENTS.md — Open Format for Guiding AI Coding Agents (Official Spec)

👤 OpenAI 发起(OpenAI Codex/Amp/Google Jules/Cursor/Factory 联合制定),现由 Linux 基金会旗下 Agentic AI Foundation 托管 📍 GitHub 开源社区 📅 2025 🎞️ Agent 技能 / 工程提示词

「60k+ 开源项目采用、Linux 基金会托管的 AI 编码代理指引文件事实标准,从极简模板到 monorepo 嵌套工序一站给全」

工具链

OpenAI Codex Cursor GitHub Copilot coding agent Google Jules Gemini CLI Aider Amp Factory Devin Windsurf Zed VS Code goose opencode Warp RooCode Junie (JetBrains) Augment Code Kilo Code Phoenix Ona Semgrep UiPath

案例概述

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 配置全部给出可操作命令
🔒

完整工序提示词仅管理员可见

本页为案例简介。完整的逐步提示词、逐镜拆解与可执行工序需管理员账号查看。

管理员登录查看完整内容

原作 / 参考链接

← 返回最佳实践