# Docs Build Reviewer

> 独立评审 docs-build / aiweave-snapshot 生成的 AIWeave docs 质量，识别裸占位、高密度 gap、误标 gap、BUILD_STATUS 与 INDEX 不自洽等问题。

- **Type:** Skill
- **Install:** `agentstack add skill-xurb-nexus-nexus-harness-docs-build-reviewer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [xurb-nexus](https://agentstack.voostack.com/s/xurb-nexus)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [xurb-nexus](https://github.com/xurb-nexus)
- **Source:** https://github.com/xurb-nexus/nexus-harness/tree/main/skills/docs-build-reviewer
- **Website:** https://xurb-nexus.github.io/nexus-harness/

## Install

```sh
agentstack add skill-xurb-nexus-nexus-harness-docs-build-reviewer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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`
5. **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 / 校验规则 / 错误码）
6. **INDEX 自洽**：`docs/INDEX.md` 列出的 md 与实际 `docs/**/*.md` 有差集，或存在未登记 md → `blocking`。

## 输出

写 `reviewer_output_path` JSON：

```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](https://github.com/xurb-nexus)
- **Source:** [xurb-nexus/nexus-harness](https://github.com/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.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-xurb-nexus-nexus-harness-docs-build-reviewer
- Seller: https://agentstack.voostack.com/s/xurb-nexus
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.