AGENTS.md

内容与作用

它就像“写给智能体的 README”：常见条目包括构建 / 测试 / lint 命令、目录结构说明、代码风格约定、提交前检查项、以及“不要动哪些文件”。智能体在开始改代码前读取它，从而少走弯路、产出更符合项目习惯的改动。可以在子目录再放 AGENTS.md 覆盖局部规则。

标准化程度

它是一个轻量约定而非严格 schema——就是普通 Markdown，没有强制字段。截至 2026 年已被 6 万多个开源项目和 Codex、Cursor、Devin、Gemini CLI、Copilot 等工具采用，并随 OpenAI 加入 Agentic AI Foundation 交由社区治理。

常见误解

• AGENTS.md 没有强制格式，工具对它的解析是“尽力理解”而非按规范校验。
• 它是给智能体的操作指令，不是给人看的项目介绍，二者用途不同。

相关术语

参考来源

1. AGENTS.md — agents.md
2. OpenAI — OpenAI co-founds the Agentic AI Foundation (contributes AGENTS.md)