AGENTS.md
AGENTS.md 是放置在仓库或网站根目录的一份 Markdown 文件，它向 AI 智能体说明该项目的构建方法、测试命令、代码风格以及操作时应遵守的规则，是一份事实上的标准指令文件。它被称为"面向智能体的 README"，包括 OpenAI Codex 在内的主流编码智能体会在开始工作时自动读取它。
AGENTS.md 是放置在仓库或网站根目录的一份 Markdown 文件，它向 AI 智能体说明该项目的构建方法、测试命令、代码风格以及操作时应遵守的规则，是一份事实上的标准指令文件。它被称为"面向智能体的 README"，包括 OpenAI Codex 在内的主流编码智能体会在开始工作时自动读取它。
为什么重要
AI 编码智能体虽然强大，却并不了解项目的隐性知识。用什么命令运行测试、哪些目录不能改动，过去都得在每条提示中重新说明。AGENTS.md 把这些上下文固定在一份文件中，让智能体自动参照。它由 OpenAI Codex、Amp、Jules（Google）、Cursor、Factory 共同设计，并被 GitHub Copilot、Gemini CLI、Devin、Zed 等 20 多款工具原生支持。截至 2026 年，已有 6 万多个开源项目采用；2025 年 12 月，它与 Anthropic 的 MCP 一同被捐赠给 Linux 基金会旗下的 Agentic AI Foundation，置于中立治理之下。
结构与写法
AGENTS.md 是没有必填字段的纯 Markdown。它不依赖既定的 schema，而是承载智能体能够阅读并遵循的自然语言指令。推荐的组成如下。
- 项目概览：用一两段说明这是一个做什么的代码库
- 构建与测试命令：安装依赖、启动开发服务器、运行测试的命令
- 代码风格：命名、格式化、框架惯例
- 安全与边界：不能改动的文件、密钥的处理规则
- 提交与 PR 规则：消息格式、评审流程
在大型单体仓库（monorepo）中，可按各个包放置嵌套的 AGENTS.md，智能体会优先采用距其工作位置最近的文件。
与 llms.txt 的区别
如果说 llms.txt 是告知"AI 这里有哪些内容"的导览手册，那么 AGENTS.md 就是说明"在这里如何操作"的运营手册。它原本起源于代码仓库，但近来也出现了将其放在网站根目录（/agents.md）、向浏览智能体说明网站使用方法的做法。它与 llms.txt、Schema.org 标记一同被归入"智能体可读信号（agent-readable signals）"这一范畴；与处理是否允许 AI 爬取的 robots.txt 不同，它处理的是"获允许的智能体该做什么、该怎么做"。
GEO 视角的启示
随着 GEO 的重心从"AI 引用的内容"扩展到"AI 可以操作的网站"，向智能体提供明确指令的文件正成为一个新的优化层。对于运营开发工具或 API 文档的团队而言，用 AGENTS.md 越是减少智能体的试错，自家产品被纳入智能体工作流的可能性就越高。不过 AGENTS.md 终究只是指令、并无强制力，因此内容本身的结构化质量仍是基本功。
Sources:
- AGENTS.md
- agentsmd/agents.md - GitHub
- MCP, A2A, NLWeb, and AGENTS.md: The Standards Powering the Agentic Web - No Hacks
inblog 如何提供帮助
如果你用 inblog 运营产品博客或文档内容，请记住各类信号的分工。在 llms.txt 之类的文件负责内容导览、AGENTS.md 负责操作指令的同时，博客正文要具备便于智能体引用与摘要的结构，这是基本前提。inblog 干净的标记与清晰的小标题结构，与这些智能体可读信号结合时，效果会更加显著。