OpenAI 联合多家公司推出 AGENTS.md,开放且供应商中立的编程 Agent 指导文件标准
由 OpenAI Codex、Amp、Google Jules、Cursor、RooCode 和 Factory 组成的 AGENTS.md 工作组宣布,正式推出一个名为 AGENTS.md 的单一、开放且供应商中立的标准,旨在指导编码 Agent 在代码库中的工作方式。
https://github.com/openai/agents.md
https://agents.md/
AGENTS.md 被定位为 “为 Agent 设计的 README”,是一个简单、开放的格式,用于向编码 Agent 提供指导。其设计初衷是为了补充专为人类开发者设计的 README.md 文件。README.md 通常包含快速入门、项目描述和贡献指南,而 AGENTS.md 则专注于提供编码 Agent 所需的额外、详细的上下文信息,例如构建步骤、测试指令、项目结构、代码约定和安全注意事项等。
AGENTS.md 作为面向 AI 编程 Agent 提供项目上下文和操作指令的开放格式,它通过结构化的方式详细指导 AI 代理如何进行开发环境设置、执行代码测试以及遵循拉取请求(PR)的提交规范,例如使用特定命令导航、安装依赖、运行各种测试以及格式化 PR 标题等。
# AGENTS.md
## Setup commands
- Install deps: `pnpm install`
- Start dev server: `pnpm dev`
- Run tests: `pnpm test`
## Code style
- TypeScript strict mode
- Single quotes, no semicolons
- Use functional patterns where possible
这种分离设计旨在为 Agent 提供一个清晰、可预测的指令来源,同时保持 README.md 对人类贡献者的简洁性和专注度。
使用 AGENTS.md 的方法很简单:在代码仓库的根目录下创建一个 AGENTS.md 文件。对于大型的 monorepo,可以在每个子项目或包内放置一个嵌套的 AGENTS.md 文件。Agent 会自动读取目录树中最近的该文件,使其指令具有针对性,最接近的配置文件将拥有优先权。
目前,该标准已获得 Cursor、Amp、Jules、Factory、RooCode 和 Codex 等多种 AI 编码 Agent 和工具的支持。
