用途:判断一个文档或内容站点今天能否公开部署。它审计的是“关于某事物的文档”,而非该事物本身是否可交付(后者属于 handoff-readiness)。适用于文档站首次上线、大改版、域名迁移,或有人问“文档站好了吗”“上线前还缺什么”,以及批量生成后未经代码核对的文档。不适用于审计库/CLI/应用本身、重写文案(本技能只标记,重写交给 humanizer / humanize-readme)、仓库根目录 README,或文档服务器的运行时安全。
主要能力与流程:第一步探测技术栈与部署目标,依据文件证据确认框架与渲染模式(静态 SSG、SSR、混合预渲染)、构建命令与产物、规范 URL 与 base path、构建期与运行期环境变量、内容来源及是否由生成器产出。第二步从源头(而非文档)建立“应存在”清单:库的公开导出、CLI 的命令与标志、API 路由表、配置 schema,再与现有页面双向 diff。第三步抽样每类最完整的 3–5 页,推导项目自身的章节骨架作为一致性基准。第四步应用五项标准:覆盖度(每个公开项有页面、关键路径无占位页、无孤儿页、入门路径完整)、页面结构(模板一致、示例可运行、覆盖全部安装方式、参考表含类型与默认值、无障碍与键盘说明)、文案质量(扫描 AI 写作痕迹、语法与术语一致性,仅标记不重写)、与代码一致性(文档有而代码无、代码有而文档无、默认值与类型是否匹配、隐私与安全声明是否属实、代码片段是否最新)、可部署性(每页唯一 title 与 meta description、OG/Twitter 卡片、绝对规范 URL、sitemap.xml 与 robots.txt、品牌化 404、搜索可用、llms.txt、干净构建)。第五步在干净环境冷构建(必要时容器内),确认产物无 localhost 等开发来源、内部链接与锚点可解析。第六步评分并输出报告,大型站点可并行分派后合并。
输出:固定格式报告,含技术栈、清单数量、结论(READY / READY WITH WARNINGS / NOT READY)、五项 0–10 评分表、阻塞项、警告、覆盖缺口表与文案标记表。评分规则:准确性或可部署性存在阻塞项即 NOT READY;无阻塞仅有警告为 READY WITH WARNINGS。
限制与注意:不得整体照搬其他项目的检查清单,基准是项目自身模板加通用检查;每条参考声明都要 grep 源码核对,隐私声明不实为自动阻塞;审计中不重写文案;不能只在开发机验证构建;关键路径上的死链与占位页视为阻塞;文档导航、搜索、主题切换等界面无障碍需另行处理。资料未提供具体安装命令、收费与平台信息。