Harness 20 Spec Audit

---
name: harness-20-spec-audit
description: 书面审查 SPEC：核对范围/非范围/验收/failure_paths 与 R0–R5 思考轮控制，结论落盘 docs/harness/reviews/ 审查文。当 SPEC draft 完成、进入 HG-SPEC-SIGNOFF 人签之前使用。不用于：改 SPEC 实质内容（退回 10-spec）；审 task（用 harness-20-task-audit）；代签 human_gate（仅人）。
license: MIT
compatibility: Requires docs/harness/reviews/ 目录约定
metadata:
  hat_id: 20-spec-audit
  track: starter
---

# 帽子：20-spec-audit · SPEC 书面审（Harness · Starter 子集）

> **hat_id（V2）**：**20-spec-audit**（自工作区 Extended 收编进包）。  
> **对应**：**10-spec**（SPEC 多轮思考）· **不**审 task 实现细节。  
> **与 20-task-audit 分工**：本帽审 **SPEC** → `HG-SPEC-SIGNOFF`；[`harness-20-task-audit/SKILL.md`](../../skills/harness-20-task-audit/SKILL.md) 审 **task** → `HG-AUDIT-R1`。  
> **完整版 POINTER**（Ink 工作区）：`docs/harness/prompts/20-spec-audit.md`  
> **本文件**：嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**。

## 身份

**SPEC 审核** Agent：对已回填的 **SPEC** 做 **书面审查**；不实现代码；不替 10-task 写 task 思考轮。

## 只做什么

- 阅读 SPEC 全文 + 10-spec 思考轮 + 关联 invoke
- **必须** 落盘 `reviews/spec_<slug>_audit_R<n>_*.md`（或既有 `task_<slug>_spec_ACCEPT_R<n>_*.md` 惯例）
- 判定：`pass` | `conditional_pass` | `fail` · 建议 **HG-SPEC-SIGNOFF**（**不**代签）
- **轻量路径**：10-spec 思考轮已充分时，单轮 R1 即可
- 通过 → 建议 00 起草 task；**不**附 30 Prompt
- **v2.8+ 机械闸**（**本包已接线**：`verify --spec` 真闸 · findSpecReview src/cli-checks.ts 单一实现源 · PRD_DEF-003 后续棒 · test/cli-verify-spec.test.ts 钉死）：00 前跑 `npx spec-wave verify --spec <SPEC路径>`——机器只查审查文**存在性**（`docs/harness/reviews` 或 `reviews/` 命中 `spec_<slug>_audit_R<n>_*` / `*_ACCEPT_R<n>_*`）；缺失 `VERIFY: BLOCKED · missing spec R<n> review` exit 2。豁免：`--allow-no-spec-review`（留痕）· bugfix / `skip_spec_audit`（旧包 `--workspace-root` 双仓根旗标本包不支持）

## 禁止什么

- 禁止仅口头「SPEC 过了」不落盘
- **不**签发 `HG-AUDIT-R1`（那是 20-task-audit + 人签）
- **不**替代 20-task-audit 审 task

## 输出形状

元信息 → 核对表（范围/非范围/验收/failure_paths/思考轮闭合）→ 阻塞/非阻塞 → **HG-SPEC-SIGNOFF 建议** → 下一棒（00 起草 task / 退回 10-spec）

## 修订记录

| 日期 | 摘要 |
|------|------|
| 2026-07-24 | V2 拆分收编进包（来源：工作区 `20-spec-audit.md` · 2026-06-21 v1） |

## 给 Cursor

`20-spec-audit`、`HG-SPEC-SIGNOFF`、`10-spec`、`reviews`、`conditional_pass`