docs-skills: AI代理的模块化能力

在2026年，AI代理不仅仅是阅读文档——它们还会对其采取行动。它们发布文档网站，修复断开的链接，生成 llms.txt，编写缺失的页面，审计可访问性。它们知道如何执行这些操作的方式是通过“技能”——打包的、可发现的、声明式的能力描述。

本文解释了什么是技能，为什么Docsbook发布了25个技能的开源目录，以及这如何在MCP和您的内容之间适配。

简而言之#

• “技能”是一个 SKILL.md 文件，包含描述能力的前置信息——它的功能、何时触发、需要哪些工具
• AI 代理（Claude Code, Cursor）读取技能并自主执行
• docs-skills 是一个包含 25 个文档技能的开源目录
• Docsbook MCP 暴露 find_skill，以便代理在运行时通过查询发现技能
• 您可以在本地安装技能 (npx docs-skills install) 或通过 MCP 使用它们

技能的样子#

一个最小的 SKILL.md:

---
name: docs-pr-check
description: Validate documentation changes in a pull request — check for broken links, missing frontmatter, accessibility issues, and SEO regressions. Use when reviewing docs PRs.
category: automation
requires_plan: free
---
 
# docs-pr-check
 
When the user opens a docs PR, run this skill to validate the change.
 
Steps:
 
1. Run `doc_search_unresolved` to find broken links in changed files
2. Verify YAML frontmatter on every new or modified `.md` file
3. Check that internal links resolve
4. Suggest improvements
 
Tools used: `doc_search_unresolved`, `doc_outline`, `doc_resolve_link` (Docsbook MCP)

前言是合同。主体是提示。

这对文档的重要性#

技能解决的三个问题：

1. 能力的可发现性#

没有技能，阅读您文档的 AI 代理必须猜测该做什么。有了技能，代理调用 find_skill("audit my docs") 并获得带有确切指令的 SKILL.md。

2. 模块化重用#

为一个项目编写的技能适用于任何项目。 docs-pr-check 技能适用于任何文档库。 docs-tune-ai-chat 技能适用于任何 Docsbook 工作区。

3. 组成#

技能可以链式连接。docs-analyze 技能将 10 个子技能 (docs-seo, docs-accessibility, docs-i18n, 等等) 编排成一个单一的审计运行。这个组成在 SKILL.md 中是声明性的。

文档技能目录#

docs-skills 是一个包含五个类别的 25 种技能的开源目录：

每个技能都是 GitHub 仓库中的独立 SKILL.md。有些技能相互关联。

使用技能的两种方式#

本地安装#

npx docs-skills install

将目录复制到 .claude/skills/，.cursor/rules/ 或 AGENTS.md（取决于检测到的工具）。离线工作。使用 docs-skills update 更新。

此模式：您的工具技能存储在您的代码库中，进行版本控制。

通过 MCP 进行运行时发现#

如果您连接了 Docsbook MCP，您的代理将调用：

find_skill({ query: "audit my docs for SEO and accessibility" })

它返回与 raw_url 相关的最佳匹配技能，每个 SKILL.md。代理获取并遵循指令。

这种模式：无需本地安装，始终是最新版本，适用于多台机器。

AI代理如何在实践中使用技能#

我们见过的三个真实工作流程：

工作流程 1：PR 审查#

开发者打开一个涉及 docs/ 的 PR。他们的 Claude Code（或 Cursor）调用 docs-pr-check。该技能：

1. 列出更改的 .md 文件
2. 对每个文件调用 doc_search_unresolved
3. 检查前置信息的完整性
4. 将发现报告为 PR 评论

开发者在人工审查者之前查看报告。许多文档问题从未到达团队。

工作流程 2：过时内容检测#

用户设置中的每周 cron 调用 docs-stale-watcher。该技能：

1. 查询 Docsbook 分析，寻找 90 天以上没有编辑但有流量的页面
2. 与文档图进行交叉引用
3. 列出待更新的候选项

输出是一个待更新页面的积压 — 具有收入信号的内容缺口。

工作流程 3：AI 聊天调优#

用户说“我的 AI 聊天在关于特性 X 的问题上出现了幻觉。”代理调用 docs-tune-ai-chat。该技能：

1. 调用 get_ai_questions 以查看最近未回答的查询
2. 调用 get_negative_feedback 以查看差评模式
3. 识别缺失或薄弱的内容
4. 建议新页面或系统提示的更改

这是“代理改善代理”的循环。

技能 + MCP：架构#

技能告诉代理该做什么。MCP 工具告诉代理如何做。

• 一个技能说“审核每个页面的可访问性”
• 技能主体列出步骤，例如“在每个页面上调用 doc_list_pages，然后 doc_outline”
• MCP 显示技能调用的实际工具

单独使用都不够。它们共同形成一个完整的循环：发现（find_skill）→ 指令（SKILL.md）→ 执行（MCP 工具）。

这对您自己的文档看起来像什么#

如果您发布面向开发者的产品，并希望 AI 代理能够良好地与您的文档互动，请遵循三个步骤：

1. 在具有 llms.txt 的平台上发布 — Docsbook 会为每个工作区自动生成一个
2. 暴露 MCP 服务器或依赖于平台的 — Docsbook MCP 已包含
3. 在本地安装相关的文档技能 — npx docs-skills install

之后，任何代理（Claude Code、Cursor、带有 HTTP MCP 的 ChatGPT）都可以自主地与您的文档进行工作。

构建您自己的技能#

如果您有一个不在目录中的文档工作流程，请贡献一个。SKILL.md 格式简单，目录是公开的，贡献在几天内发布。

一个有用的技能是：

• 具体的（一个工作，做得好）
• 可组合的（调用现有的 MCP 工具）
• 由明确的用户意图触发
• 附有示例的文档

该仓库有一个 SKILL.md 模板和一个贡献指南。

相关阅读#

• 文档的MCP服务器 — 技能下方的层
• 如何让文档被ChatGPT引用
• llms.txt：完整指南
• AI文档平台比较（2026）

Docsbook 提供文档技能支持 — find_skill MCP 工具加本地安装。 从Claude Code连接 →