Velu 推出 AI 智能体文档可读性检测工具，23 项检查对照开放标准打分
Show HN: Check how readable your docs are to AI agents
Velu 上线 AI 智能体文档可读性检测工具，依据 agentdocsspec.com 的开放标准，从 7 个类别、23 项检查对文档打分，涵盖 llms.txt 结构、.md 版本可用性、50K 字符页面预算、服务端渲染与 URL 稳定性等。无需注册，结果缓存 15 分钟，可通过签名链接分享同一份评分卡。
对 AGENT 友好的文档
像 agent 一样查看你的文档。跨 7 个类别的 23 项检查，依据开放标准评分。
开放标准。无需注册。完成后可通过链接分享你的评分。
〉 测量内容
七个类别，二十三项检查。
7 项检查
内容可发现性
llms.txt：它是否存在、结构是否有效、是否在大小限制内，以及你的页面是否指向它。
2 项检查
Markdown 可用性
在 .md URL 提供 Markdown，以及支持 Accept: text/markdown 的服务器。
4 项检查
页面大小与截断
服务端渲染内容、50K 字符预算，以及你的内容从哪里开始。
3 项检查
内容结构
可序列化的标签页、独立成立的标题、正确闭合的代码围栏。
2 项检查
URL 稳定性
真实的 4xx 代码而非软 404，以及同主机 HTTP 重定向。
3 项检查
可观测性
站点地图覆盖、与 HTML 匹配的 markdown，以及缓存标头。
2 项检查
身份验证与访问
无需登录即可打开的页面，或有文档说明的替代路径。
〉 默认对 AGENT 可读
在 Velu 上发布，这些检查会自动完成。
上面测量的一切都是发布过程的一部分，而不是事后安排的项目。你的页面在发布时同时具备人类可读和机器可读，并且在你不断添加内容时保持如此。
01
自动生成 llms.txt 和 llms-full.txt
根据你发布的文档生成，并在添加页面时重新生成，因此 agent 始终能获得最新索引，而不是某个被记得更新过的索引。
/llms.txt/llms-full.txt/page.md
02
每个 URL 都有 Markdown
在任何页面后附加 .md，即可获得干净的 markdown，无需 agent 费力浏览的导航和布局标记。
03
服务端渲染页面
HTTP 响应中包含真实内容。没有任何需要 JavaScript 才能显示的内容，而大多数 agent 无法执行 JavaScript。
04
托管主机
状态码、重定向和缓存标头由平台处理，因此 URL 保持稳定，更新也能顺利传达。
05
默认公开
无需交互式登录即可访问文档，因此 agent 不会在门口被拦住。
06
MCP 服务器和 skill.md
一个端点，agent 可以通过它搜索、阅读和引用，超越当前规范的要求。
agent → mcp.search() → 你的文档 → 带引用的回答
细则，用大白话讲。
01 什么是对 agent 友好的文档？ +
对 agent 友好的文档是模型或 agent 能够可靠地找到、获取、解析并据此行动的文档。在实践中，这意味着将人类可读的页面与机器可读的产物配对：像 llms.txt 这样的发现文件、每个页面的 markdown 版本、能放入上下文窗口的服务端渲染内容，以及稳定的 URL。人类读者可以通过推断或点击绕过缺口。Agent 做不到，所以它们会猜测，而且猜得很自信。
02 什么是 llms.txt？ +
一个位于文档根目录的纯文本索引，告诉 agent 存在哪些内容以及在哪里读取。惯例是 H1 标题、引用块摘要，以及带标题的 markdown 链接分区。它是规范中权重最高的单项，因为无法发现你文档的 agent 永远无法通过其余二十二项检查。
03 分数是如何计算的？ +
依据 Agent-Friendly Documentation Spec，这是一个维护在 agentdocsspec.com 的开放社区标准。它定义了 7 个加权类别下的 23 项检查。本页面使用 afdocs（该规范的 MIT 许可参考实现）对你页面的样本运行这些检查，并原样报告其返回结果，不做任何调整。
04 这只是换了个名字的 SEO 吗？ +
不是，而且两者可能朝相反方向发力。SEO 优化的是页面如何被排名，以及如何呈现给会点击、浏览和评判的人类。而这里优化的是机器能否检索到内容、能否在没有 HTML 噪声的情况下解析它，以及能否将其放入上下文窗口。一个页面可以在 Google 上排名第一，却仍然对 agent 不可读，通常是因为它是客户端渲染的，或被埋在导航标记之下。
05 我输入的 URL 会怎样？ +
它会被抓取、评分并缓存十五分钟，以便重复检查时更快。无需注册，结果也不会发布到排行榜。如果你分享自己的分数，链接会携带结果的签名摘要，以便他人打开同一份评分卡。
06 我可以分享我的分数吗？ +
可以。运行结束后，复制短链接或分享到 X、LinkedIn 或 Reddit。任何拥有该链接的人都会看到相同的分数，预览图会显示等级和总分。
让你的文档 agent-ready。
发布一个页面，机器可读的那一半也随之而来，每次发布都是如此。
MADE FOR HUMANS & AGENTS · AI-NATIVE FROM DAY ONE
来源：Hacker News · veludocs.com