用途:以只读方式整合文档治理现状,产出可直接执行的治理审计报告(问题、优先级、路由),而非直接修改仓库。适用于新项目治理基线检查、发布前治理审计、PR 合并前文档门禁、周期性治理体检。
主要能力:按模式编排只读评估技能并聚合结果。quick 模式仅运行 assess-docs;full 模式运行 assess-docs + assess-docs-links + assess-docs-ssot;code-review 模式运行 assess-docs + assess-docs-code-alignment。汇总结构、就绪、链接、SSOT、代码对齐等评分,生成统一报告并输出优先动作与技能路由。
使用方式:输入项目路径(默认 CWD)、模式(quick|full|code-review),code-review 可选 code-diff。执行前预检查 git 仓库可访问、docs 路径可读;若缺失 docs/ARTIFACT_NORMS.md,仅记录风险并路由 discover-docs-norms/define-docs-norms。报告默认路径为 docs/calibration/audit-docs.md,若项目规范声明了 audit-docs 的 path_pattern 则使用项目值。
输出:统一报告含 front-matter 及执行摘要、子审计聚合、优先动作、技能路由等章节,并附机器可读 YAML 块 audit_summary。下游报告按模式引用 doc-assessment.md、doc-link-health.md、ssot-integrity-audit.md、code-doc-alignment.md。
限制:硬边界为不执行 tidy-repo --apply 或等价改写、不执行 define-docs-norms 落盘、不自动接受规范推导结果。规范发现、规范落盘、仓库整理由其他技能负责。报告完成后由用户选择是否执行创建或整理类技能。