Tavily 的 llms.txt 与 Agent 自助安装设计:一份对照 XERJ 的逐项解剖
Tavily 的 llms.txt 与 Agent 自助安装设计:一份对照 XERJ 的逐项解剖
本文是 XERJ 仓库内 llms-txt-2026-09 调研项目(46 个主流项目的 agent 面向文件对比研究)中的单项目解剖笔记,以 Tavily 为对象:逐项拆解它公开发布的 llms.txt、llms-full.txt、agents.md、SKILL.md 等文件的结构、措辞与安装命令,并逐条对照 XERJ 自身的 llms.txt 指出各自优劣与可采纳建议。读完本文,你将掌握"一个面向 AI Agent 的产品应该如何设计 llms.txt 与安装链路"的完整方法论——从安装命令的放置位置、MCP 配置的呈现方式,到验证契约与反馈通道的写法。
解剖笔记的出处与可信度边界
这份解剖记录(原文位于 docs/research/llms-txt-2026-09/per-project/tavily.md)是整个对比研究的 46 份单项目页面之一。研究日期为 2026-09-18,由一名 Agent 对 Tavily 的在线文件做了一次抓取与提取,所有引文均为逐字原文(verbatim)。研究总纲在 docs/research/llms-txt-2026-09/README.md 中说明了方法:发现(4 个 Agent、4 个角度、176 个候选、85 条模式笔记)→ 解剖(每项目一名 Agent 抓取实况文件,逐字提取大小、章节顺序、安装措辞、MCP 片段、反馈请求)→ 综合与复核。README 也明确交代了信任边界:
- 每条单项目事实都是一次 Agent 对实况 URL 的抓取,未被全部独立复抓;
- 维护者抽查复抓了 14 条声明,13 条确认、1 条因检查自身的搜索模式错误而无结论;5 个文件大小逐字节复核一致;
- 对 XERJ 自身文件的缺陷判定(见 README 第 3 节)都经人工对照
landing/llms.txt核实,属于事实而非 Agent 意见; - 对比是被锚定的:每个解剖 Agent 都被事先告知了 XERJ 已知的差距(shell-less 失败、lexical/neural 误读、"required … under Optional" 矛盾)并要求对比,因此"在所有 46 份解剖中都出现 shell-less 差距"是简报的回声,而非 46 次独立确认;真正独立的是各 Agent 在对方文件中发现的东西——引文、大小、片段与 URL;
- 网络会变化,引用任何数字前应重新测量。
对 Tavily 的解剖还被 docs/research/llms-txt-2026-09/proposals/FACTCHECK.md 二次复抓确认:A16(SKILL.md 的 "Only report Tavily ready…" 在 188 行)、A17(agents.md 的文档 MCP 反馈工具在 47 行)、B49(llms-full.txt 含粘贴提示,17058 行)、C003(agents.md 的无凭证 persona 行在 55 行)、C018(SKILL.md 的 "Do not make the user perform a step…" 在 25 行)、C031(llms.txt 第 47 行有 claude mcp add)等 8 条 Tavily 相关声明全部标记 confirmed。
Tavily 的 llms.txt:18 KB 的手写索引
Tavily 的 llms.txt 位于 https://docs.tavily.com/llms.txt(HTTP 200),大小 18,171 字节、212 行。在 46 项目对照表(见 docs/research/llms-txt-2026-09/comparison-table.md)中,它排在 XERJ(40,064 字节 / 234 行)之前,属于中等偏小的文件。
安装命令的位置设计
关键结构决策:安装命令放在第 16 行,第二个 H2('## Quick Start: CLI (fastest way to get started)'),紧跟在 7 行的 'Start Here For Agents' 路由器之后;MCP 备选方案是第 36 行的第三个 H2。也就是说,安装内容位于所有文档索引章节之前。第 70 行之后是 Mintlify 风格的自动生成索引(非手写逐页链接),而第 1–68 行是手写散文——这正符合整个研究得出的规律:llms.txt 极少真正承担安装职责(46 个项目中 27 个的 llms.txt 里根本没有安装命令),安装被提到 agent 时,往往一跳之隔放在一个简短的 agent 寻址文件里,llms.txt 只负责路由。
解剖记录的完整安装命令如下:
pip install tavily-cli
tvly login
tvly search "latest AI news"
tvly extract "https://example.com"
tvly crawl "https://docs.example.com" --depth 2
tvly research "compare React vs Svelte for production apps"
claude mcp add tavily-remote-mcp --transport http https://mcp.tavily.com/mcp/
pip install tavily-python # (SDKs index 行)
npm i @tavily/core # (SDKs index 行)
注意其 CLI 是"一个命令一个能力"的形态:search(实时搜索)、extract(从 URL 提取结构化数据)、crawl(带 --depth 的站点爬取)、research(综合研究生成带引用的报告),外加 tvly login 浏览器 OAuth 认证。
写给 Agent 的文本(逐字)
Tavily 的 llms.txt 开篇有一小段直接写给 AI Agent 的路由指令,解剖记录原文如下:
If you are an AI agent — or building one — start with the canonical setup guide:
- Agents: Tavily setup & tool-choice guide (https://docs.tavily.com/agents.md): Choose how to connect (SDK/API, MCP, or CLI + Skills), choose the right capability (Search, Extract, Map, Crawl, Research), and apply recommended defaults.
- Documentation MCP setup (https://docs.tavily.com/agents.md#documentation-mcp-server): Search and read Tavily's documentation. MCP endpoint: https://docs.tavily.com/mcp (Streamable HTTP).
Then use this file (llms.txt) to find a specific page, llms-full.txt for the full text of all docs, or append `.md` to any docs URL to fetch that single page as Markdown.
这段文字对应整个调研归纳的安装提示模式 #14(llms.txt 顶部的 agent 寻址操作指令)与 #3(能力分支):告诉 agent"先读 canonical setup guide"、"按连接方式选路"、"按能力选型",并给出文档 MCP 端点与 .md 后缀取 Markdown 的规则。措辞是中性祈使、简洁:对 agent 提出软性要求("start with the canonical setup guide"、"Recommended defaults for agents: prefer search_depth="advanced"…"),但没有义务性语言、没有 "required"、没有贡献请求。营销内容被限制在一个括号里('1,000 credits/month, no credit card required')。
MCP 片段(逐字)
llms.txt 中直接内联了远程 MCP 的配置说明,无需本地安装:
Connect any MCP client to Tavily's remote server — no local install required:
```
https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>
```
OAuth 2.0 is supported, so no API key needs to be hardcoded. For example, in Claude Code:
```
claude mcp add tavily-remote-mcp --transport http https://mcp.tavily.com/mcp/
```
两个值得注意的设计点:一是支持 OAuth 2.0,因此 API key 不必硬编码进配置;二是 claude mcp add 单行命令直接印在 llms.txt 里——整个调研中 46 个项目里有 21 个在 llms.txt 内联打印 MCP 片段,36 个项目的 agent 面向文件里出现过 claude mcp add 行(见 docs/research/llms-txt-2026-09/discovery-install-prompt-patterns.md 的模式 #5),而 XERJ 当时的 llms.txt 中 claude mcp add、mcpServers、任何客户端配置 JSON 出现次数为 0(研究 README 的缺陷 M4)。
反馈 / 贡献请求(逐字)
none——Tavily 的 llms.txt 完全没有反馈或贡献请求。对整个文件 grep 反馈/贡献/报告/issue 均无相关命中;'## Optional' 章节(第 208 行)只放 Playground、Discord、Blog 三个链接。这与研究 README 的核心发现一致:46 个被解剖项目中没有任何一个要求 agent 回报,而 XERJ 是唯一要求 agent 使用后提交报告或开 PR 的项目。
驱动安装与首次使用的最佳段落(逐字)
解剖记录认定以下段落是"驱动安装与首次使用的最佳段落":
## Quick Start: CLI (fastest way to get started)
Install the Tavily CLI and log in — two commands:
```
pip install tavily-cli
tvly login
```
`tvly login` opens a browser for authentication. Then search, extract, crawl, and research from the terminal:
```
tvly search "latest AI news"
tvly extract "https://example.com"
tvly crawl "https://docs.example.com" --depth 2
tvly research "compare React vs Svelte for production apps"
```
Installing the CLI also installs Agent Skills for coding agents like Claude Code, Cursor, and Codex — they remind the agent to use Tavily for search, extract, crawl, and research. Get a free API key at https://app.tavily.com (1,000 credits/month, no credit card required).
## Alternative: Remote MCP Server
Connect any MCP client to Tavily's remote server — no local install required:
三个特点:两条命令完成安装(装 CLI + 登录);安装 CLI 顺带安装 Agent Skills(给 Claude Code、Cursor、Codex 等编码 Agent 用的技能包,提醒 agent 在需要时使用 Tavily);安装入口(第 16 行)与 MCP 备选(第 36 行)分属两个并列 H2,让"有 shell 走 CLI、无 shell 走远程 MCP"的两种 persona 都有明确入口。
一键链接
llms.txt 内的一键链接只有 claude mcp add tavily-remote-mcp --transport http https://mcp.tavily.com/mcp/(第 47 行);cursor://、vscode:、codex:// 深度链接只出现在 llms-full.txt 中,不在 llms.txt 本身(详见下文)。
llms-full.txt:856 KB 的全量拼接
- URL:
https://docs.tavily.com/llms-full.txt(HTTP 200),大小 856,222 字节。 - 与 llms.txt 的关系:由 Mintlify 自动生成的每页拼接——192 个 '# ' H1 块,每块第 2 行是 'Source:
',原始 MDX 组件( <CardGroup>/<Card>/<Icon>)原样保留。 - 章节顺序:Agents 页在最前,之后是 Changelog、About、Agent Skills、pricing、API reference、best practices、enterprise、integrations…,Welcome 页在最后。
- llms.txt 是单独手写的索引(其前 68 行散文并不逐字出现在 llms-full 中)。
- 体积是 llms.txt 的 47 倍;agents.md 明确为其设置门禁:"When you need broad context and have the budget."(当需要广泛上下文且有预算时)。
这条"预算感知的文档分层表"(Resource | What it is | When to fetch it)正是 XERJ 调研建议采纳的模式之一(见下文"可采纳建议")。研究 README 的对照显示:XERJ 的 llms-full.txt 只有 83,712 字节,是少数能塞进上下文窗口的全量文档(46 项目的中位数是 1.96 MB,最大 59.4 MB)——这是 XERJ 不该回退的优势。
分层文件体系:agents.md / SKILL.md / skill.md / 发现清单
Tavily 的完整 agent 面向文件不止 llms.txt 与 llms-full.txt,而是一个分层文件体系,每层职责单一:
agents.md(canonical agent 设置指南;/AGENTS.md 重定向至此)
HTTP 200,167 行、11,618 字节的手写路由器,内容包括:
- 该抓取哪些文档(llms.txt / agents.md / llms-full.txt / 页面 .md URL 的表格,带 "When to fetch it" 列);
- 如何连接(persona 表,含 "An autonomous agent with no credentials or API key | Keyless / MCP" 行);
- 无密钥路径(
X-Tavily-Access-Mode: keyless请求头与 x402 加密按请求付费); - 能力选择器(Search / Extract / Map / Crawl / Research);
- 推荐的参数默认值;
- 文档 MCP(带反馈工具)。
开篇的 Mintlify blockquote 逐字如下:
To connect to the documentation server, use the settings below. No Tavily API key or sign-in is required.
* **Server URL:** `https://docs.tavily.com/mcp`
* **Transport:** Streamable HTTP
For Claude Code:
```bash
claude mcp add --transport http tavily-docs https://docs.tavily.com/mcp
```
After connecting, try asking: "Find the URL limit for Tavily Extract in the documentation."
The documentation server also provides a tool for submitting documentation feedback.
注意最后一行:文档 MCP 服务器自带一个"提交文档反馈"的工具——这是 Tavily 的反馈通道设计:无 gh、无 CLA、无仓库写权限,零摩擦(解剖记录标注 INFER:这正是他们不需要 "required" 语言的原因)。
SKILL.md(托管的 agent 安装技能,手写 YAML frontmatter)
HTTP 200,536 行、26,130 字节,位于 https://www.tavily.com/agent-setup/SKILL.md,是可执行的安装提示。落地页的文案是"Read and execute tavily.com/agent-setup/SKILL.md"——整个调研中最常见的安装提示模式(模式 #1:托管的 SKILL.md + 一行粘贴提示;参见 docs/research/llms-txt-2026-09/discovery-install-prompt-patterns.md)。
它定义了一个 preflight → CLI → auth → skills → verification 状态机,并包含硬性行为规则:
- 禁止让人类做可在终端完成的步骤;
- 禁止打印密钥;
- 禁止后台化
tvly login; - 要求按层验证,并给出精确的 5 行就绪清单;
- 之后是 'After Successful Setup: Turn Setup Into Useful Work' 章节,把上下文分类(mid-session / new session with prior knowledge / new session cold)并驱动 agent 进入真实任务。
安装命令族(逐字):
curl -fsSL https://cli.tavily.com/install.sh | bash
npx skills add tavily-ai/skills --skill '*' --agent claude-code --global --yes
claude plugin install tavily@claude-plugins-official
claude mcp add tavily-remote-mcp --transport http https://mcp.tavily.com/mcp/ --header "X-Tavily-Access-Mode: keyless"
覆盖了四种分发渠道:shell 安装脚本、npx skills add(Agent Skills 规范,36 个被探测文件提及)、Claude 官方插件市场、以及带 keyless 头的远程 MCP。
逐层验证契约(解剖记录重点引用):
# CLI:
command -v tvly
tvly --version
# Authentication:
tvly auth --json
# Live Tavily request:
tvly search "Tavily Search API" --json
并规定了"何时才能报告就绪"的状态清单:
Only report Tavily ready when the applicable states are true:
Tavily CLI installed
Authentication verified
Live Tavily Search verified
Agent Skills installed
Agent Skills active in current session
以及一条诚实的边界规则:"If skills are installed but the current client needs a restart/rescan, say "installed; restart/rescan required" rather than claiming they are already active."(如果技能已安装但当前客户端需要重启/重扫,要说"已安装;需要重启/重扫",而不是声称它们已经激活。)
这正是研究 README 缺陷 M5("没有方法知道它成功了")与 M11("没有交接契约、没有同意步骤")的反例解法:每个安装步骤后都有验证行和预期输出。
.well-known/skills/index.json(技能发现清单)
HTTP 200,358 字节的 Mintlify 技能发现清单,列出唯一技能 'tavilyai':
{"skills":[{"name":"tavilyai","description":"Use when building AI agents that need real-time web search, content extraction, site crawling, or comprehensive research synthesis. Reach for Tavily when an agent must retrieve current information, extract structured data from URLs, map site structure, or generate cited research reports.","files":["SKILL.md"]}]}
files: ["SKILL.md"] 解析到 https://docs.tavily.com/skill.md。这条 .well-known/skills/index.json 让技能感知的客户端无需读 llms.txt 即可自动发现。
skill.md(Mintlify 自动生成的文档技能)
HTTP 200,289 行、14,001 字节。与手写的 www.tavily.com SKILL.md 不同,这是使用技能(usage skill)而非安装技能:产品摘要与定价、'When to use' / 'Do not use Tavily for'、端点/成本表、SDK 初始化片段。frontmatter 元数据 'mintlify-proj: tavilyai'。其边界声明(逐字):
Do not use Tavily for: static content you already have, authentication-gated pages (Crawl cannot log in), or tasks that don't require live web data.
负面探测:404 与 405 也是证据
解剖记录同样记录了不存在的文件——这是直接探测的常规步骤,因为 HTTP 200 也可能是软 404(研究提案报告专门记录过:docs.sentry.io/SKILL.md 返回 200 但正文是 "Page Not Found";状态码不是文件存在的证据,要读正文):
| 探测目标 | 结果 | 含义 |
|---|---|---|
https://docs.tavily.com/llms-install.md |
HTTP 404 | 不存在(Mintlify 404 页)。llms-install.md 是 Cline 市场的约定,但 46 个被解剖的顶级项目中 0 个发布它 |
https://docs.tavily.com/CLAUDE.md |
HTTP 404 | 不存在 |
https://docs.tavily.com/mcp |
HTTP 405 | 实况 Streamable-HTTP MCP 端点;对 MCP POST 端点做普通 GET 返回 405 是预期行为,即它存在。按 agents.md,它暴露文档搜索/读取加一个文档反馈工具 |
Tavily 做得比 XERJ 好的九个方面
解剖记录列出了 Tavily 相对 XERJ(以 2026-09-18 当天的 https://xerj.org/llms.txt,40,064 字节 / 234 行为基准)的九个优势:
- 无 shell / 无凭证的 persona 路由。agents.md 表格明确给出 "An autonomous agent with no credentials or API key | Keyless / MCP | No key, no account — add a header for Search/Extract, or use the no-key remote MCP." 而 XERJ 的 llms.txt 把无 shell 路径埋成 'Start here' 下的一个子弹('Agent quickstart … the HTTP-only path for an agent with no shell'),前面还是 CLI 优先的 4 步列表——FTX 研究(22 次首用 agent 实验)显示无 shell persona 在每一档模型上都失败(研究 README 缺陷 M3)。
- 独立、可执行的安装提示,一句话即可粘贴:'Read and execute tavily.com/agent-setup/SKILL.md',并带各客户端的一键深度链接(
claude-cli://open?q=…、codex://new?prompt=…、cursor://anysphere.cursor-deeplink/prompt?text=…)。XERJ 没有托管的 SKILL.md / 安装提示 URL,安装内联在 llms.txt 里。 - 明确的验证契约:SKILL.md 的 '### 5. Verify every layer' 带 5 行就绪清单,并规定 'say "installed; restart/rescan required" rather than claiming they are already active'。XERJ 的 'Start here' 没有"你完成的标准是…"的状态清单。
- 通过 MCP 工具做反馈,而不是 PR:'The documentation server also provides a tool for submitting documentation feedback.' 零摩擦,无 gh、无 CLA、无仓库写权限。
- MCP 以三种方式发布和文档化:托管远程 URL、
claude mcp add …单行、JSONmcpServers块(llms-full 第 10714 行)、Cursor 安装徽章。XERJ 的 MCP 服务器存在,但只通过xerj init文档化(本地、需要 shell)。 - 预算感知的文档分层表:agents.md 的 'llms-full.txt | Full text of all docs | When you need broad context and have the budget' 与 'append .md to any docs URL',让 agent 不会在只需 40 KB 索引时拉 856 KB 全量。
- 给安装 agent 的硬性行为规则,例如 'Do not make the user perform a step that can be completed from the terminal.'、'Never ask the user to find an API key or manually add TAVILY_API_KEY to .env'、'Waiting for human consent is not an error condition.'、'Do not repeat setup instructions after successful verification.'
- 安装后交接:SKILL.md 的 '## After Successful Setup: Turn Setup Into Useful Work' 把上下文分为 mid-session / new-session 并推动 agent 进入真实任务,且 'Ask at most one next-step question in each response.'
- 手写的技能发现清单
/.well-known/skills/index.json加/skill.md,技能感知客户端无需读 llms.txt 即可自动发现。
XERJ 做得比 Tavily 好的六个方面
解剖记录同样列出 XERJ 的优势(这些优势在 48 份解剖中被独立重复命名,研究 README 第 5 节要求"不要回退"):
- 安装命令就在 llms.txt 第 11 行('Start here' 第二行)——Tavily 的 llms.txt 也在第 16 行放安装,大致持平;但 XERJ 是单一零账号的
curl -fsSL https://xerj.org/get | sh,无登录/密钥步骤;Tavily 在 Search/Extract 之外的一切都需要tvly login浏览器 OAuth 或 API key。 - 内联的诚实性警示:XERJ 的 '## Caveats (read before you rely on a capability)' 和 lexical-vs-neural 警告在文件正文里;Tavily 的 llms.txt 没有警示章节,唯一的限制说明是 agents.md 的 '## Availability'(两句话)。
- 失败模式指导:PATH 后果、数据目录在索引树内的陷阱、退出码 0/1/2/3/4、进度行解析、在人类的笔记本电脑上运行前先估算——Tavily 的 llms.txt 完全没有这些,只有 SKILL.md 带 Node-18 故障排查。
- 可复现性框架:'Everything on this page is reproducible against a running XERJ node' 和实测数字;Tavily 的 llms.txt 不引用任何测量数据。
- 可手动验证的安装路径('the manual verifiable install without curl | sh',fail-closed SHA-256 校验,缺校验和即拒绝安装)——Tavily 只有
curl … | bash或pip install,被抓取的文件中完全没有校验和讨论。 - 有贡献请求这件事本身:Tavily 对 agent 一无所求(只有一个文档反馈 MCP 工具);XERJ 的一命令
xerj feedback --open-pr是比 Tavily 任何机制都强的机制——缺陷在于放置与措辞('required … under Optional' 自相矛盾,见研究 README 缺陷 M1),不在机制本身。
XERJ 的 landing/llms.txt 开篇即自述:"This file asks two things of you. Reference-code before you write … And contribute back — this is required, not optional:every agent that installs and runs XERJ owes one short field report before the session ends, and the template is under Optional." 第 5 步要求 "File your field report — required, one command: xerj feedback --open-pr --agent "<your model>" --used-for "<what you did>" --verdict "<what worked / what did not>""。仓库根部的 AGENTS.md 第 7–23 行同样以 "If you used XERJ, you owe it a field report" 开头——这份解剖正是支撑"应同时修改这两处措辞"(研究 README 缺陷 M1 的修复建议)的证据。
XERJ 可采纳的八条建议
解剖记录最后给出八条可直接采纳的改进建议(对应研究 README 第 6 节的 12 条变更规则):
- 发布托管的可执行安装技能到稳定 URL,把 hero 提示压成一句话,照搬 Tavily 落地页形态:'Read and execute tavily.com/agent-setup/SKILL.md' → 'Read and execute xerj.org/agent-setup/SKILL.md',并加上同样的三个深度链接(
claude-cli://open?q=…、codex://new?prompt=…、cursor://anysphere.cursor-deeplink/prompt?text=…)。 - 修掉 'required … under Optional' 矛盾,照抄 Tavily SKILL.md 的验证门形态:把就绪定义为状态清单并把报告放进清单。XERJ 等价版:"Only report XERJ ready when: binary on PATH / node answers /_cluster/health / autoindex exit 0 or 3 / one query answered / field report filed or --dry-run handed to operator",并把 llms.txt 的 '## Optional' 改名(如 '## Your side of the deal')或把模板链接移进 'Start here' 第 4 步。
- 在 llms.txt 顶部加 persona 路由表,仿 agents.md 的 '## 2. Choose how to connect'('If you are… | Use | Why it fits | Start at'),为 FTX 研究中失败的 persona 显式留一行:"An agent with no shell (MCP-only or HTTP-only) | HTTP / hosted MCP | … | https://xerj.org/docs/agents/quickstart"。
- 加文档分层表,仿 agents.md 的 '## 1. Agent-readable docs'('Resource | What it is | When to fetch it';行 'llms-full.txt | Full text of all docs | When you need broad context and have the budget.'),让 agent 不再在 40 KB 索引足够时去拉 84 KB 的 llms-full。
- 以三种形态发布和文档化 MCP 服务器:
claude mcp add --transport … xerj …单行、JSONmcpServers块、Cursor 安装徽章;并增加/.well-known/skills/index.json({"skills":[{"name":…,"description":…,"files":["SKILL.md"]}]})让技能感知客户端自动发现 XERJ。 - 降低反馈摩擦,引入带内通道:仿 "The documentation server also provides a tool for submitting documentation feedback." 暴露
xerj_feedbackMCP 工具(或节点上的 POST 端点),不经过 gh/CLA/PR 即可提交 field report,--open-pr作为升级路径——这直接针对 shell-less persona 完全无法运行xerj feedback --open-pr的问题(研究 README 第 4 节)。 - 逐字采纳 SKILL.md 的 agent 行为规则:'Do not make the user perform a step that can be completed from the terminal.'、'Surface a manual prerequisite only when automation is genuinely blocked. State only the blocker and the minimum action required.'、'Do not repeat setup instructions after successful verification.'、'Ask at most one next-step question in each response.'——这些应进 XERJ 的 SKILL.md,而非 llms.txt。
- 增加安装后交接章节,仿 SKILL.md 的 '## After Successful Setup: Turn Setup Into Useful Work'('Do not mechanically show every user the same command demo.' / 区分 Mid-session 与 New session)——XERJ 的 llms.txt 在 'Start here' 结束于 field report,缺少"现在去做你本来要做的任务"这一步,而 field report 请求正是在这里被遗忘的。
研究 README 第 9 节给这八条排了优先级:先移除义务性语言并增加 HTTP 端点与 MCP feedback 工具(M1、M2),再开放三个能力分支与完整的 MCP-only 路径(M3、M4),再加验证行(M5),加 "what you probably assume / what is true" 块(M8),发布 SKILL.md 与技能发现清单(M12),给每个 .md 页加三行索引横幅(M9),拆分 brief 与索引(M6、M7、M10),最后加交接契约与同意步骤(M11)。
总结
这份 Tavily 解剖(docs/research/llms-txt-2026-09/per-project/tavily.md)展示了一个成熟产品如何为 AI Agent 设计完整的自助安装与使用链路:手写 llms.txt 只做索引与路由,安装内容高置但保持简洁;分层文件体系(llms.txt 索引 → agents.md 路由器 → SKILL.md 可执行安装 → skill.md 使用技能)让每层职责单一;验证契约(5 行就绪清单、"installed; restart/rescan required" 的诚实措辞)让 agent 知道何时算完成;keyless / MCP 通道让无 shell、无凭证的 persona 也能完成首次接入;反馈走 MCP 工具而不是 PR,实现零摩擦回收信号。
对照 XERJ,优势互补清晰:Tavily 胜在无 shell persona 覆盖、安装提示可执行化、验证与交接契约、反馈通道设计;XERJ 胜在安装内联且零账号、诚实警示、失败模式指导、可复现性、校验和验证、以及贡献机制本身。研究 README 的 12 条变更规则(docs/research/llms-txt-2026-09/README.md)与提案报告(docs/research/llms-txt-2026-09/proposals/report.md)把这些洞察转成了可执行的改写清单;而本文所述的 Tavily 侧事实均已由 docs/research/llms-txt-2026-09/proposals/FACTCHECK.md 二次复抓确认。若你正在为自己的项目设计 llms.txt、安装提示或 agent 反馈通道,这份解剖连同 对照总表、安装提示目录 与 模式笔记,是一份可以直接照做的参考。