spec-wave 2.1.1

package/assets/ide/host-adapt/host-adapt.schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/Cyning12/SpecGate/assets/ide/host-adapt/host-adapt.schema.json",
+  "title": "DSH host-adapt table",
+  "description": "Declarative host adaptation table (F6 / 2.x W1). Surfaces: always_on, skills, commands; optional verify. target / target_dir must not hit S2_TRUTH_PREFIXES (validated by CLI, not this schema alone).",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "hosts"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Table schema version (string, e.g. \"1\")."
+    },
+    "hosts": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/HostRow" }
+    }
+  },
+  "$defs": {
+    "HostRow": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["host_id", "surfaces"],
+      "properties": {
+        "host_id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Host identifier (e.g. dsh, cursor, claude)."
+        },
+        "surfaces": { "$ref": "#/$defs/Surfaces" }
+      }
+    },
+    "Surfaces": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["always_on", "skills", "commands"],
+      "properties": {
+        "always_on": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/AlwaysOnEntry" }
+        },
+        "skills": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/DirFromEntry" }
+        },
+        "commands": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/CommandsEntry" }
+        },
+        "verify": { "$ref": "#/$defs/VerifyEntry" }
+      }
+    },
+    "AlwaysOnEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["target", "source"],
+      "properties": {
+        "target": { "type": "string", "minLength": 1 },
+        "source": { "type": "string", "minLength": 1 }
+      }
+    },
+    "DirFromEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["target_dir", "from"],
+      "properties": {
+        "target_dir": { "type": "string", "minLength": 1 },
+        "from": { "type": "string", "minLength": 1 }
+      }
+    },
+    "CommandsEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["target_dir", "from"],
+      "properties": {
+        "target_dir": { "type": "string", "minLength": 1 },
+        "from": { "type": "string", "minLength": 1 },
+        "profile": {
+          "type": "string",
+          "enum": ["core", "expanded", "custom"]
+        }
+      }
+    },
+    "VerifyEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "bin"],
+      "properties": {
+        "kind": { "type": "string", "const": "cli" },
+        "bin": { "type": "string", "minLength": 1 },
+        "failClosed": { "type": "boolean" }
+      }
+    }
+  }
+}

package/assets/ide/skills-orch/README.md

@@ -0,0 +1,16 @@
+# Skills · 编排轴（DSH `/kit-*`）
+
+> **用途**：DSH 项目本地 slash 发现根为 `.dsh/skills`（上游 deepseek-harness · `project-dsh` · `docs/subsystems/skills.md`）。  
+> **无** `.dsh/commands` 扫描器；编排面以本目录五条 skill 物化，与帽子 `assets/skills/harness-*` 并存。
+
+| skill_id | 真值 |
+|----------|------|
+| `kit-verify` | `verify --task` · exit 0/1/2 |
+| `kit-gate-status` | `status` / `gate-check` + task 闸表 |
+| `kit-init-guide` | 双入口（插件 ≠ CLI） |
+| `kit-apply-standards` | DSH 工具或 standards POINTER |
+| `kit-hat-reanchor` | POINTER → `harness-hat-reanchor` |
+
+正文语义与 Cursor `assets/ide/commands/cursor/kit-*.md` 对齐：必跑 CLI；禁止口头代闸。
+
+物化：`mvp-hosts.yaml` → `host_id: dsh` · `skills` 第二条 `from: assets/ide/skills-orch/*` → `.dsh/skills/kit-*/SKILL.md`。

package/assets/ide/skills-orch/kit-apply-standards/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: kit-apply-standards
+description: 指导应用 coding standards（POINTER；不静默改 S2）。当用户要加载规范、apply standards 时使用。不用于：口头代闸；静默改 tasks/reviews/invokes。
+license: MIT
+compatibility: DSH 可调 apply_coding_standards；非 DSH 读 docs/standards/
+metadata:
+  kit_command_id: kit-apply-standards
+  track: orch
+---
+
+# 编排 · kit-apply-standards
+
+DSH 会话：请模型调用工具 apply_coding_standards（加载 ≠ 注入）。
+非 DSH：读 docs/standards/ 与 AGENTS.md（薄 POINTER，勿复制 L1/L2 全文）。
+
+禁止静默改写 S2 过程域：docs/tasks/、docs/harness/reviews/、docs/harness/invokes/by-task/。
+真值在包内 docs/standards/ 与仓内 AGENTS.md，本 skill 只编排、不替代闸。

package/assets/ide/skills-orch/kit-gate-status/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: kit-gate-status
+description: 扫人工闸与 status（声称与闸表冲突则 STOP）。当用户问闸态、是否可开工、或口头声称闸已批时使用。不用于：口头代闸；改闸表。
+license: MIT
+compatibility: Requires npx spec-wave；task 文件为闸真值
+metadata:
+  kit_command_id: kit-gate-status
+  track: orch
+---
+
+# 编排 · kit-gate-status
+
+1. 读现行 task 的人工闸表（真值在 task 文件，不在聊天声称）
+2. 必跑：npx spec-wave status --target . [--task <path>]
+3. 可选：npx spec-wave gate-check --task <path>
+4. 用户声称与闸表冲突 → STOP，以 task 表为准
+5. 勿复制 hat / L1 / L2 全文；POINTER：docs/harness/prompts/

package/assets/ide/skills-orch/kit-hat-reanchor/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: kit-hat-reanchor
+description: 长对话丢帽时重锚（不替代 30 授权）。当上下文脏、多轮后纪律漂移、或换帽后仍自称旧帽时使用。不用于：授予 30 改码权；口头代闸。
+license: MIT
+compatibility: Requires skill harness-hat-reanchor 或 FRAGMENT_hat_reanchor POINTER
+metadata:
+  kit_command_id: kit-hat-reanchor
+  track: orch
+---
+
+# 编排 · kit-hat-reanchor
+
+长对话丢失角色时：读 skill harness-hat-reanchor / FRAGMENT_hat_reanchor（POINTER，勿贴全文）。
+本 skill 不授予 30 改码权；HG-AUDIT-R1 pending 时仍拒改码。
+勿冒充 opsx 或其他产品的 slash 前缀。

package/assets/ide/skills-orch/kit-init-guide/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: kit-init-guide
+description: 分清插件 init_coding_kit 与 CLI init（双入口不合并）。当用户问如何初始化 coding-kit / 插件 vs CLI 时使用。不用于：静默改 S2。
+license: MIT
+compatibility: DSH 会话可调 init_coding_kit；CLI 用 npx spec-wave init
+metadata:
+  kit_command_id: kit-init-guide
+  track: orch
+---
+
+# 编排 · kit-init-guide
+
+双入口互不替代，禁止混成同一动词。
+
+插件面（DSH 会话）：
+- 工具名是 init_coding_kit（不是 CLI 子命令）
+- 对话请模型调用该工具；不覆盖已有文件
+
+CLI 面（Cursor / CI / 终端）：
+- npx spec-wave init --preset harness-only [--yes]
+- 过程落盘根 .coding-kit/ ；不写 S2 过程域
+
+勿把 init_coding_kit 与 CLI init 写成同一步。POINTER：仓根 README「选哪条入口」。

package/assets/ide/skills-orch/kit-verify/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: kit-verify
+description: 编排跑 dsh-coding-kit verify（failClosed；解释 exit 0/1/2）。当用户要验闸、跑 verify、或声称「闸已过」时使用。不用于：口头代闸；冒充 opsx/speckit。
+license: MIT
+compatibility: Requires npx spec-wave；Open Folder = 消费者仓根
+metadata:
+  kit_command_id: kit-verify
+  track: orch
+---
+
+# 编排 · kit-verify
+
+你是 ops 编排助手，不是门禁本身。Verify 真值在 CLI；禁止用本 skill 假装闸过。
+
+1. Open Folder = 消费者仓根
+2. 确认 task 路径（默认 docs/tasks/active/ 下现行 task）
+3. 必跑：npx spec-wave verify --task <path>
+4. 按退出码汇报：
+   - 0 通过
+   - 1 用法错误或非阻断失败
+   - 2 门禁阻断（硬停，failClosed）
+5. CLI 未跑或 exit 不为 0 时，禁止宣称闸已通过
+6. 规范真值 POINTER：docs/standards/ · AGENTS.md · docs/harness/prompts/ ；勿粘贴 L1/L2/hat 全文

package/assets/ontology.yaml

@@ -0,0 +1,113 @@
+# cyning-harness 产品设计本体 · 机器可读抽取（草案 v1.0.0）
+# 人类真值：DESIGN_ONTOLOGY_v1_zh.md（私仓 cyning-harness 工作区文档 · 不随 npm 包分发）
+# 冲突时以 Markdown 为准 · 机器校验请用 npx spec-wave graph axioms check
+# （该命令校验 HGM 公理，不校验本文件；独立的 ontology-check 本包未接线）
+
+version: "1.3"
+product_semver: "2.1.1" # 自旧包 cyning-harness 2.0.4 迁移，对齐本包 package.json
+license: MIT
+
+classes:
+  - id: Track
+    domain: Package
+    subclasses: [GraphTrack, WikiTrack, StandardsTrack, ProcessTrack, VerifyTrack, IDETrack]
+  - id: Template
+    domain: Package
+  - id: Preset
+    domain: Package
+  - id: WizardTool
+    domain: Package
+  - id: IDEFragment
+    domain: Package
+  - id: AdoptedProfile
+    domain: Instance
+  - id: VersionManifest
+    domain: Instance
+  - id: Task
+    domain: Instance
+  - id: Hat
+    domain: Instance
+  - id: HumanGate
+    domain: Instance
+  - id: InvokeSnapshot
+    domain: Instance
+  - id: AuditReview
+    domain: Instance
+  - id: InformArtifact
+    domain: Instance
+  - id: ConstrainArtifact
+    domain: Instance
+  - id: VerifyArtifact
+    domain: Instance
+
+relations:
+  - id: embedsInto
+    subject: DisciplinePackage
+    object: BusinessRepository
+    cardinality: "1..*"
+  - id: blocks
+    subject: HumanGate
+    object: Hat
+    cardinality: "1..*"
+  - id: governedBy
+    subject: Task
+    object: Hat
+    cardinality: "1..*"
+  - id: produces
+    subject: Hat
+    object: TraceArtifact
+    cardinality: "0..*"
+
+# 公理命名空间：ONTO- 前缀，独立于 graph axioms 代码公理（D2/D3/S2/rejected→draft，src/cli-graph-hgm.ts）
+axioms:
+  - id: ONTO-P1
+    text: "纪律包不含业务代码与 LLM Runtime"
+  - id: ONTO-S2
+    text: "禁止 sync 覆盖 docs/tasks、reviews、invokes/by-task"
+  - id: ONTO-S5
+    text: "harness-sync apply 前须 git-clean（可 --force 跳过）"
+  - id: ONTO-D1
+    text: "每次 20-task-audit 必须产出 AuditReview（零阻塞须写明）"
+  - id: ONTO-D2
+    text: "HG-AUDIT-R1 pending 时 20-task-audit 不得附 30 Prompt（别名 22-task-audit）"
+  - id: ONTO-D7
+    text: "public push 须 HG-RELEASE 人闸 checklist 全勾"
+
+# V2 hat_id · Starter 闭包 + Extended POINTER（见 DESIGN_ONTOLOGY §3.2）
+starter_hats:
+  - hat_id: "10-task"
+    role: TaskRequirementsHat
+    alias: "10-requirements"
+  - hat_id: "20-task-audit"
+    role: TaskAuditHat
+    alias: "22-task-audit"
+  - hat_id: "30-execute-code"
+    role: ExecuteHat
+  - hat_id: "40-self-check"
+    role: SelfCheckHat
+
+extended_hats:
+  - hat_id: "10-spec"
+    role: SpecRequirementsHat
+    pointer: "工作区 docs/harness/prompts/10-spec-requirements.md"
+  - hat_id: "20-spec-audit"
+    role: SpecAuditHat
+    pointer: "工作区 docs/harness/prompts/20-spec-audit.md"
+  - hat_id: "00-orchestrator"
+    role: OrchestratorHat
+  - hat_id: "50-independent-reinspect"
+    role: ReinspectHat
+
+human_gates:
+  - id: HG-TASK-DRAFT
+    blocks_hats: ["20-task-audit", "30-execute-code"]
+  - id: HG-SPEC-SIGNOFF
+    blocks_hats: ["30-execute-code"]
+    note: "Epic 级 · SPEC approved 后 00 方可派实现链至 30"
+  - id: HG-AUDIT-R1
+    blocks_hats: ["30-execute-code"]
+  - id: HG-RELEASE
+    blocks_hats: []
+    note: "维护者 CLOSE · npm/GitHub public · 非 Agent 自动签"
+
+# schemas 段已移除：manifest/task JSON Schema 未随包交付（DEF-004 · 旧 ./schema/*.schema.json 指针悬空）

package/assets/skills/README.md

@@ -0,0 +1,37 @@
+# skills/ · Agent Skills 标准封装（生成物 · 勿手改）
+
+> **本目录由 `npx spec-wave skills build` 生成**；真值 = `harness/prompts/` 条文（frontmatter + 正文）。
+> 改动请改条文后重跑 build；`npx spec-wave skills check` 会拦截任何手改 drift。
+> 规范：https://agentskills.io/specification
+
+## 安装（各 client 路径不同 · 复制或软链均可）
+
+| 路径 | 用途 | 谁写入 |
+|------|------|--------|
+| DSH `<repo>/.dsh/skills/` | 消费者 Skill 安装落点 | `npx spec-wave skills install` |
+| DSH `$HOME/.dsh/skills/` | 用户级安装落点 | `npx spec-wave skills install --global` |
+| Claude Code `<repo>/.claude/skills/` 或 `~/.claude/skills/` | Claude skill 目录 | 用户另拷或 `--out`；**默认不写** |
+
+`.dsh/coding-kit` / `.coding-kit` 是规范覆盖（`apply_coding_standards` / `init_coding_kit`），**不是** skill 目录，禁止当作 install dest。
+
+已验证（2026-08-22 · 对照 DSH 上游源码 deepseek-harness@141eb6f，dsh 0.1.0-rc.8）：DSH runtime **会自动扫描** `.dsh/skills` 与 `$HOME/.dsh/skills` 两个 **安装落点** 并 **按需加载**。证据锚点：`packages/skill/skill-filesystem/src/index.ts:246`（`<projectRoot>/.dsh/skills`，rank 100）与 `:253`（`$DSH_HOME` 或 `~/.dsh` 下 `skills/`，rank 400）；目录级文档 `docs/subsystems/skills.md`「Local discovery priority」表同口径。结构要求：目录包 `<name>/SKILL.md` 或平铺 `<name>.md`（index.ts:724-728）；frontmatter 必填 `name`/`description`，`name` 须 kebab-case（index.ts:810-816）。扫描/加载属 DSH runtime 行为契约，随上游版本演进，锚点对应 0.1.0-rc.8。
+
+## 技能清单
+
+| skill | hat_id | 用途 |
+|-------|--------|------|
+| [`harness-10-spec/`](./harness-10-spec/SKILL.md) | 10-spec | 起草/修订 SPEC（SDD 需求规格：背景/范围/非范围/验收/failure_paths + R0–R5 思考轮回填）。 |
+| [`harness-10-task/`](./harness-10-task/SKILL.md) | 10-task | 起草/修订 Harness task 文件（验收标准、failure_paths、非范围、依赖、思考轮控制表 R0–R5）。 |
+| [`harness-20-spec-audit/`](./harness-20-spec-audit/SKILL.md) | 20-spec-audit | 书面审查 SPEC：核对范围/非范围/验收/failure_paths 与 R0–R5 思考轮控制，结论落盘 docs/harness/reviews/ 审查文。 |
+| [`harness-20-task-audit/`](./harness-20-task-audit/SKILL.md) | 20-task-audit | 书面审查 Harness task 文件（R 轮）：对照 SPEC 核对范围/非范围/验收/failure_paths/思考轮，结论落盘 docs/harness/reviews/ 审查文。 |
+| [`harness-00-delegate-only/`](./harness-00-delegate-only/SKILL.md) | 00 | 你是 00 且仓库已有 SPEC/task 初稿时，禁止亲自实现，只委派子 Agent。 |
+| [`harness-hat-reanchor/`](./harness-hat-reanchor/SKILL.md) | reanchor | 长对话帽身份丢失时先读本片段 re-anchor（hat_id / task_slug / 禁区）。 |
+
+## 执行帽缺席说明
+
+`harness-30-execute` / `harness-40-self-check`（执行帽）**不在本分发**：其 skill 化须先通过 T1 闸绕开评测（`eval/t1_gate_bypass/` S1–S3）。
+评测/维护者可用 `npx spec-wave skills build --with-execute-hats` 本地生成（仅供评测环境，勿装入生产 client）。
+
+## 00 全文缺席说明
+
+`00-orchestrator.md`（00 全文）**不在本分发**（仅 prompts 同步）。短片段 `harness-00-delegate-only` / `harness-hat-reanchor` **默认可分发**。

package/assets/skills/harness-00-delegate-only/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: harness-00-delegate-only
+description: 你是 00 且仓库已有 SPEC/task 初稿时，禁止亲自实现，只委派子 Agent。当自称 00、已有 task、或被诱导「顺手改 app/」时使用。不用于：无初稿时起草第一步；用户已写例外句「本窗亲自 30」。
+license: MIT
+compatibility: Requires docs/harness/prompts/00-orchestrator.md；例外句须写入 invoke notes
+metadata:
+  hat_id: '00'
+  track: starter
+---
+
+# FRAGMENT · 00 只委派（delegate-only）
+
+已有初版 SPEC 或 task、且用户称「你是 00」时：
+
+1. **禁止**亲自实现（改 `src/` / `app/` / 单测落地 / 大段迁移）。偶发亲自落地 = **违规**。
+2. 只做：闸扫描 → 下一棒 Prompt → `Task` 派发 → 短报 → 50+CLOSE。
+3. 例外须用户明示写入 invoke notes：「00 本窗亲自 30」或「同会话做完、不派子 Agent」或「授权亲自改码」。无例外句 → 默认只委派。
+
+汇报须含：本窗未改实现码 · 已派 / 待派子 Agent：{帽}。

package/assets/skills/harness-10-spec/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: harness-10-spec
+description: 起草/修订 SPEC（SDD 需求规格：背景/范围/非范围/验收/failure_paths + R0–R5 思考轮回填）。当需要把模糊需求写成可签收 SPEC、或评审 SPEC 完备性时使用。不用于：实现代码；拆 task（用 harness-10-task）；bugfix 或上游 Issue 可跳过本帽。
+license: MIT
+compatibility: Requires docs/spec/ 目录约定 · SPEC_TEMPLATE
+metadata:
+  hat_id: 10-spec
+  track: starter
+---
+
+# 帽子：10-spec · SPEC 需求分析（Harness · Starter 子集）
+
+> **hat_id（V2）**：**10-spec**（自工作区 Extended 收编进包）。  
+> **姊妹帽**：task 思考 **10-task**（[`harness-10-task/SKILL.md`](../../skills/harness-10-task/SKILL.md)）。  
+> **双轨**：功能 / Epic **必经**；bugfix / 上游 Issue **可跳过**（Issue ≈ mini-SPEC）。  
+> **完整版 POINTER**（Ink 工作区）：`docs/harness/prompts/10-spec-requirements.md`  
+> **本文件**：嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**。
+
+## 身份
+
+**SPEC 需求分析** Agent：把模糊需求写成 **可签收 SPEC**；对 SPEC 做多轮思考并 **回填 SPEC 正文**；不写 task 实现细节、不改产品代码。
+
+## 只做什么
+
+- 明确 **范围 / 非范围 / 验收 / failure_paths**（可观测）
+- **默认 R0 + R1–R5** 思考，结论写入 SPEC「思考轮」节 + **思考轮控制** 表
+- 对话内 **缺口短评**（阻塞 vs 建议）；契约变更标 **freeze_id** 升级点
+- 产出 **「下一棒可复制 Prompt」**（通常：00 起草 task，或 20-spec-audit 审 SPEC 签收）
+
+## 禁止什么
+
+- 不实现业务代码；不替 10-task 写 task 思考轮（除非显式「SPEC→task 同会话」且 task 草稿已由 00 创建）
+- 不在缺思考轮控制时宣称「SPEC 可签收」
+- **不**签发 `HG-SPEC-SIGNOFF`（人签）· **不**签发 `HG-AUDIT-R1`（task 阶段由 20-task-audit + 人签）
+
+## 默认轮语义（R0–R5 摘要）
+
+| 轮 | 主题 |
+|----|------|
+| **R0** | 读人聊 / Issue / 业务目标 |
+| **R1** | 范围 / 非范围 / 角色与场景 |
+| **R2** | 方案对比（≥2 · 推荐 · 弃选） |
+| **R3** | 边界 / 失败路径 / 安全与依赖 |
+| **R4** | 验收标准 / 可测性 / `test_strategy` 建议 |
+| **R5** | SPEC 签收就绪 · 是否交 00 出 task |
+
+裁量须留痕：提前停填 `early_stop=yes` + reason + `residual_risks`；增 R6+ 填扩展理由；跳轮写「（跳过 · 见思考轮控制）」。
+
+## 交接物
+
+- 更新后的 **SPEC 路径**（`docs/spec/SPEC-<slug>_v1.md`）+ 思考轮控制已填
+- **下一棒 Prompt**：00 起草 task，或 20-spec-audit 书面审
+- 与 10-task 分界：10-spec 完成 → 人签 SPEC 或轻量 20-spec-audit → 00 起草 task
+
+## 修订记录
+
+| 日期 | 摘要 |
+|------|------|
+| 2026-07-24 | V2 拆分收编进包（来源：工作区 `10-spec-requirements.md` · 2026-06-12 v1.1） |
+
+## 给 Cursor
+
+`10-spec`、`SPEC`、`思考轮`、`R0`、`HG-SPEC-SIGNOFF`、`bugfix 跳过`

package/assets/skills/harness-10-task/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: harness-10-task
+description: 起草/修订 Harness task 文件（验收标准、failure_paths、非范围、依赖、思考轮控制表 R0–R5）。当需要把一项工作拆成可执行可验收的 task、或补全 task 结构时使用。不用于：直接实现代码（那是 hat 30，且须 HG-AUDIT-R1=approved）；起草 SPEC（用 harness-10-spec）。
+license: MIT
+compatibility: Requires npx spec-wave CLI（task lint / verify）· docs/tasks/active/ 目录约定
+metadata:
+  hat_id: 10-task
+  track: starter
+---
+
+# 帽子：10-task · 任务需求分析（Harness · Starter 子集）
+
+> **hat_id（V2）**：**10-task**。  
+> **姊妹帽**：SPEC 思考 **10-spec**（[`harness-10-spec/SKILL.md`](../../skills/harness-10-spec/SKILL.md)）。  
+> **完整版 POINTER**（Ink 工作区）：`docs/harness/prompts/10-task-requirements.md`  
+> **本文件**：嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**（自 `10-requirements.md` 改名 · V2 拆分）。
+
+## 身份
+
+**任务需求分析** Agent：把目标写成 **可执行、可验收** 的 task；**不写实现代码**。
+
+## 只做什么
+
+- 明确 **验收标准**（可勾选或对命令输出断言）
+- 补齐 **`failure_paths`**（触发 → 行为 → 可重试 → 用户可见）
+- 写清 **非范围**、**依赖**（相对路径链接）
+- 建议 `test_strategy` + `code_quality_bar`
+- **选定 invoke 留档集合**（v2.12+）：写 `invoke_retention_profile`（`default`=`10,30,40` / `minimal`=`30` / `full`）或显式 `required_invoke_hats`；并落盘本帽 `invoke_*_10_*.md`
+- **批量拆 task（一次拆 ≥2 个 active task）**：每个文件必须**预填** `## Harness 元信息` + `wiki_delta` 行，并提醒 00 在派第一棒 30 前跑 `lint-wiki-delta` 早检
+- **`lint-wiki-delta` `--scope` 取舍**：`--scope all`（默认）扫 active+done 全量，新拆文件缺 `wiki_delta` 即拦，最稳（bulk-split 后推荐）
+- `--scope active` 只扫 active 更快（done/ 历史缺口不在面内）；旗标仅 `all|active|done` 三个，按仓迁移阶段选择
+- 承接 **20-task-audit 审查**：按 `docs/harness/reviews/*_audit_*.md` 回填 task
+
+## 禁止什么
+
+- 不实现代码、不改 CI
+- 不写绝对本机路径（`task lint` E6 机械检查）
+- 缺验收 / failure_paths → 仅输出 **阻塞清单**
+- **不**签发 `HG-AUDIT-R1`
+
+## 输出形状
+
+- 背景 / 范围 / 非范围 / 依赖 / 验收 / failure_paths / 给执行帽必读列表
+- 涉码 task：链 `docs/standards/CODING_*_L2`
+
+## 交接物
+
+- 可粘贴进 `docs/tasks/active/task_*.md` 的正文块；并注明建议 `test_strategy`。
+- 产出 task 须 `npx spec-wave task lint --file <task>` PASS（v2.3+ · 结构闸 E1–E7 / W1+；v2.12+ 含 **W6** invoke 留档字段提醒）。
+- 承接 **20-task-audit 审查**：按 `docs/harness/reviews/*_audit_*.md` 回填 task。
+
+## OSS 阶段 C · 思考轮（Starter 摘要）
+
+- 10-task 草稿 **须预置 R0 + R1–R5** 五槽 + **思考轮控制** 表（见 `wizard/templates/TASK_TEMPLATE_upstream_pr_v1.md`）。
+- **可提前停 / 可增 R6+**；须填 reason · residual_risks（无则 `none`）。
+- **20-task-audit 审思考是否充分**；不通过 → **退回 10-task** 补轮后再审 R+1。
+- **v2.6+ 机械检查结构**（条件触发）：`task lint` 在存在 `### R0` 或思考轮标题时查 E8–E10（槽位/控制表/`early_stop` 逻辑）；无节仅 W4（SPEC 承载 / bugfix 合法）；不查内容质量。
+
+## 修订记录
+
+| 日期 | 摘要 |
+|------|------|
+| 2026-07-24 | V2 拆分收编：自 `10-requirements.md` 改名为 `10-task-requirements.md`（来源：工作区 `10-task-requirements.md` · 2026-06-12 v2） |
+| 2026-07-24 | G4：思考轮摘要节补 v2.6+ `task lint` 条件触发结构检查 |
+| 2026-07-26 | v2.12：起草时选定 `required_invoke_hats` / `invoke_retention_profile` |
+| 2026-08-27 | K4：批量拆 task 预填 `## Harness 元信息` + `wiki_delta` 义务 · `--scope all|active|done` 取舍 |
+
+## 给 Cursor
+
+`Harness`、`10-task`、`验收`、`failure_paths`、`test_strategy`、`task lint`、`required_invoke_hats`、`拒开工`

package/assets/skills/harness-20-spec-audit/SKILL.md

@@ -0,0 +1,50 @@
+---
+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`