Docs Build Reviewer

docs-build-reviewer

> 框架不可变铁律（复用自 [AGENTS.md](../../AGENTS.md) 第 7 条，所有 skill 一致） > 本 SKILL.md 及其 scripts/ / templates / tests/ 等框架文件在"使用本 skill"过程中只读。 > 唯一豁免：用户在当前会话明确声明"现在就是来改这个 skill 的"。

评审目标

只评审业务项目的 AIWeave docs 质量，不改业务代码、不改 nexus-harness、不替主 Agent 修复。

必做检查

1. gap 密度：单篇 aiweave:gap 数量 >20 或 gap/有效行 >30% → blocking。
2. 裸占位：任何未包在 ` 内的 待补充 / TODO / FIXME / XXX → blocking`。
3. gap 反向抽查：随机/按前 5 处 aiweave:gap，用 Grep 在业务代码里反向搜字段/模块名；若代码里实际存在可填内容 → blocking。
4. BUILD_STATUS 事实对账（机械检查，scope=all/B1 时跑；复用 lint_aiweave_invariants._check_build_status_facts）：

• build_status_router_group_not_registered：BUILD_STATUS.md 表格列出的 /xxx 路径在 router/**/*.go 中找不到 .Group() 注册 → blocking
• build_status_skill_section_outdated：BUILD_STATUS 仍写"尚未创建 .claude/skills/"但目录已就位 → blocking
• snapshot_stub_only_inconsistent：.aiweave_snapshot.json 标 stub_only 的文件实际有效行数 > 8 → warning

1. API 规格深度对账（机械检查，scope=all/B4 时跑；复用 lint_aiweave_invariants._check_api_spec_depth）：

• api_spec_depth_thin：docs/api/audience_*_interfaces.md 中 #### METHOD path 接口章节缺代码块 + 缺字段表 + 字符 50% → blocking（vendor docs-spec/07 要求每接口给出请求 JSON / 响应 JSON / Go struct / 校验规则 / 错误码）

1. INDEX 自洽：docs/INDEX.md 列出的 md 与实际 docs/**/*.md 有差集，或存在未登记 md → blocking。

输出

写 reviewer_output_path JSON：

{
  "schema_version": "1.0",
  "decision": "accept",
  "project_path": "/abs/project",
  "scope": "all",
  "summary": {"blocking": 0, "warning": 0},
  "findings": []
}

有 blocking 时 decision="repair"。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: xurb-nexus
• Source: xurb-nexus/nexus-harness
• License: Apache-2.0
• Homepage: https://xurb-nexus.github.io/nexus-harness/

Install and usage instructions live in the source repository linked above.