critique-docs

用途：依据 Diataxis 框架审查 Markdown 文档页面或页面树的结构与模式一致性。主要能力：覆盖九项标准（DIATAXIS-CROSSLINK、EXPLANATION-CONTEXT、HEADING-DEPTH、HOWTO-GOAL、MODE、NAV-LENGTH、ORPHAN、REFERENCE-NEUTRAL、TUTORIAL-ACTION）；每项发现符合 contract/critique-contract.schema.json，要求位置可独立定位、证据引用或量化、写明违规项、给出可操作修复。使用方式：按四遍执行——清点结构、按 ID 顺序逐条扫描（脚本通道运行 scripts/checks.py <artifact>，人工判断通道自行执行）、单独分配严重度（按影响、频率、持续性）、最后写入 JSON 交由 scripts/merge.py 组装。scripts/merge.py 与 checks.py 同目录同方式运行，使用同一 artifact 路径，可加 --severity-3-threshold N。一次性前置依赖：pip install "jsonschema>=4.20,<5"。输出边界：报告全部三级与四级发现，三级以下最多五条，其余计入 summary.suppressed_count。有子代理工具时应委派 critique-critic，传入 artifact、技能名、技能目录绝对路径及可选阈值，返回的信封即为输出。限制：仅处理 Markdown 文档页面与页面树；不审查实时渲染站点行为、非 Markdown 源格式或页面内代码示例的技术正确性；脚本通道只实现三项标准，DIATAXIS-MODE 对未声明模式的页面保持沉默（零发现表示未评估而非通过），DIATAXIS-NAV-LENGTH 会统计所有平铺列表而非仅导航列表；DIATAXIS-ORPHAN 需全树数据，由判断通道处理；若 merge.py 失败应直接报告命令与错误并停止，不得用文字摘要替代信封。