我们如何把文档在 Agent-Friendly Docs 评分卡上做到 100 分

文章指出 Agent 抓取文档时拿到的是与浏览器相同的 HTML：在 routebase.dev 的 20 页样本中，HTML 中位数 148 KB，而 Markdown 仅 8 KB，超过九成内容是标记、脚本和导航，部分 Agent 会截断或先摘要，导致用户得到的答案少于实际发布内容。作者介绍 CC BY 4.0 下的 Agent-Friendly Docs Spec 及配套工具 afdocs，后者对任意文档站点运行 7 类共 28 项检查；10 月 5 日对 routebase.dev 的评分为 87/100，当天结束前提升到 100，文章复盘了所做的改动。

AI推荐理由 作者给出可复现的具体数据：routebase.dev 20 页样本中 HTML 中位数 148 KB、Markdown 仅 8 KB，并说明用 afdocs 的 28 项检查在 10 月 5 日从 87 分改到 100 分。这是面向 Agent 读取文档的开放规范（CC BY 4.0）与工具实践，对做 AI 应用和文档基础设施的开发者有直接参考价值。局限是样本仅来自单一站点，分数提升的具体改动细节在摘要中未展开，效果仅限该评分卡口径。