拆解 Composio 的 Agent 面向文档：llms.txt 三文件架构与 XERJ 的改进清单

【免费下载链接】xerj

XERJ is the new way for AI to search data. Its autoindex capability activates agents to know your data without the token waste of grep and sed. One command indexes code, docs, logs and PDFs for search, RAG, security audits and agent memory, using 40x fewer tokens than grep. Elasticsearch compatible, so existing clients just work.

项目地址： https://gitcode.com/GitHub_Trending/xe/xerj

点击查看 免费下载

本文以 XERJ 在 2026 年 9 月 llms.txt 研究（46 个项目的 agent 面向文档调研）中针对 Composio 的逐项目拆解页 per-project/composio.md 为主体，完整还原其对 Composio llms.txt、llms-index.txt、llms-full.txt、SKILL.md 及九个 agent 面向页面的逐文件分析，并逐项核对它与 XERJ 现有 agent 文档（landing/llms.txt、AGENTS.md）的双向差距和八条可落地提案。读完后，你可以掌握一套“路由文件 → 链接索引 → 全文转储”的三层 agent 文档架构，以及失败降级阶梯、决策门、显式验证判据、逐客户端粘贴提示词等可直接复用的设计手法。

1. 来源与方法：这份拆解在研究中的位置

llms.txt 是站点为 AI agent 提供的 Markdown 入口约定（2026-08-10 修订版引入了按路径作用域的文件、.md 孪生页和 rel="alternate" type="text/markdown" 发现机制）。XERJ 团队在 2026-09-18 用多个 agent 并行抓取了 46 个项目的 llms.txt、llms-full.txt 及其他 agent 面向文件（SKILL.md、AGENTS.md、clients.md 等），并与当天的 landing/llms.txt（40,064 字节、234 行）逐一对比。总研究报告是 docs/research/llms-txt-2026-09/README.md，每个项目一页，Composio 这一页即本文的展开对象。

先明确证据边界，引用本文任何数字前都应带着这个前提：

• 该页的每一个 Composio 事实都是一个 agent 在 2026-09-18 对线上 URL 的单次抓取；引文是 agent 原样返回的逐字文本，并非全部被独立重新抓取过（原文档开头即注明 “see ../README.md for what was and was not independently re-checked”，即 docs/research/llms-txt-2026-09/README.md）。
• 维护者用 curl 抽查重抓了 14 条声明：13 条确认、1 条不确定（不确定的是检查脚本自己的搜索模式写错了，而非声明本身）；5 个文件大小的复测与拆解结果逐字节一致（如 Ollama 1,674 B / 29 行、DuckDB 3,371 B / 37 行）。
• 研究流程后续在 2026-09-19 做了完整的事实核查：259 条声明重抓两遍，258 条确认、1 条未确认并被移除，记录在 docs/research/llms-txt-2026-09/proposals/FACTCHECK.md。
• 结构化无损数据在 docs/research/llms-txt-2026-09/data/dissections.json（48 条运行、46 个唯一项目），全量对比表由 scripts/build_tables.py 从该 JSON 再生成，见 docs/research/llms-txt-2026-09/comparison-table.md。其中 Composio 一行为：llms.txt 4,445 字节 / 50 行，llms-full.txt 1,160,265 字节，install 位于第 11 行（'## Before you implement' 内），有一键安装入口、含 MCP 片段（引自关联页）。

Composio 在研究中的分类是 agent tooling（工具/鉴权平台），即通过工具调用平台让 agent 连接外部应用的 SDK/CLI 厂商。它的 agent 文档体系正是本次研究中“把 llms.txt 当作给 agent 的执行程序来写”的代表案例。

2. llms.txt：50 行、4.4 KB 的 agent 路由

2.1 基本事实与安装位置

• URL：https://docs.composio.dev/llms.txt — HTTP 200
• 大小：4,445 字节、50 行
• 安装位置：第 11 行，位于 ## Before you implement（6 个 section 中的第 1 个，在任何链接列表之前）。文件中唯一的安装命令是 skill 安装；产品本体的安装（CLI/SDK）不在 llms.txt 里——被下放给所链接的 .md 页面。第 20 行在一个链接的描述文字里内联提到了 composio login --agent（不是代码块）。

也就是说，这个文件刻意把自己收窄为“路由器”：它只负责让 agent 走到正确的页面，产品安装步骤留给深一层的 Markdown 页。这一点与 XERJ 当时“安装命令必须在文件里”的思路正好相反，也正是后面“可采纳想法”要讨论的取舍。

2.2 语气：写给 agent 的第二人称程序

拆解页对语气的判断是：祈使句、第二人称的 agent 操作规程。它对 agent 提出明确的动作要求，逐词为 ‘Inspect’、‘Explain where Composio fits’、‘ask what the user wants … before making changes’、‘Load and follow’、‘requesting approval if your host requires it’、‘report that fallback’、‘clarify that first’。除一行 tagline（“1,500+ toolkits”）外没有任何营销形容词。它也不是中性的链接索引：在任何链接出现之前，先让 agent 走一棵决策树（Platform vs For You；集成进应用 vs 把应用连接到 coding agent 本身）。

2.3 章节顺序与安装命令

章节顺序（section order）：

# Composio Documentation (H1 + blockquote tagline + 1 routing paragraph)
→ ## Before you implement
→ ## Choose your path
→ ## Build an application
→ ## API Reference (v3.1, current)
→ ## API Reference (v3.0, legacy)
→ ## Optional

从该文件提取到的全部安装命令（verbatim）：

npx skills add ComposioHQ/composio --skill composio
composio login --agent (mentioned in a link description on line 20, not as a code block)

2.4 写给 agent 的正文（逐字引用）

## Before you implement

Inspect the project's framework, agent architecture, authentication, and user or tenant identity model. Explain where Composio fits. If the intended workflow is unclear, ask what the user wants their application or agent to accomplish with connected apps before making changes.

Load and follow the official [Composio Agent Skill](https://github.com/ComposioHQ/composio/blob/next/skills/composio/SKILL.md) for setup guidance and implementation patterns. If it is missing, install it for the project with `npx skills add ComposioHQ/composio --skill composio`, requesting approval if your host requires it. If skills are unsupported or installation fails, use the documentation linked below and report that fallback.

If it is unclear whether the goal is to integrate Composio into the application or connect apps to the coding agent itself, clarify that first. Fetch the relevant Markdown pages below for the chosen path. Use the complete index when you need a guide or reference not listed here.

这段 50 行文件的心脏里有两个被研究点名、值得单独设计的手法：

1. 决策门（decision gate）：“If the intended workflow is unclear, ask … before making changes”“If it is unclear whether the goal is to integrate Composio into the application or connect apps to the coding agent itself, clarify that first.”——在 agent 动手之前，先要求它澄清意图。
2. 失败降级阶梯（graceful-degradation ladder），一句话给出三级回退：“如果 skill 缺失 → 用 npx skills add … 安装，宿主需要批准就先请求批准；如果宿主不支持 skill 或安装失败 → 使用下面链接的文档，并报告这个回退。”XERJ 的研究发现，无 shell / 仅 MCP 的 agent 人格在每一档模型层级上都会失败，而这一句恰好覆盖了那类人格。

2.5 驱动安装与首次使用的最佳段落（逐字引用）

Load and follow the official [Composio Agent Skill](https://github.com/ComposioHQ/composio/blob/next/skills/composio/SKILL.md) for setup guidance and implementation patterns. If it is missing, install it for the project with `npx skills add ComposioHQ/composio --skill composio`, requesting approval if your host requires it. If skills are unsupported or installation fails, use the documentation linked below and report that fallback.

If it is unclear whether the goal is to integrate Composio into the application or connect apps to the coding agent itself, clarify that first. Fetch the relevant Markdown pages below for the chosen path. Use the complete index when you need a guide or reference not listed here.

## Choose your path

- [Platform or For You](https://docs.composio.dev/docs.md): Choose between building an application and using your own connected apps.
- [Set up a coding agent](https://docs.composio.dev/docs/agent-setup.md): Install the Composio skill to add Composio to an existing project.
- [SDK quickstart](https://docs.composio.dev/docs/quickstart.md): Install Python or TypeScript packages, create a session, and run an agent.
- [Authenticate an unattended agent](https://docs.composio.dev/docs/agent-setup/unattended-authentication.md): When no human is available, use `composio login --agent`, configure a project API key, and verify a live tool call. Human account access still requires authorization.
- [Native agent plugins](https://docs.composio.dev/docs/agent-plugins.md): Use your own apps from Codex or Claude Code.
- [Connect an MCP client](https://docs.composio.dev/docs/composio-connect.md): Connect an existing client to your apps over MCP.

2.6 MCP 片段、反馈请求与一键链接

拆解页记录了三项“缺位”事实（同样是设计信息）：

• MCP 片段：llms.txt 内没有；通用 MCP JSON 在 composio-connect.md 的 '## Generic MCP URL' 一节：

```json
{
  "mcpServers": {
    "composio": {
      "url": "https://connect.composio.dev/mcp",
      "headers": {
        "x-consumer-api-key": "YOUR_CONSUMER_KEY"
      }
    }
  }
}
```

• 反馈/贡献请求：50 行里没有任何 feedback、contribution、issue 或 PR 请求。整个文档语料库中唯一的支持 CTA 在 composio-connect.md 的 '### I still need help'：联系 support@composio.dev 或加入 Composio Discord。
• 一键链接：llms.txt 本身没有；散见于文档其他位置——windsurf://windsurf-mcp-registry?serverName=composio（composio-connect.md 第 161 行）、GitHub MCP registry 的 “Install in VS Code”（第 155 行）、cursor.com/marketplace/composio、Claude Code 的 /plugin marketplace add ComposioHQ/composio-plugin-cc + /plugin install composio@composio（agent-plugins.md）、Codex 的 codex plugin marketplace add … --json + codex plugin add composio@composio --json。

3. llms-full.txt 与 llms-index.txt：三个文件，三种角色

3.1 llms-full.txt：1.1 MB 的非精选拼接

• URL：https://docs.composio.dev/llms-full.txt — HTTP 200

• 大小：1,160,265 字节

• 与 llms.txt 的关系：248 个页面正文的拼接（# Title (/path) 标题、--- 分隔符），共 1,771 个标题，由 llms.txt 所链接的同一套 Fumadocs .md 页面生成。它不是精选内容，也不是 llms.txt 的同内容放大版：

  • llms-full.txt 完全不含 '## Before you implement' 这段 agent 程序（grep 确认其缺席）；
  • 它的开头（第 7–103 行）是另一个独立块：“Composio SDK — Notes for AI Code Generators”（术语迁移表、常见生成代码错误清单）。同一块内容还被逐字追加到每一个 .md 页面的页脚（拆解中在 agent-setup.md 第 39–132 行、clients.md 第 246 行起、composio-connect.md 第 291 行起都看到了）。

• 产品安装在该文件中的位置：首次出现在第 147 行（Quickstart 页内嵌 agent 提示中的 npx skills add …）与第 170–186 行（按框架给出的 uv add / pip install / npm install）；CLI 安装 curl -fsSL https://composio.dev/install | sh 在第 3252 行（Agent plugins 页）和第 3419 行（CLI 页）；MCP JSON 在约第 4018 行（Composio Connect 页）。页面按文档侧边栏排序：Notes for AI Code Generators（7）→ /docs 总览（109）→ Quickstart（135）→ providers（676–3245）→ Agent plugins（3246）→ Using the skill（3338）→ CLI（3404）→ Composio Connect（3850）→ agent-setup（4136）→ unattended auth（4170）→ clients（4252）→ concepts/auth 等 → KB。

3.2 llms-index.txt：完整链接索引

第三个文件 https://docs.composio.dev/llms-index.txt（200，45,940 字节）是完整链接索引，其中一句话点明了三文件分工：

For a shorter routing map, start at [llms.txt](https://docs.composio.dev/llms.txt).

于是这一组合的角色是明确的：llms.txt = 50 行 agent 路由器；llms-index.txt = 完整链接索引；llms-full.txt = 完整页面正文。研究总报告将其总结为“每个文件一句话说明自己的职责”，并指出行业常态正是“短而人写的路由 + 生成的索引 + 全量转储”三层结构（Deno 四文件各一行职责；Turso、Typesense、Upstash、Exa、Zed、ParadeDB 为两层结构）。

4. 其余 agent 面向文件逐页拆解

4.1 agent-setup.md：面向 9 个客户端的 hub 页

一页枢纽：一条命令安装 skill → 选择你的 coding agent → 把提示词交给 agent。列出 9 个客户端并各带锚点。每个 .md 页都带同一个页脚：回指 llms.txt 的链接 + 同一块追加的 “Notes for AI Code Generators”。

Run the Skills CLI from your project directory:

```bash
npx skills add ComposioHQ/composio --skill composio

Choose your coding agent when prompted. See Clients for instructions for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenClaw, OpenCode, Cline, and Grok Build.

After installation, ask your agent to add Composio. It should inspect your framework, agent architecture, authentication, and user identity model before recommending an integration.

[...footer on every .md:] 📚 More documentation: View all docs | Changelog | Glossary | Examples | API Reference

### 4.2 `SKILL.md`：llms.txt 所指向的 86 行路由 skill

来源：`https://raw.githubusercontent.com/ComposioHQ/composio/next/skills/composio/SKILL.md`（HTTP 200）。它是一个**路由 skill**：选择产品（表格）、选择任务（5 个动词）、只加载相关的参考、11 条 “Stable rules”，以及一个 canonical-sources 块——指示 agent 去抓 `llms.txt` / `<page>.md` / 一个知识搜索 API。Frontmatter 的 description 写成给 skill-aware 宿主用的触发词列表：

```text
Use this skill as a router. Identify the product and the job, load only the relevant guidance, consult canonical documentation for volatile details, and then answer or do the work the user requested.
[...]
Do not turn an explanation, documentation lookup, or narrow bug fix into onboarding.
[...]
10. Do not invent repository facts. Never claim that a file, framework, environment loader, identity field, agent path, or dependency exists until it was provided or inspected. If codebase context is unavailable, state the unknown and ask for access or one necessary detail.
[...]
```text
https://docs.composio.dev/llms.txt
https://docs.composio.dev/docs/<page>.md
https://docs.composio.dev/toolkits/<toolkit>.md

If those primary sources do not answer a Composio product or troubleshooting question, query the public unified knowledge search at https://docs.composio.dev/api/knowledge-search?q=<question>. [...] Use the documentation to complete the task. Do not merely hand the user a link unless they asked for one.

注意第 10 条与 “Do not turn an explanation … into onboarding”：这是两条**显式的越权/虚构禁令**，XERJ 当时的文件中没有对应物（见第 5 节第 8 条）。

### 4.3 `unattended-authentication.md`：无人类在场路径

流程是：安装 → 以 agent 身份登录 → 提取 key（不打印）→ 用一次**真实工具调用**验证（成功判据逐条写明）→ 如果只有冒烟检查通过该报告什么。包含显式的反滥用约束和人类回退（`--no-wait` / `--poll`）：

```text
```bash
curl -fsSL https://composio.dev/install | sh
export PATH="$HOME/.local/bin:$PATH"
composio login --agent
composio agent whoami

[...] Check both the HTTP result and the response body. Require successful: true, no tool error, and profile data for the requested username. An HTTP 401, a tool schema lookup, or a successful build does not prove tool execution. A local mock verifies only the local code path. [...] Record the tool slug, sanitized result, and returned log ID if present. If only the Hacker News check succeeds, report that check separately from the requested integration action. If app authorization is unavailable, report the remaining connection step and leave the action unverified. [...]

• Use the supported CLI flow. Do not reverse-engineer browser signup, create disposable inboxes, or bypass browser challenges to obtain a Composio key.

这段是全研究中最常被引用的“验证判据”范式：**先定义什么算成功，再显式列出什么不算**（401、schema 查询、构建成功都不证明工具真的执行过；本地 mock 只验证本地代码路径）。总报告 M5 条目（“No way to know it worked”）即以它为例，指出 XERJ 当时的首跑清单没有任何验证步骤。

### 4.4 `clients.md`：逐 agent 的安装 + 粘贴提示词

对 9 个 agent 各给出：该 agent 从哪里加载 skill、带 `--agent <name>` 的全局安装与项目安装命令、“开一个新会话”、以及人类粘贴给 agent 的 3 行提示词：

```text
**Global install**

```bash
npx skills add ComposioHQ/composio --skill composio --agent claude-code --global

Project install

npx skills add ComposioHQ/composio --skill composio --agent claude-code

The Skills CLI installs the skill in Claude Code's skill directory. Start a new Claude Code session if the current session does not discover it, then ask Claude to add Composio to your project.

Use the /composio skill to get Composio working in this codebase.

Help me connect an integration and make my first real tool call.
When it works, show me what changed and what I can try next.

### 4.5 `composio-connect.md`：17 个客户端的 MCP 安装页

逐客户端 MCP 安装：Claude Code、Claude Desktop、ChatGPT、Cursor marketplace、OpenClaw、Codex、Warp、Grok、Gemini CLI、VS Code（GitHub MCP registry）、Windsurf deep link、Antigravity、Agent Builder、n8n、通用 JSON——共 17 个。对 CLI 可用的 agent，“安装”就是粘贴一行提示词；对 GUI 客户端，则是带视频的点击步骤：

```text
## Claude Code

#### Ask Claude Code to install Composio

Paste this prompt into Claude Code:

Install the Composio CLI: curl -fsSL https://composio.dev/install | sh, then run composio login.

[...]
Open `windsurf://windsurf-mcp-registry?serverName=composio` in Devin Desktop to install Composio.

4.6 agent-plugins.md：原生 Claude Code / Codex 插件

CLI 安装 → composio setup --target auto 自动探测并配置所有受支持的 agent 宿主；--yes 用于非交互/agent 运行；Claude Code 与 Codex 各有插件市场命令：

```bash
composio login
composio setup --target auto

auto detects Codex and Claude Code. If both are installed, it configures both.

Running setup from an agent or script?: Setup asks before changing local files. Add --yes in a non-interactive shell: composio setup --target auto --yes. [...]

/plugin marketplace add ComposioHQ/composio-plugin-cc
/plugin install composio@composio

### 4.7 仓库根部的 `AGENTS.md` 与 `CLAUDE.md`，以及一个 404

- **AGENTS.md**（`https://raw.githubusercontent.com/ComposioHQ/composio/next/AGENTS.md`，HTTP 200，4,992 字节）：面向贡献者的仓库规则——首步骤、约 20 个本地 skill 的路由表、仓库地图、不可编辑的生成/ vendored 路径、常用命令。**不是**产品安装文档：

```text
1. Read the nearest nested `AGENTS.md` before editing a subtree.
2. Preserve unrelated dirty work. Do not revert, delete, or reformat files outside the requested scope.
3. Treat `.agents/skills` as the canonical local skill tree. `.claude/skills` is a compatibility symlink and must not be edited as a separate copy.

• CLAUDE.md（HTTP 200，199 字节）：重定向到 AGENTS.md 的 shim——“Claude Code compatibility shim. Use AGENTS.md for repository guidance. Local skills are canonical under .agents/skills; .claude/skills points there for Claude-compatible clients.” 从源码结构看，这是“单一事实源 + 兼容软链”的做法：规则只写一份，宿主文件名只是别名。
• llms-install.md：HTTP 404，不存在。Cline 市场的 llms-install.md 约定未被 Composio 采用（研究中也确认主流基础设施项目均不发布该文件）。

5. 它比 XERJ 做得好的地方（9 条）

以下 9 条逐条引自拆解页的 “What they do better than XERJ”，并对照仓库中的现状（研究快照为 landing/llms.txt 在 commit 4d8dadbf 时的 234 行版本；当前 landing/llms.txt 已演进为 288 行，引用行号时需以当时版本为准）：

1. 长度与形态：50 行 / 4.4 KB 是“供 agent 自上而下执行的程序”，而 XERJ 是 234 行 / 40 KB 的索引。Composio 把一切非路由内容移到 llms-index.txt（45 KB）与 llms-full.txt（1.1 MB）——三个文件、职责明确，且 llms-index.txt 自己说 “For a shorter routing map, start at llms.txt”。
2. 无 shell / 无 skill 宿主的降级阶梯，一句话给出：“If it is missing, install it … requesting approval if your host requires it. If skills are unsupported or installation fails, use the documentation linked below and report that fallback.”——这正是 XERJ 研究中发现的、在每一档模型层级上都失败的 shell-less / MCP-only 人格。
3. “先问再动”内建：“If the intended workflow is unclear, ask … before making changes” 和 “If it is unclear whether the goal is to integrate Composio into the application or connect apps to the coding agent itself, clarify that first.” XERJ 的 llms.txt 没有等价的决策门，默认 agent 是在为自己安装。
4. 验证被定义为一次真实调用，判据写明，并显式列出什么不算通过：“An HTTP 401, a tool schema lookup, or a successful build does not prove tool execution. A local mock verifies only the local code path.” XERJ 的首跑清单没有验证步骤。
5. 逐客户端安装矩阵：9 个 coding agent 各带精确粘贴提示词、17 个 MCP 客户端，含一键/注册表链接（windsurf://、GitHub MCP registry、Cursor marketplace、Claude Code /plugin marketplace add）。XERJ 只文档化了面向 Claude Code/Cursor 的 xerj init（见 landing/llms.txt “First run” 第 3 步：在 .mcp.json 注册 MCP server、为 Claude Code/Cursor 写 10 行 skill），没有逐客户端页面。
6. 每个生成的 .md 页都带回指 llms.txt 的页脚，落在任何深页的 agent 都能找到路由器。
7. 工具链自身的 agent 模式标志：composio login --agent（无人、无浏览器）、composio setup --target auto --yes（非交互）、composio login --no-wait / --poll（人在场但无浏览器）。XERJ 有 xerj feedback --dry-run，但没有一条文档化的“无人/无浏览器 安装并验证”路径。
8. Skill 携带显式越权禁令而 XERJ 缺少：“Do not turn an explanation, documentation lookup, or narrow bug fix into onboarding.” 与 “Do not invent repository facts.”
9. （协调者报告，拆解者本人未验证）：Composio 的 llms.txt 自其首版文档起就被重写成 agent-first；追加在每个页面的 “Notes for AI Code Generators” 块针对的是生成代码中实际观察到的错误（错误的 provider 包名、过期术语）。

6. XERJ 做得更好的地方（6 条）

拆解页同样记录了反向差距，这些是研究 README “§5 不要回退”清单的具体来源：

1. 反馈通道：Composio 的 llms.txt 在 50 行里零次 feedback/contribute/issue/PR 请求；整个语料库唯一的支持 CTA 是 “support@composio.dev or join the Composio Discord”。XERJ 至少有一个字段报告机制（field report）加一条命令路径（xerj feedback --open-pr）和 CLA 豁免的单文件 PR 契约（见 AGENTS.md 的 “If you used XERJ, you owe it a field report” 与 user-feedback/16-agent-field-reports/README.md）。
2. Caveats 内联且诚实：XERJ 的 Caveats 段直面“默认嵌入是词法而非神经”这一陷阱；Composio 的 llms.txt 根本没有 caveats/limitations 段。
3. 安装坑被写明：XERJ 显式文档化了“不编辑 profile 的安装器带来的 PATH 后果”与“数据目录落在被索引文件夹内”的陷阱；Composio 的 llms.txt 没有任何安装坑（它们只存在于 CLI 页）。
4. 自足性：XERJ 的 llms.txt 自足到可以不跟任何链接就把产品跑通（安装、起节点、autoindex、查询）；Composio 的 llms.txt 不跟至少一个链接就无法安装产品。
5. 机器可读工具 schema：XERJ 发布三种形态的工具 schema（landing/llms.txt 末尾列出 mcp-tools.json、openai-tools.json、anthropic-tools.json，由真实 tools/list 生成）；Composio 的 llms.txt 不链接任何 schema。
6. 数字可追溯：XERJ 的数字有出处（“measured 2.7× fewer output tokens … 16/16 tasks solved”）；Composio 唯一的数字是营销话术 “1,500+ toolkits”。

7. 可采纳想法：8 条带 XERJ 版本文案的提案

拆解页最后给出 8 条 “Adoptable ideas”，每条都配了一个可直接落笔的 XERJ 版本。其中多数已在 docs/research/llms-txt-2026-09/proposals/ 的提案文件中成形（注意：提案不改动任何线上文件——landing/llms.txt、llms-full.txt、AGENTS.md 在研究提交时都未被触碰，因为规则第 10 条“同一时间只有一个 PR 编辑 landing/llms.txt”先于一切）：

1. 把 “Before you implement / Before you install” 作为第一个 H2，置于 “Start here” 之上，内容为失败降级阶梯。XERJ 版：“If you have a shell: curl -fsSL https://xerj.org/get | sh. If your host requires approval for installs, request it. If you have no shell, use the HTTP-only path … and say so in your field report.”——对应的成品可见 docs/research/llms-txt-2026-09/proposals/proposed-llms.txt 开头的三条能力分支（Shell / MCP / HTTP only）。
2. 安装之前加一道决策门（对标 llms.txt 第 13 行的 “clarify that first”）。XERJ 版：“If it is unclear whether the goal is to index the user's data for them or to give yourself a reference-coding corpus, clarify that first.”
3. 把字段报告请求移出 ## Optional，只放进首跑编号清单，并重命名单节。Composio 的 “## Optional” 只有 changelog/索引/KB 链接，没有任何对 agent 的请求——而 XERJ 当时的文件里，第 7 行说字段报告 “required, not optional”，模板却挂在名为 ## Optional 的标题下（研究快照第 223 行），标题名与“强制”自相矛盾；在 llms.txt 约定里 ## Optional 意味着“上下文紧张时可跳过”，agent 一旦剪掉它就把义务整个丢了。提案建议改为 “## Your side of the deal” 之类，并让协调者做 A/B 测试看 PR 到达率是否变化。对照仓库现状：当前 landing/llms.txt 的 ## Optional 段（第 277 行起）中的条目已命名为 “Your side of the deal — the field report”（第 279 行），即命名部分已被采纳，而“移出 Optional”这一条仍待处理。
4. 用“不算通过清单”定义验证（对标 unattended-authentication.md 的判据）。XERJ 版：“Require a hits.total.value > 0 on a query for a string you know is in the indexed folder. A green /_cluster/health, a --dry-run, or xerj --version does not prove indexing worked.” 并把字段报告与之挂钩：“Record the query, the hit count and the version; that is the body of the field report.”——该判据同样已出现在提案文件里（“A green health check, a finished --dry-run or a version string does not prove indexing worked. One hit you opened and confirmed does.”，见 proposals/proposed-llms.txt）。
5. 加一个 “Running as an unattended agent?” 醒目提示框（对标 quickstart.md 的 composio login --agent callout）。XERJ 版：“No gh, no human? Run xerj feedback --dry-run, paste the printed report into your final message, and tell the operator the file path to commit. The obligation transfers rather than disappearing.”——这句话当时其实已存在于 llms.txt 第 24 行（首跑清单第 5 条）的中段，提案是把它升级为 blockquote 使其显眼。
6. 做一个逐客户端安装页，每个 agent 配 3 行粘贴提示词（对标 clients.md 的 “Use the /composio skill to get Composio working in this codebase. …”）。XERJ 版：“Install XERJ with https://xerj.org/get, index this folder, run one search that proves it works, then file the field report with xerj feedback --open-pr. Show me what changed.” 至少覆盖 Claude Code、Codex、Cursor、Copilot、Gemini CLI、Cline、OpenCode，每个配 xerj init --agent <name>（若存在）或 .mcp.json 片段。
7. 把文件拆成三个并写明角色（对标 llms-index.txt 第 5 行的 “For a shorter routing map, start at llms.txt”）。XERJ 版：保留约 60 行的 llms.txt 路由器（Before you install / Start here / Caveats / Choose your path / Your side of the deal），把 100 多条 Answers/Comparisons 链接移入 llms-index.txt，llms-full.txt 留给深度参考。
8. 给每个生成的 .md/answers 页加页脚（对标 Composio 每页的 “📚 More documentation: …” 页脚）。XERJ 版：“More: [llms.txt] | [Caveats] | [File a field report]”——把报告请求放到 agent 从搜索落地可能到达的每一个页面上，而不只在索引页。

8. 证据标签体系与延伸阅读

这份拆解页的价值一半来自结论，另一半来自它所处的证据体系。做同样的研究或复核这些数字时，建议按以下路径阅读：

• 证据标签：修订版报告 docs/research/llms-txt-2026-09/proposals/report.md 为每条引用分配检查 id（如 [A02] 即 Composio 的失败降级阶梯那句），标签分五级：SAYS（别人发布文件里的文字，带 id）、RAN（在 xerj v1.0.0-rc.74 上真实执行，转录在 proposals/data/xerj-cli-verification-2026-09-19.md）、READ（从 XERJ 源码读出，未执行）、MEASURED（由脚本对 132 个 llms.txt 计算）、INFER（解读而非事实）。
• 可复核性：docs/research/llms-txt-2026-09/scripts/ 下的 build_tables.py、build_pages.py、factcheck.py、measure_llms_txt.py、check_links.py 等脚本可让任何人约两分钟内重跑全部检查；comparison-table.md 带 --check，数据源变动即失败。
• 漂移提醒：生成型索引文件一天之内就会变（研究记录中 ClickHouse 的 llms.txt 当晚从 103,444 B 漂移到 103,065 B）。总 README 的告诫是：“The web changes. Re-measure before quoting any number here in public.”
• XERJ 侧的现状文件：landing/llms.txt（agent 路由索引，含 Caveats 与首跑清单）、landing/llms-full.txt（84 KB 精选参考，可放进一个上下文窗口）、AGENTS.md（仓库规则，含字段报告义务）、.github/AI_CONTRIBUTIONS.md（agent 贡献协议）、user-feedback/16-agent-field-reports/README.md（报告模板）、demo/playbooks/AGENT_FTX_HARNESS.md（规则第 11 条要求改动前后重跑的“首次 agent”测试框架）。
• 同类拆解页：docs/research/llms-txt-2026-09/per-project/ 目录下还有 46 个项目的同构拆解（如 AI SDK 的能力分支、Deno 的四文件分工、Neon 的无鉴权 POST 反馈脚注），可与本页并读，注意总 README §1 的提醒：各拆解 agent 都被事先告知了 XERJ 的已知差距，所以“在 46 份拆解里都出现的批评”是简报的回声，独立证据是各 agent 在对方文件里找到的引文、尺寸、片段与 URL。

9. 小结

Composio 的 agent 文档体系给出的核心方法论是：把给 agent 的入口文件写成一份 50 行、可自上而下执行的程序，而不是 40 KB 的索引——路由、安装、验证判据、降级阶梯全部前置；把深度内容分层到 llms-index.txt（完整索引）与 llms-full.txt（全文拼接，每页带 “Notes for AI Code Generators” 纠错块）；把“什么算成功、什么不算”写成显式判据；把逐客户端安装矩阵做到 9 个 coding agent + 17 个 MCP 客户端的粒度，且每个客户端只要求粘贴一段 3 行提示词。代价是 llms.txt 自身不再自足（不跟链接装不了产品）、也没有任何反馈通道。XERJ 一侧的优势恰好互补：自足的可运行流程、内联且诚实的 Caveats、机器可读 schema、可追溯数字与字段报告机制。研究沉淀的 8 条采纳提案（能力分支、决策门、验证判据、逐客户端页、三文件拆分、全页页脚等）已经成形于 proposals/ 目录，等待按“单一 PR”规则落地——这正是 docs/research/llms-txt-2026-09/README.md §6 所列 12 条变更规则要约束的对象。

【免费下载链接】xerj

XERJ is the new way for AI to search data. Its autoindex capability activates agents to know your data without the token waste of grep and sed. One command indexes code, docs, logs and PDFs for search, RAG, security audits and agent memory, using 40x fewer tokens than grep. Elasticsearch compatible, so existing clients just work.

项目地址： https://gitcode.com/GitHub_Trending/xe/xerj

点击查看 免费下载