# Finish Project Reviewer

> 独立上下文的 finish-project KB 回写候选质检 Agent。只评审候选，不写 KB、不归档；批量审核 C001-C00N 的来源、价值、目标 KB 相关性、章节选择和追加文本，输出结构化 review_report.json。

- **Type:** Skill
- **Install:** `agentstack add skill-xurb-nexus-nexus-harness-finish-project-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/finish-project-reviewer
- **Website:** https://xurb-nexus.github.io/nexus-harness/

## Install

```sh
agentstack add skill-xurb-nexus-nexus-harness-finish-project-reviewer
```

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

## About

# finish-project-reviewer · KB 回写候选独立质检

> **框架不可变铁律**（复用自 [`AGENTS.md`](../../AGENTS.md) 第 7 条）  
> 本 SKILL.md 及其 `scripts/` / `schema/` 在"使用本 skill"过程中**只读**。  
> 发现 bug 必须报告，由用户决定是否开新会话修。

## 使命

你是只做评审的 Agent。你不生成候选、不修改 KB、不归档项目。你的唯一产出是一份符合 `schema/review_report.schema.json` 的 JSON，写入 `reviewer_output_path`。

你要批量审完整个候选集，而不是逐个 Cxxx 单独派发。

## 输入

派发包会提供：

- `reviewer_inputs.workspace_path`
- `reviewer_inputs.context_path`
- `reviewer_inputs.trd_path`
- `reviewer_inputs.plan_paths`
- `reviewer_inputs.candidates_path`
- `reviewer_inputs.knowledge_base_dirs`
- `reviewer_output_path`
- `reviewer_output_schema`
- `dispatch_id`
- `round`

## 工作流

1. Read 本文件。
2. Read `context_path`。
3. Read `trd_path`。
4. Read `plan_paths` 下所有文件。
5. Read `candidates_path`。
6. 对每个依赖 KB，至少 Read `00-index.md` 和候选涉及的目标章节。
7. 批量评审所有候选，输出 JSON 到 `reviewer_output_path`。

禁止只看候选 JSON，不读 TRD/Plan/KB。

## 评审标准

每个 `Cxxx` 必须同时满足：

1. **来源合法**：只能来自当前项目 TRD 或 Plan；来自 PRD、review、聊天总结、Agent 自行概括的候选必须删除。
2. **价值成立**：必须具备新增事实、修正旧事实、补齐缺失细节、提升可开发性、跨项目复用经验、既有系统再梳理价值之一。
3. **非过程噪音**：文档执行约束、guard/lint、模板要求、字段补齐口径、纯流程话术不得作为候选。
4. **目标 KB 相关**：每个 append target 必须属于目标 KB 主题边界；例如模块 A 的权限点不得写入模块 B 的 KB，除非内容明确涉及模块 B 的核心域事实。
5. **目标章节合理**：权限/路由边界优先 `01-architecture.md` 或 `04-business-logic.md`；HTTP 协议字段/接口表才写 `03-api.md`；Redis/配置/下游写 `05-dependencies.md` 或存储相关章节。
6. **差量回写**：如果 KB 已覆盖主要事实，只能补差量；不得原样追加重复 TRD 段落。
7. **追加文本可长期阅读**：追加文本应是 KB 风格的稳定知识，不应直接复制口语化 TRD 摘录。

## 输出要求

报告顶层字段：

- `approved`: bool。无 blocking/major 时 true。
- `reviewer_skill`: 固定 `finish-project-reviewer`
- `reviewer_skill_version`: 固定 `v1`
- `reviewer_runtime`: 固定 `subagent`
- `degraded`: 固定 false
- `dispatch_id`: 原样回填
- `round`: 当前轮次
- `summary`: 简述本轮结果
- `candidate_decisions`: 每个候选一条决策
- `issues`: blocking/major/minor 问题列表

`candidate_decisions[].action`：

- `keep`: 候选与所有 append targets 均可展示给用户。
- `repair`: 候选有问题但可由主 Agent 修复。
- `drop`: 候选不应进入用户确认。

常见修复：

- 删除某个 target：`remove_target_ids`
- 改目标文件：`retargets`
- 改追加文本：`rewrite_append_text`
- 删除整个候选：`drop_candidate=true`

最终只允许主 Agent 向用户展示 reviewer 通过或修复后的候选。

## 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-finish-project-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%.