AI Readiness Kit

AI Readiness Skill

只需一条命令，即可为任何网站生成一整套 AI 就绪文件（GEO / 生成式引擎优化），包括 llms.txt、ai.txt、schema、RAG 索引等。只需一条 npx 命令，即可将其安装到 Claude、Cursor、Windsurf、GitHub Copilot、Gemini 或 Codex 中；也可以通过 MCP 连接，无需安装。

📖 在线网站与完整文档： ai.silverbackmarketing.com · 如果它能帮助你被 AI 发现，请为此仓库点个 ⭐。

---

什么是 AI Readiness Kit？

AI Readiness Kit 是一套免费、开源的 17 个结构化文件，你可以将其部署在网站根目录下，包括 robots.txt、ai.txt、llms.txt、schema、RAG 索引等。这些文件会告诉 ChatGPT、Claude、Gemini 和 Perplexity 你是谁、提供什么，以及应如何介绍你。只需一条命令，即可生成整套文件，并针对任何网站进行定制。永久免费（MIT）；可通过 npx 安装，也可通过 MCP 运行，无需安装。

---

为什么需要 AI 就绪

当人们想要产品推荐、服务提供商或直接的答案时，往往会先问 ChatGPT、Claude、Gemini 或 Perplexity，而不是先访问网站。如果你没有向这些系统提供清晰、最新的信息，它们就会猜测——而且常常猜错。

AI 就绪文件是部署在网站根目录下的结构化文件，用来明确告知 AI 系统 你是谁、提供什么，以及应该把用户引导到哪里。这些文件采用 AI 已经理解的格式（llmstxt.org 标准、Schema.org 以及新兴的 AI 爬虫惯例），这样助手就不会再根据过时的训练数据猜测你的品牌，而能在回答中准确介绍你。

此 Skill 会研究任何网站、识别其行业，并通过一条命令为你生成所有这些文件，且针对相应业务进行定制。

---

目录

• 安装
• 通过 MCP 使用（无需安装）
• 功能说明
• 文件列表
• 用法
• 常见问题
• 参考文档
• PDF 指南
• 技能文件结构
• 作者与公司
• 许可证

---

安装

快速安装（适用于任何 Agent）— npx

# Global skill install → ~/.agents/skills/ AND ~/.claude/skills/ (default)
npx @silverbackmarketing/ai-readiness install

# AGENTS.md — the cross-agent standard (Cursor, Codex & others)
npx @silverbackmarketing/ai-readiness install --agent agents

# Both at once (recommended)
npx @silverbackmarketing/ai-readiness install --all

主要目标：

目标	安装位置
skills	~/.agents/skills/ai-readiness/ 和 ~/.claude/skills/ai-readiness/（完整技能 — SKILL.md + 脚本 + 参考资料）
agents	./AGENTS.md — Cursor、Codex 及越来越多的 Agent 会读取的标准文件（添加带分隔符的内容块，并保留现有内容）
claude	仅 ~/.claude/skills/ai-readiness/

对于基于提示词的 Agent，AGENTS.md 是默认且推荐的目标——大多数现代 Agent 现在都会读取它。如果你更喜欢使用特定工具的文件，也可以选择：

可选目标	安装位置
cursor	./.cursor/rules/ai-readiness.mdc
windsurf	./.windsurf/rules/ai-readiness.md
copilot	./.github/copilot-instructions.md（带分隔符的内容块）
gemini	./GEMINI.md（带分隔符的内容块）
generic	./ai-readiness.SKILL.md（可粘贴到任何系统提示词中）

除 Claude 以外的目标会安装到当前目录，因此请在项目根目录中运行命令。--all 会安装 Claude + AGENTS.md。添加 --force 可覆盖现有内容，添加 --dir <path> 可更改目标。对于共享文件，安装时会插入带标记的内容块；再次运行时会就地更新，因此不会覆盖你的其他指令。

其他安装选项

• Claude Cowork 一键安装： 下载并打开 ai-readiness.skill。
• 任何 AI，手动安装： 将 SKILL.md 复制到助手的系统提示词或自定义指令中。

安装后，在 Claude 中使用 /ai-readiness yoursite.com 触发，或直接向任何 Agent 提出请求：“为 yoursite.com 创建 AI 就绪文件。”

通过 MCP 使用（无需安装）

将编码 Agent 连接到托管的 MCP 服务，而不是在本地安装技能。工作流相同——研究网站并生成所有文件。

生产环境： https://ai.silverbackmarketing.com/api/mcp

连接后可使用的提示词示例：

Generate AI readiness files for example.com
Use ai-readiness to list all output files
Get the file spec for llms.txt from ai-readiness

Cursor — 添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "ai-readiness": {
      "url": "https://ai.silverbackmarketing.com/api/mcp"
    }
  }
}

刷新 MCP 服务，然后询问：“使用 ai-readiness 为 example.com 生成文件”

Claude Code — 将 .mcp.json 添加到项目根目录：

{
  "mcpServers": {
    "ai-readiness": {
      "type": "http",
      "url": "https://ai.silverbackmarketing.com/api/mcp"
    }
  }
}

或者运行：

claude mcp add --transport http ai-readiness https://ai.silverbackmarketing.com/api/mcp

重启会话，运行 /mcp，然后询问：“使用 ai-readiness 为 mysite.com 生成 AI readiness 文件”

VS Code / Copilot — 添加到 .vscode/mcp.json：

{
  "servers": {
    "ai-readiness": {
      "type": "http",
      "url": "https://ai.silverbackmarketing.com/api/mcp"
    }
  }
}

打开 MCP: List Servers，确认 ai-readiness 正在运行，然后在 Copilot Chat 中使用 Agent 模式。

Claude Desktop — 在 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）中使用 mcp-remote：

{
  "mcpServers": {
    "ai-readiness": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://ai.silverbackmarketing.com/api/mcp"]
    }
  }
}

保存后，完全退出并重新打开 Claude Desktop。

OpenAI Codex — 添加到 ~/.codex/config.toml：

[mcp_servers.ai-readiness]
url = "https://ai.silverbackmarketing.com/api/mcp"
enabled = true

或者运行 codex mcp add ai-readiness --url https://ai.silverbackmarketing.com/api/mcp，然后在会话中运行 /mcp。

Antigravity — Agent 面板 → … → MCP Servers → Manage → View raw config：

{
  "mcpServers": {
    "ai-readiness": {
      "serverUrl": "https://ai.silverbackmarketing.com/api/mcp"
    }
  }
}

Antigravity 使用 serverUrl（而非 url）。保存并刷新，然后在 Agent 模式下试用。

Perplexity — 有两种方式使用该工具包：

• 通过远程 MCP 连接器 — 需要付费的 Perplexity 方案；组织管理员可能需要先启用“Allow members to add custom connectors”。 前往 Account settings → Connectors → 点击 + Custom connector（右上角）→ 选择 Remote，然后填写：

  字段	值
  名称	AI Readiness
  MCP 服务 URL	https://ai.silverbackmarketing.com/api/mcp
  身份验证	None
  传输方式	Streamable HTTP

  勾选确认框，点击 Add，然后点击连接器卡片以启用。询问：“使用 ai-readiness 为 example.com 生成文件。”（完整步骤：Perplexity 的添加自定义远程连接器指南。）

• **手动 — 免费，适用于任何方案：**将 SKILL.md 粘贴到对话中（或将其作为附件），然后询问：“按照这些 AI readiness 说明，为 example.com 生成 AI readiness 文件。”

快速测试：

curl -X POST 'https://ai.silverbackmarketing.com/api/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":1}'

更多客户端配置：ai.silverbackmarketing.com/#mcp

---

功能说明

运行 /ai-readiness yoursite.com，AI 会研究该网站、识别其所属行业，并生成可用于生产环境的文件，向 AI 系统（ChatGPT、Claude、Gemini、Perplexity 等）准确说明网站的内容、提供的服务，以及用户应前往何处。

将这些文件部署到网站根目录后，可以改善网站在 AI 生成的回答、摘要和推荐中的呈现效果——对于希望在 AI 驱动的网络中获得曝光的企业来说，这是必备之选。

这些文件

此技能会生成 18 个文件。其中，17 个文件会部署到网站根目录，分为 7 个类别（如果省略可选的 .well-known/ai-plugin.json，则为 16 个）；第 18 个文件 README.md 是供团队使用的项目文档。这与线上网站介绍的 17 文件套件一致。

#	文件	用途	已部署
1	ai.txt	主要 AI 身份声明	✅
2	llms.txt	简明、便于大模型读取的网站摘要	✅
3	llms-full.txt	全面的 LLM 知识库	✅
4	ai-sitemap.xml	面向 AI 优化的网站地图	✅
5	sitemap.md	供 AI 获取上下文的人类可读网站地图	✅
6	ai-entities.json	结构化实体定义	✅
7	ai-intent.json	用户意图与查询映射	✅
8	ai-schema.json	Schema.org 结构化数据	✅
9	rag-index.json	RAG 检索知识库	✅
10	rag-index.jsonl	用于嵌入流程的 JSONL 格式	✅
11	ai-disclosure.txt	AI 内容透明度声明	✅
12	training-data-policy.txt	数据使用与训练政策	✅
13	.well-known/ai-plugin.json	面向 AI Agent 的插件清单（可选）	➖
14	structured-data-guide.md	开发者实施指南	✅
15	manifest.json	Web 应用清单	✅
16	deployment-checklist.md	部署分步指南	✅
17	robots.txt	AI 爬虫指令	✅
18	README.md	项目文档（不部署）	➖

---

使用方法

在 Claude Cowork 中，输入：

/ai-readiness yoursite.com

或者使用自然语言：

create AI readiness files for acmecorp.com
make my site AI-ready: hubspot.com
generate llms.txt for shopify.com

Claude 将会：

1. 执行 10 次以上有针对性的搜索，研究网站
2. 判断网站类型（SaaS、电子商务、教育、医疗保健等）
3. 生成适用于相应行业的全部文件
4. 将所有文件保存到工作区中以域名命名的文件夹

---

常见问题

入门

什么是 AI 就绪文件？ 这些结构化文件部署在网站根目录，用于准确告知 AI 系统你是谁、提供什么，以及应该将用户引导到哪里。它们采用 AI 已能理解的格式，让助手不再依据过时的训练数据猜测你的品牌信息。

为什么现在 AI 就绪度很重要？ 当人们想要产品推荐、服务提供商信息或明确答案时，往往会先询问 ChatGPT、Claude、Gemini 或 Perplexity，然后才访问网站。如果你没有向这些系统提供清晰、最新的信息，它们就会自行猜测，而且往往猜错。

套件中有多少个文件？ 套件包含 7 个类别的 17 个专用文件：身份与权限、内容文件、地图与导航、智能文件、研究文件、政策文件和运营文件。每个文件都有助于 AI 更准确地理解和呈现你的网站。（此技能总共会生成 18 个文件——多出的一个就是项目的 README.md。）

应该从哪里开始？ 先从关键文件开始：robots.txt、ai.txt、llms.txt 和 llms-full.txt。它们能立即带来最大成效，也是大多数 AI 系统首先查找的文件。然后根据部署清单添加网站地图、智能 JSON 文件、政策文件和运营文件。

身份与权限

robots.txt 对 AI 有什么作用？ robots.txt 位于网站入口处，用来告知自动访问者（搜索引擎、AI 机器人和抓取工具）可以访问哪些部分。为了让网站做好 AI 准备，它会包含针对 GPTBot、OAI-SearchBot、ClaudeBot、Claude-SearchBot、PerplexityBot 和 Bingbot 等主要爬虫的指令，引导它们访问你的 llms.txt 和 ai-sitemap.xml，同时禁止它们访问结账、登录和管理页面。

什么是 ai.txt？ ai.txt 是你的品牌向互联网上所有 AI 系统作的自我介绍。robots.txt 控制访问权限，而 ai.txt 更进一步。它涵盖你销售的产品、你的知名领域、权威主题，以及 AI 系统可以和不可以如何使用你内容的规则。

ai.txt 和 robots.txt 有什么区别？ robots.txt 控制访问权限：机器人可以抓取哪些页面。ai.txt 确立身份：你是谁、你提供什么，以及 AI 使用你内容时应遵守的基本规则。可以把 robots.txt 想象成门卫，而 ai.txt 则是你在采访前交给记者的情况介绍文件。

内容与导航

什么是 llms.txt？ llms.txt 是为大模型打造的结构化文本文件。它为 AI 提供网站的快速导航：公司名称、描述、带有直接链接的分类内容，以及网站解答的常见问题。它遵循 llmstxt.org 标准，ChatGPT、Claude、Gemini 和 Perplexity 均使用该标准。

llms.txt 和 llms-full.txt 有什么区别？ llms.txt 是速查表：AI 可以在几秒内浏览完的简短摘要。llms-full.txt 则是深入介绍，包含丰富的描述、详细的问答和完整的分类说明。如果说 llms.txt 是维基百科摘要，那么 llms-full.txt 就是完整文章。

为什么需要 ai-sitemap.xml？ 常规站点地图会列出页面和时间戳。ai-sitemap 还会说明每个页面的主题、内容类型以及通俗易懂的摘要。这就像纸质路线图与标有兴趣点的 GPS 之间的区别。AI 爬虫无需逐个获取并解析页面，就能理解页面内容。

智能与研究

什么是 ai-intent.json？ ai-intent.json 将真实用户的问题（人们输入 AI 助手的内容）映射到网站上最适合回答每个问题的页面。没有它，AI 只能猜测应该推荐哪个页面。有了它，你就能为每个常见查询提供直接 URL。

ai-entities.json 和 ai-schema.json 有什么用途？ ai-entities.json 是网站重要内容的结构化目录，包括产品、分类、服务和关键概念。它为 AI 知识图谱提供支持。ai-schema.json 使用 Schema.org 标准，以机器可读的格式描述你的组织，让搜索引擎和 AI 系统能够准确识别你。

什么是 RAG 索引文件？ rag-index.json 和 rag-index.jsonl 是为 AI 研究和检索流水线构建的现成网站索引。用户提出问题时，AI 会先从该索引中提取最相关的文档，再生成回答，从而确保回答以你的实际内容为依据。

政策与维护

什么是训练数据政策？ training-data-policy.txt 规定了 AI 公司如何使用你的内容的正式规则，包括模型训练、RAG 索引和商业用途。它回答了每个品牌都应提前决定的一个实际问题：他人可以如何使用你的作品？

什么是 ai-disclosure.txt？ ai-disclosure.txt 是一份公开透明报告，说明你的组织如何使用 AI，包括内容生成、推荐或客户互动。它能在人们提出疑问之前就予以解答，从而建立信任。

我应该多久更新一次 AI readiness 文件？ 这取决于具体文件。每月更新 llms.txt 和站点地图，或在网站结构发生变化时更新。每季度更新 ai.txt 和 llms-full.txt，或在产品发生变化时更新。每年审查一次政策文件。manifest.json 文件列出了套件中每个文件的建议更新频率。

---

参考文档

references/file-specs.md 文件包含每个文件的详细规范，包括必需的结构、关键字段和精简示例。运行该技能时会自动加载此文件。

scripts/gen_jsonl.py 工具可将 rag-index.json 转换为 rag-index.jsonl 格式，以便用于嵌入流水线：

python3 scripts/gen_jsonl.py rag-index.json rag-index.jsonl

---

PDF 指南

docs/ 文件夹中包含 PDF 参考指南，以通俗易懂的语言和技术细节介绍每个文件：

指南	适用对象	涵盖文件
AI Readiness Guide — With Plugin	普通 / 非技术人员	全部 17 个文件，含 ai-plugin.json
AI Readiness Guide — No Plugin	普通 / 非技术人员	16 个文件，不含 ai-plugin.json
Developer Reference — With Plugin	Web 开发者	全部 17 个文件，精简技术格式
Developer Reference — No Plugin	Web 开发者	16 个文件，精简技术格式

---

技能文件结构

ai-readiness/
├── ai-readiness.skill          ← Claude Cowork installable skill (download & open)
├── SKILL.md                    ← Raw skill definition — works in any AI assistant
├── README.md                   ← This file
├── references/
│   └── file-specs.md           ← Detailed specs for all output files
├── scripts/
│   └── gen_jsonl.py            ← JSONL generator utility
└── docs/
    ├── ai-readiness-guide-with-plugin.pdf
    ├── ai-readiness-guide-no-plugin.pdf
    ├── ai-readiness-guide-dev-with-plugin.pdf
    └── ai-readiness-guide-dev-no-plugin.pdf

---

作者与公司

Russ Wittmann — Silverback Marketing 技术高级副总裁 LinkedIn · X / Twitter

位于亚利桑那州 Queen Creek 的 Silverback Marketing 是一家专注于投资回报率的数字营销机构（成立于 2007 年），通过战略、内容和技术助力企业发展。该技能是 Silverback AI readiness 服务的一部分，旨在帮助客户在 AI 搜索时代被发现。

🔗 ai.silverbackmarketing.com · silverbackmarketing.com

---

许可证

MIT — 可免费使用、修改和分发，但须注明出处。请参阅 LICENSE。