分数可以测可达,被加载的仍须是批准态知识:GitBook 推出 Docs AI Toolkit 之后的内容基础设施验收
内容基础设施验收,指的是当文档站可以被打上 Agent 可达性分数、并被打包成智能体可加载的技能时,仍要核对被加载的知识、截图和口径是否还指向 Knowledge Base、DAM 与 CMS/Website 里的批准态对象。2026 年 11 月 16 日,GitBook 宣布推出免费的 Docs AI Toolkit,为任意文档站提供文档技能、SKILL.md 生成器和 Agent score。本文据此给出验收清单:分数可以测可达,被加载的仍须是已批准、可追溯的知识。
浏览 3
巴克励步
内容基础设施验收,指的是当文档站可以被打上 Agent 可达性分数、并被打包成智能体可加载的
SKILL.md 时,仍要核对被加载、被引用的知识、截图和对外口径,是否还指向 Knowledge Base 里的批准版本、DAM 里的批准态资产,以及 CMS/Website 正式发布的那一层体验。2026 年 11 月 16 日,GitBook 宣布推出 Docs AI Toolkit:一组可安装到智能体里的文档技能、一个把文档站 URL 转成 SKILL.md 的生成器,以及用于检查智能体能否到达、解析并使用文档的 Agent score。工具本身是免费的,官方写明适用于任意文档站,也不要求注册 GitBook 账号。对品牌、知识和内容团队,这比「又多了一套文档体检」更值得先问一句:分数可以测可达,被加载的仍须是批准态知识。这与站内「结构优先,AI 其次」和「可见性可以监测,被引用的仍须是批准态内容」是同一类判断,只是工作面换了:上一篇讨论的是体验平台把答案引擎可见性买进来之后,监测结果会不会回流到真相源;这一篇要验收的是,文档站把「给智能体打分、把文档生成技能」开放出来之后,被智能体加载的究竟是不是已经审批、仍在使用、可以追溯的知识。垂直评测可以去比较谁的分数更细、谁的技能更好用;更值得先核对的是:被打分的 URL、被写成技能的那批页面,以及页面里的截图和口径,能不能回到知识库、DAM 和 CMS/Website 里已经批准的对象。
一、官方实际发布了什么
GitBook 把这套工具写成三块。第一块是五份文档技能(documentation skills),也就是智能体按需加载的
SKILL.md 指令包,可加入 Claude、Cursor、Codex、Gemini CLI 以及其他支持该格式的智能体。按官方说明,五份技能分别是:- AI readability check:检查并修改文档页,使 AI 助理和检索系统更容易切分、检索和引用。
- Humanizer:审读或改写带有 AI 腔的文档、发布说明和 README,使其更接近熟练技术作者的行文。
- Prerequisite gap checker:找出任务页里被默认假定、却从未写明的步骤、权限和准备条件。
- Release notes writer:根据 PR、提交、工单和 diff 起草面向用户的发布说明和更新日志。
- SEO and AEO documentation:在不牺牲可读性和准确性的前提下,创建、编辑或审阅面向 SEO 与答案引擎优化的文档。
技能源码放在 GitbookIO/docs-skills。官方写明:这些技能适用于任意文档,不论托管在哪里。
第二块是 Skill generator。它接受一个文档站 URL,生成可在 Claude、Cursor、Codex、Gemini CLI 以及官方所称的 30 多家其他智能体中使用的
SKILL.md。官方的表述是:智能体可以立刻以它们能使用的格式获得产品知识,且无需账号。第三块是 Agent score。它检查智能体能否到达、解析并使用文档,基础是 Dachary Carey 的开源库 afdocs,再加上 GitBook 自己的若干检查项。工具页把这三块放在同一入口,并在常见问题里再次确认:技能免费、不限 GitBook 文档站、也不需要账号。
更新说明没有把 Agent score 的逐项评分规则、生成技能时会收入哪些页面、以及文档更新后技能是否自动重生成写成一份完整规格。因此,验收时应把它写成一套已经公开可用的文档面向智能体工具,而不是一份已经完成的知识治理方案。
二、分数测量的是可达,不是批准态
GitBook 把这类工作称为 agent experience(AX):智能体能否找到信息,并用来完成任务。在 11 月 13 日的产品说明里,它回顾了自己在 2026 年春季的研究,并写到:在 GitBook 托管的文档中,有意图的阅读里,AI 智能体占 51.8%,人类占 48.2%。更完整的方法写在 5 月 13 日发布的研究报告中:统计区间是 2026 年 4 月 27 日至 5 月 3 日一周,对象是有一定人类访问量(当年 4 月页面浏览超过 100 次)的 GitBook 托管文档站;在排除爬虫、只比较「有意图的阅读」之后,智能体占 51.8%,人类占 48.2%。这是 GitBook 对其托管文档站的公开统计,不是对全网文档或所有知识库产品的行业普查,引用时不宜外推成「所有企业文档都已被智能体主导」。
即便如此,方向已经足够清楚:文档站不再只是给人看的手册,也是智能体取用产品知识的入口。GitBook 自己也已经为托管文档提供 Markdown 页面、llms.txt 以及已发布文档的 MCP 入口,并在 11 月 13 日的文章里强调——智能体未必先落到文档首页,而可能先碰到市场官网或对比页,所以网站本身也是 agent experience 的一部分。它还写到一个对治理很关键的产品行为:在 GitBook 的文档站里,把页面从目录中隐藏,并不会把该页从
llms-full.txt 或站点 MCP 中撤下;隐藏只是移出已发布的目录。这些能力回答的是「智能体能不能找到、能不能读、能不能拿去执行」。它们并不自动回答另一组问题:被打分或被打包进技能的 URL,是不是知识库里当前批准、仍对外发布的版本;页面里的截图、示意图和品牌视觉,是不是 DAM 里仍带使用权的批准态对象;人与智能体先落到的那一层体验,是不是 CMS/Website 正式发布的页面,而不是一份过期镜像、活动页或未纳入发布范围的拷贝。分数可以说明文档是否容易被到达和解析,但不能代替内容基础设施里的真相源。这与「如果人们找不到那一页,那一页上的字从来就不重要」是同一要求,只是读者里已经包含智能体:找不到,或者找到的是未批准版本,对组织来说都还没交付。
三、从 URL 生成技能,也不等于知识库已经可引用
Skill generator 把文档站变成一份智能体可加载的指令包,这会降低「把产品知识交给智能体」的上手成本。也正因为如此,更需要把「生成了一份技能」和「知识已经可治理地被引用」分开写。
一份从 URL 生成的
SKILL.md,回答的是智能体在当时能够读到什么、以及如何按这包指令去完成任务。它通常不会自动回答:- 来源是不是批准态知识。 如果提交的是预览站、旧镜像、个人分支或未走发布流程的公开链接,生成出来的技能会把那一层内容固化给智能体,而不是知识库里已经审批的主版本。
- 文档更新之后,技能会不会同步。 官方说明的是「把文档 URL 生成技能」,并没有把「主文档一更新、所有已分发的技能即刻重签」写成已交付能力。技能一旦被下载到本地智能体里,就可能和正式文档站脱节。
- 权限边界有没有被带上。 对外文档、对内知识、按角色可见的章节,不能因为「智能体要一份技能」就被打成同一包。GitBook 在自己的文档站里已经提示:目录中隐藏并不等于对机器入口隐藏。换到其他文档栈,同样要单独验收「对目录隐藏」和「对智能体不可见」是不是一回事。
- 视觉和附件有没有回到资产库。 操作截图、界面标注、品牌图和可下载资料如果只存在于文档页的临时拷贝里,技能再准确,也无法追溯使用权、版本和撤稿。被智能体引用的图,仍须是 DAM 中的批准态对象。
SEO/AEO 文档技能和 Agent score 可以把页面改得更适合被检索和引用,这与「结构优先,AI 其次」并不矛盾:结构、标题、前提条件和可引用的事实,本来就应该先写清楚。需要避免的是,把「分数提高了」或「已经生成技能」当成口径已经统一、资产已经入库、体验已经发布。
把这次发布和前一天的可见性信号放在一起看,反而更清楚。Bloomreach 在 11 月 16 日宣布收购 AthenaHQ,要监测品牌如何出现在答案引擎里;GitBook 在同一天把文档站的可达性检查和技能生成做成一套免费工具。一个看「外面怎么引用你」,一个看「你的文档能不能被智能体用上」。两条线要闭合到同一处:被引用、被加载的,仍须是 CMS/Website、知识库和 DAM 里的批准态对象。
四、工具开放之后,验收什么
据此,验收时至少要核对下面几条:
- 把「已经可以打分、可以生成技能」和「批准态知识已经被智能体正确加载」分成两行来记。 演示时要问:当前被评分、被生成技能的 URL 是哪一个环境,对应知识库里的哪一套已发布版本,文档更新后技能由谁重生成、如何收回旧包。
- 被打分的必须是正式发布的文档体验。 预览地址、活动页、过期语言版本或未纳入发布范围的拷贝,即使分数很高,也不能代表对外知识已经就绪。要核对这些 URL 是否由知识库或 CMS/Website 发布,并指向当前批准版本。
- 生成技能前先划定范围和权限。 只把允许对外或允许给该类智能体使用的已发布页面纳入来源,不把对内草稿、隐藏页和未授权章节一并打包。若文档栈声称「隐藏即不可见」,要用机器入口(而不只是目录)复验一次。
- 技能里出现的视觉,必须仍是 DAM 中的批准态对象。 截图和示意图应能回链到资产库中的当前授权版本;撤稿或过期时,文档页和已分发技能都要有更新路径,而不是只改一处页面。
- 官网、文档站和帮助中心要指向同一套口径。 GitBook 提醒过,智能体可能先落到市场官网或对比页。验收时要看这些入口是否把智能体和人都导向当前批准的知识,而不是各自保存一份互不相同的说明。
- 分数和可读性修复不能绕过审批。 AI readability、Humanizer 或 SEO/AEO 技能给出的改写,应回到知识库的审阅和发布流程,而不是直接在智能体会话里改完即用。尤其是价格、权限、安全步骤和合规表述,必须以已审批事实为准。
五、30 天落地清单
- 第 1 周:盘点智能体实际在读哪些入口。 列出官网、文档站、帮助中心、资源站和对外知识库的公开 URL,区分正式发布地址与预览、镜像、过期版本。先分清「可以纳入评分和技能生成的来源」和「不能被当成真相源的拷贝」。若使用 Agent score 或同类检查,只对正式发布地址打分,并把结果当作可达性参考,而不是发布许可。
- 第 2 周:把高价值任务页映射回内容基础设施。 选若干智能体和用户最常执行的任务(安装、升级、权限、故障排查),核对该页在知识库中的批准状态、所用截图在 DAM 中的授权与版本,以及从官网或产品页能否到达这一页。把对不上的项写成缺口,而不是先生成一份新的技能包。
- 第 3 周:规定技能如何生成、审批和失效。 明确谁有权用正式文档 URL 生成
SKILL.md、生成后要对照哪些已审批页面、如何分发给内部智能体、文档更新后谁负责重生成,以及旧技能如何标记失效。可读性或 AEO 修改同样走草稿、审批和发布,不在会话里直接覆盖正式页。 - 第 4 周:把无法回链的「高分」和「已生成技能」写成例外。 对那些分数不错、或已经生成技能、却回不到正式页面、已审批口径或批准态资产的条目,单独建立例外清单,作为下一轮信息架构、发布规范和供应商演示要追问的问题。
六、收束:可达只是开始,交付仍要回到真相源
GitBook 在 2026 年 11 月 16 日推出 Docs AI Toolkit,把文档技能、Skill generator 和 Agent score 做成一套不绑死单一文档主机的免费工具。它回应的是一个已经写在公开研究里的变化:在 GitBook 托管的文档站上,有意图的阅读里,智能体已经占到一半以上。对品牌、知识和内容团队,真正要带走的判断很短——分数可以测可达,被加载的仍须是批准态知识;DAM、知识库和 CMS/Website 仍是真相源,评分器和技能生成器只负责把到达方式和打包方式照出来。
若你正在让文档更适合被智能体使用,或评估是否把评分和技能生成纳入现有知识工作流,与其只问「分数高不高、技能能不能一键生成」,不如先问:被打分的是不是正式发布的文档站,被写进技能的是不是知识库里的批准版本,被智能体看到的那张图能不能回到 DAM 里仍被授权的对象。Baklib 的产品方向,正是让资产可管、知识可复用、体验可运营,在同一套内容基础设施里把这三层收在一起,降低「技能已经生成、站点上仍是旧口径」的风险。
想要了解更多?
数字内容新基建白皮书
常见问题
GitBook 这次发布了什么?
2026 年 11 月 16 日,GitBook 宣布推出 Docs AI Toolkit。按官方说明,它包括五份可安装到智能体中的文档技能、一个把文档站 URL 生成 SKILL.md 的 Skill generator,以及检查智能体能否到达、解析并使用文档的 Agent score。工具免费,适用于任意文档站,也不要求注册 GitBook 账号。
Agent score 能证明文档已经治理完成吗?
不能。Agent score 检查的是智能体能否到达、解析并使用文档,基础是开源库 afdocs 以及 GitBook 的若干附加检查。它说明的是可达性和可解析性,并不自动证明被评分的 URL 是知识库里的批准版本,也不证明页面中的截图仍是 DAM 中的批准态资产。
从文档 URL 生成 SKILL.md 要注意什么?
生成器可以把公开文档打成智能体可加载的指令包,便于产品知识被立即使用。验收时仍要确认:来源 URL 是否为正式发布地址、技能覆盖范围是否排除对内或未授权页面、文档更新后由谁重生成并收回旧包,以及技能中的视觉能否回链到 DAM。官方说明没有把「主文档更新后已分发技能自动同步」写成已交付能力。
这和前一天 Bloomreach 收购 AthenaHQ 有什么关系?
两者都出现在 2026 年 11 月 16 日前后,但切入点不同。Bloomreach 收购 AthenaHQ,是把品牌在答案引擎中的可见性监测与后续内容行动连起来;GitBook 的工具则面向文档站本身的可达性、可读性和技能打包。把它们放在一起,是为了验收同一条闭环:被引用或被加载的,仍须回到 CMS/Website、知识库和 DAM 里的批准态对象。
为什么还要验收官网、DAM 和权限边界?
GitBook 在 11 月 13 日的说明里指出,智能体可能先落到市场官网或对比页,而不仅仅是文档首页;它自己的文档产品也写明,从目录中隐藏页面,并不会把该页从 llms-full.txt 或站点的机器入口中撤下。因此,入口体验、视觉资产和「隐藏是否等于对智能体不可见」,都需要单独验收,而不能只看文档目录或一份评分。