EN
全部 Agent 工程

规范文件

llms.txt 和 AGENTS.md 不是一回事：网站入口与仓库指令

llms.txt 给读网站的 AI 当入口，AGENTS.md 给在仓库里干活的编程 Agent 当指令；都不保证收录或带来流量。未实测，以官方为准

名字像，用处不同：一个放在网站上，一个放在代码仓库里。本文按官方页面的说法，把两个文件分开讲，并且分别写给网站作者和仓库维护者。

核验日期
· 未实测
适用于
  • 通用 两个文件都是各自官方页面描述的通用约定，不绑定某一个工具[1][2]

文件位置

路径适用范围读取方式
/llms.txt网站根路径；也可放在网站内任意子路径，如 /docs/llms.txt读取网站内容的 AI 和 Agent，按需读取[1]
./AGENTS.md代码仓库根目录；大型 monorepo 可在子项目里再放在仓库里工作的编程 Agent，读取最近的文件[2]

什么时候用

  • 你在做网站或文档站，想给 AI 一个简短的、指向 Markdown 内容的入口。[1]
  • 你在维护代码仓库，想把构建、测试和代码风格写给编程 Agent。[2]
  • 有人把两个文件混为一谈，需要一张对照表说明各自给谁读、放在哪。[1][2]

什么时候不用

  • 期待放了 llms.txt 就会被收录或带来访问：两个官方页面都没有这样的承诺。[1][2]
  • 想用 llms.txt 控制爬虫能不能访问：官方说明那是 robots.txt 的用途。[1]
  • 想把项目文档写进 llms.txt 让仓库里的编程 Agent 照做：那是 AGENTS.md 的位置。[2]

两个文件分别给谁读、放在哪

llms.txt 与 AGENTS.md 对照（官方页面）
对比项llms.txtAGENTS.md
给谁读网站内容的读取方：llmstxt.org 说它用来帮助 Agent 使用网站，Agent 需要某个主题的信息时按需读取编程 Agent：agents.md 说它是面向编程 Agent 的指引，类似给 Agent 的 README
放在哪网站根路径 /llms.txt，或网站内任意子路径，例如 /docs/llms.txt，覆盖该路径下的页面代码仓库根目录；大型 monorepo 可在每个子项目里再放一个
写什么Markdown：H1 站名，引用块摘要，H2 分节的链接列表，链接指向适合 AI 读取的内容普通 Markdown，没有必填字段，常见内容是构建与测试命令、代码风格
多个文件怎么选适用多个文件时，Agent 应使用最具体的一个读取目录树里最近的文件，最近的优先

[1][2]

官方页面把两者定位成互补的不同东西：llms.txt 是网站的入口说明，AGENTS.md 是仓库里的工作指令。[1][2]

版本口径：llmstxt.org 页面标题标为 v2；agents.md 页面未标注文档或格式版本，以 2026-10-28 核验日期读取的内容为准。[1][2]

给网站作者：llms.txt 怎么写

llmstxt.org 描述的格式依次是：一个 H1（唯一必需的部分）、一个引用块摘要、若干不含标题的说明、若干用 H2 分隔的文件列表；每个列表项是 [名称](链接)，后面可跟冒号和说明。名为 Optional 的 H2 按约定放次要内容，上下文紧张时可以跳过。[1]

下面是本站 ai.nav.city 的 llms.txt 开头部分，用来说明这些结构元素；它只是本站自己的示例，不是官方样板。[1]

示例：本站 https://ai.nav.city/llms.txt 的开头（2026-10-28 读取）
# AI Nav City

> AI Nav City 是 AI工具导航与选型资料站：按任务与条件发现 AI 工具，每个工具列出已核验官网的用途、价格条件与来源。
> AI Nav City is an AI tool directory and selection notes site: find AI tools by task and conditions, with each tool listing its purpose, pricing conditions and sources checked against official pages.

## 中文入口

- [中文首页：AI工具导航与选型资料](https://ai.nav.city/zh/)
- [按任务选工具](https://ai.nav.city/zh/tasks/)
- [了解核验与推荐方法](https://ai.nav.city/zh/methodology/)

[1]

  • llmstxt.org 说它和 sitemap.xml 不同：sitemap 列出全部可索引页面，llms.txt 是给 AI 的精选概览。
  • llmstxt.org 说它和 robots.txt 用途不同：robots.txt 告诉自动化工具哪些访问可接受，llms.txt 在 Agent 为用户查资料时按需读取。
  • llmstxt.org 另提议页面提供 .md 版本，并建议用 rel="alternate" 和 rel="describedby" 这类标准链接关系帮助客户端找到它们。

[1]

给仓库维护者：AGENTS.md 怎么用

agents.md 官网的做法：在仓库根目录创建 AGENTS.md，写项目概览、构建与测试命令、代码风格、测试说明、安全注意事项等；大型 monorepo 可以在每个包里再放一个，Agent 读取最近的那个。[2]

  • 官网写明没有必填字段，用任意标题即可。
  • 官网写明冲突时离被编辑文件最近的 AGENTS.md 优先，用户在对话里的明确指令高于一切。
  • 官网说如果在 AGENTS.md 里列出测试命令，Agent 会尝试执行相关检查并修复失败。
  • 具体到某个工具如何读取 AGENTS.md，例如 Claude Code，请看该工具的官方文档。

[2]

不保证收录或带来流量

llmstxt.org 描述的是一种提议的文件格式和用法，页面里没有写放置 llms.txt 就会被收录，也没有写会带来访问量，官方未写明相关承诺。agents.md 官网同样只讲 AGENTS.md 的格式和用法。本文也不作这类保证：文件放对位置，只表示读取方有现成入口可用。[1][2]

来源

以下均为官方页面，核验日期见各条；链接指向核验时的版本。

  1. llmstxt.org · The /llms.txt file, v2 – llms-txt
  2. agents.md · AGENTS.md

发现错误？告诉我们 →