用途:对线上文档站点进行 Agent 友好度审计,优先按外部 Agent 的真实抓取路径(直接 HTTP 请求、sitemap 抽样、页面级检查)评估,而非仅看源码树或首页。
主要能力:检查站点级信号(/llms.txt、/llms-full.txt、/robots.txt、/sitemap.xml);仅在 app/tool 或 mixed 主机上检查 /.well-known/ai-plugin.json、/.well-known/agent.json、/.well-known/agents.json。抽样至少 12 个页面并覆盖多种页面类型;对每个样本验证 HTML 状态、内容类型、最终 URL、Accept: text/markdown 行为、直接 Markdown 路由、页面级 Markdown 替代链接是否可用、标题与 H1 一致性、正文是否存在于初始 HTML、重定向与 canonical 一致性、Markdown 中的噪音。还会评估结构(唯一 h1、标题层级、main/article、canonical、JSON-LD 或面包屑、锚点)与可读性,并按 references/rubric.md 评分,最后输出修复清单(P0/P1/P2)。
使用方式:以 $ARGUMENTS 作为基础 URL;可运行基线脚本:bash .agents/skills/agent-readiness-audit/scripts/baseline-probes.sh "$ARGUMENTS";docs-only 主机可设 CHECK_TOOL_MANIFESTS=0 跳过工具清单探测。报告使用 references/report-template.md。
限制:docs-only 主机缺少 MCP 或插件清单应标为 N/A,不视为失败;仅对已验证项评分;不要因元数据整洁而掩盖发现或 Markdown 交付的严重问题;外部扫描器结果仅作辅助证据,与实时抓取冲突时以实时抓取为准。原文未提供具体评分阈值、等级划分与各分类权重细节。