@cyning/harness 2.0.3 → 2.0.4

package/AGENTS.md

@@ -5,9 +5,10 @@
 ## 阅读顺序
 
 1. [`README.md`](README.md)
-2. [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)
-3. [`docs/ONBOARDING.md`](docs/ONBOARDING.md)
-4. 按任务进入 `harness/templates/` 或 `wizard/`
+2. [`docs/methodology/product/SDD_HAT_FLOW_v2_zh.md`](docs/methodology/product/SDD_HAT_FLOW_v2_zh.md) · 帽链流程
+3. [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)
+4. [`docs/ONBOARDING.md`](docs/ONBOARDING.md)
+5. 按任务进入 `harness/templates/` 或 `wizard/`
 
 ## 修改纪律
 

package/CHANGELOG.md

@@ -4,6 +4,26 @@
 
 ## [Unreleased]
 
+## [2.0.4] - 2026-06-21
+
+### Added
+
+- **[`SDD_HAT_FLOW_v2_zh.md`](docs/methodology/product/SDD_HAT_FLOW_v2_zh.md)**：V2 标准帽链真值（10-spec/10-task · 20-spec-audit/20-task-audit · 30⇄40 同 Agent · 50/CLOSE 打回）
+- **复查落盘**：[`docs/methodology/execution/reviews/review_v2_hat_flow_20260621.md`](docs/methodology/execution/reviews/review_v2_hat_flow_20260621.md)
+
+### Changed
+
+- **[`DESIGN_ONTOLOGY_v1_zh.md`](docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md)** → **v1.3** · §3.2 / §4.1 / §8 与 V2 对齐
+- **[`ontology.yaml`](ontology.yaml)**：`version: "1.3"` · `starter_hats` / `extended_hats` / D1·D2 公理
+- **Starter prompts**：[`harness/prompts/README.md`](harness/prompts/README.md) · [`30-execute-code.md`](harness/prompts/30-execute-code.md) · [`40-self-check.md`](harness/prompts/40-self-check.md) · 30→40 同 Agent 闭环纪律
+- **入口文档**：[`README.md`](README.md) · [`AGENTS.md`](AGENTS.md) · [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) 链 V2 流程
+- **版本**：`package.json` · `ontology.yaml` `product_semver` → **2.0.4**
+
+### Notes
+
+- **HG-RELEASE**：待维护者 publish `@cyning/harness@2.0.4` · tag `v2.0.4`
+- docs-only patch · 无 CLI breaking · `npm test` 72/72
+
 ## [2.0.2] - 2026-06-18
 
 ### Added

package/README.md

@@ -54,20 +54,22 @@ git clone git@github.com:Cyning12/cyning-harness.git && cd cyning-harness
 /path/to/cyning-harness/wizard/harness-sync.sh apply --target /path/to/your-repo
 ```
 
-**P0 金样（10→22→30）：** [`examples/demo_checkout/README.md`](examples/demo_checkout/README.md) · [`docs/methodology/execution/P0_V0.2_GAP.md`](docs/methodology/execution/P0_V0.2_GAP.md)
+**P0 金样：** [`examples/demo_checkout/README.md`](examples/demo_checkout/README.md) · 完整帽链见 [`docs/methodology/product/SDD_HAT_FLOW_v2_zh.md`](docs/methodology/product/SDD_HAT_FLOW_v2_zh.md)
 
 **Kimi Code fork：** `--preset oss-fork-meta` 或 [`wizard/bootstrap-oss-fork-meta.sh`](wizard/bootstrap-oss-fork-meta.sh) · 过程轨不进上游 PR。
 
 ---
 
-## 典型工作流
+## 典型工作流（V2）
 
 ```text
-install / adopt  →  harness-sync plan/apply  →  @ task + prompts（10→22→30）
-                      ↑ 产品包 git pull 后 upgrade.sh
-30 前：npx @cyning/harness verify  ·  HG-AUDIT-R1 = approved
+人 + 00 大纲 → 10-spec → 20-spec-audit + HG-SPEC-SIGNOFF
+  → 00 起草 task → 10-task → 20-task-audit + HG-AUDIT-R1
+  → 30（含 40 自检闭环）→ [50] → CLOSE
 ```
 
+Starter 包：`10-task` · `20-task-audit` · `30` · `40` · 30 前 `npx @cyning/harness verify` · **HG-AUDIT-R1 = approved**
+
 1. 阅读 [`docs/ONBOARDING.md`](docs/ONBOARDING.md)  
 2. [`npx @cyning/harness init`](docs/USER_GUIDE_v1.0_zh.md) 或 [`wizard/install.sh`](wizard/install.sh) / [`adopt-existing.sh`](wizard/adopt-existing.sh)  
 3. 产品包更新：`npx @cyning/harness upgrade` 或 [`wizard/upgrade.sh`](wizard/upgrade.sh) / [`harness-sync.sh`](wizard/harness-sync.sh) `apply`  

package/docs/ARCHITECTURE.md

@@ -65,7 +65,8 @@ CLI/Worker 与模板 **同一仓库** 演进，避免多仓割裂。
 
 ## 7. 产品设计本体
 
-Track / Hat / Sync / SDD 公理与扩展规则见 [`methodology/product/DESIGN_ONTOLOGY_v1_zh.md`](./methodology/product/DESIGN_ONTOLOGY_v1_zh.md)（**v1.2**）。  
+Track / Hat / Sync / SDD 公理与扩展规则见 [`methodology/product/DESIGN_ONTOLOGY_v1_zh.md`](./methodology/product/DESIGN_ONTOLOGY_v1_zh.md)（**v1.3**）。  
+**帽链流程（人读）**：[`methodology/product/SDD_HAT_FLOW_v2_zh.md`](./methodology/product/SDD_HAT_FLOW_v2_zh.md)  
 **方法论总指引**：[`methodology/README.md`](./methodology/README.md) · 关系图 [`methodology/DOCUMENT_MAP_v1_zh.md`](./methodology/DOCUMENT_MAP_v1_zh.md)  
 远期 **过程实例图 + 事件历史** 见 [`methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md`](./methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md)（HGM · **v2.0+** 提案 · v1.0 后）。  
 与 **战略本体**（工作区 `docs/harness/guides/STRATEGY_ONTOLOGY_*`）分层：本文件描述 **产品如何实现**，战略文档描述 **对外演进**。

package/docs/methodology/execution/PROMPT_review_v203_v2_hat_flow_bump_v1_zh.md

@@ -0,0 +1,136 @@
+# cyning-harness · V2 帽链复查 + 小版本升级 Prompt
+
+> **Open Folder**：**`cyning-harness/`**（产品仓根 · **非** `Projects/` 工作区根）  
+> **角色**：维护者 Agent · **文档/纪律包**复查 · 可选 **patch 发版**  
+> **触发提交**：`b868671` · `docs(product): V2 帽链 SDD_HAT_FLOW_v2 与本体/Starter 对齐`  
+> **当前版本**：`package.json` → **2.0.3**
+
+| 项 | 值 |
+|----|-----|
+| **task_slug** | `cyning-harness-v2-hat-flow-review` |
+| **auditor_hat** | 自检 + 维护者 CLOSE（**非** 工作区 20-task-audit） |
+| **目标版本（若通过）** | **2.0.4**（docs-only patch · 无 CLI breaking） |
+| **HG-RELEASE** | npm publish / GitHub Release **须人签** · Agent **仅** bump + CHANGELOG + tag + push（若用户授权 push） |
+
+---
+
+## 用法
+
+1. Cursor **Open Folder** → `cyning-harness/`  
+2. **新对话** · 复制下方 **§ 可复制 Prompt 正文**  
+3. Agent 落盘复查结论 → 无阻塞则执行 **2.0.4** 升级清单  
+
+---
+
+## 复查范围（须逐项 pass / fail）
+
+### A · 帽链真值一致性
+
+| # | 核对项 | 路径 |
+|---|--------|------|
+| A1 | **标准流程** 与人描述一致（00→10-spec→20-spec→HG-SPEC-SIGNOFF→00 task→10-task→20-task→HG-AUDIT→30⇄40→50→CLOSE） | [`../product/SDD_HAT_FLOW_v2_zh.md`](../product/SDD_HAT_FLOW_v2_zh.md) |
+| A2 | §3.2 / §4.1 / §8 与 A1 **无矛盾** | [`../product/DESIGN_ONTOLOGY_v1_zh.md`](../product/DESIGN_ONTOLOGY_v1_zh.md) |
+| A3 | `ontology.yaml` **version 1.3** · `starter_hats` / `extended_hats` / D1·D2 与 A1 一致 | [`../../../ontology.yaml`](../../../ontology.yaml) |
+| A4 | `harness/prompts/README` + **30/40** 写明 **同 Agent 闭环** | [`../../../harness/prompts/`](../../../harness/prompts/README.md) |
+| A5 | 入口文档链到 V2 流程 | [`../../../README.md`](../../../README.md) · [`../../../AGENTS.md`](../../../AGENTS.md) · [`../../ARCHITECTURE.md`](../../ARCHITECTURE.md) |
+
+### B · 残留旧编号（应为别名或已更新）
+
+| # | 核对项 |
+|---|--------|
+| B1 | 无 **唯一真值**仍写「10→22→30 金样」且无 V2 上下文 |
+| B2 | `22-task-audit` / `10-requirements` 文件 **HEADER** 标明 V2 hat_id |
+| B3 | `lib/` · `test/` · `golden/` · `examples/demo_checkout/` · `docs/USER_GUIDE*.md` 中 **blocks 30 / D2** 语义仍正确（pending gate 禁 30） |
+| B4 | [`../pointers/SDD_HAT_FLOW_v1_zh.md`](../pointers/SDD_HAT_FLOW_v1_zh.md) 指向 **SDD_HAT_FLOW_v2** |
+
+### C · 机械验证（须跑命令 · 贴退出码）
+
+```bash
+cd /path/to/cyning-harness
+npm test
+node bin/harness.js check --target examples/demo_checkout 2>/dev/null || true
+npm pack --dry-run 2>&1 | head -20
+```
+
+| # | 通过标准 |
+|---|----------|
+| C1 | `npm test` 全绿 |
+| C2 | `harness check` 无新增 error（warn 须列出） |
+| C3 | `npm pack` 无 `_sandbox` / `.env` / 密钥路径 |
+
+---
+
+## 落盘（必须）
+
+路径：`docs/methodology/execution/reviews/review_v2_hat_flow_YYYYMMDD.md`
+
+文内结构：
+
+1. 元信息（base commit · 审查 Agent · 日期）  
+2. **A/B/C 核对表**（每项 pass / fail + 一行证据）  
+3. **阻塞 / 非阻塞** 清单  
+4. **结论**：`ready_for_2.0.4` | `needs_fix`（附修复文件列表）  
+
+---
+
+## 若无阻塞 · 2.0.4 升级清单（顺序执行）
+
+> **范围**：仅 docs/ontology/prompts/版本号 · **不改** CLI 行为除非测试失败迫使修 bug。
+
+- [ ] `package.json` → `"version": "2.0.4"`  
+- [ ] `ontology.yaml` → `product_semver: "2.0.4"`（若字段存在）  
+- [ ] `CHANGELOG.md`：将 [`Unreleased`] 下写入 **2.0.4** 节（Added/Changed · 链 `SDD_HAT_FLOW_v2` · DESIGN_ONTOLOGY v1.3 · 30⇄40 纪律）  
+- [ ] 修复 B 节发现的 **阻塞** 文档漂移（若有）  
+- [ ] `npm test` 再跑一遍  
+- [ ] `git commit`（type: `docs(release)` 或 `chore(release)`）  
+- [ ] `git tag v2.0.4` · **仅当用户明确要求 push 时** `git push origin main && git push origin v2.0.4`  
+- [ ] **npm publish**：**禁止 Agent 自动执行** · 输出 [`TEMPLATE_HG_RELEASE_v1_zh.md`](./TEMPLATE_HG_RELEASE_v1_zh.md) 勾选提醒给人  
+
+---
+
+## 禁止什么
+
+- **Open 工作区根**改 Ink `docs/harness/`（本 Prompt 只动 **cyning-harness** 仓）  
+- 未跑 C 节就宣称 ready  
+- 无复查 md 就 bump 版本  
+- 擅自 `npm publish` · 改 GitHub visibility  
+
+---
+
+## 可复制 Prompt 正文
+
+```text
+你是 cyning-harness 维护者复查 Agent。Open Folder 必须是 cyning-harness 产品仓根。
+
+## 背景
+刚合并 V2 帽链文档（commit b868671）：SDD_HAT_FLOW_v2、DESIGN_ONTOLOGY v1.3、ontology.yaml、Starter prompts 30⇄40 同 Agent 纪律。当前 package 版本 2.0.3。
+
+## 必读
+@docs/methodology/execution/PROMPT_review_v203_v2_hat_flow_bump_v1_zh.md
+@docs/methodology/product/SDD_HAT_FLOW_v2_zh.md
+@docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md
+@ontology.yaml
+@harness/prompts/README.md
+@harness/prompts/30-execute-code.md
+@harness/prompts/40-self-check.md
+@CHANGELOG.md
+@package.json
+
+## 任务
+1. 按 Prompt 文档 **A/B/C** 节逐项复查；跑 npm test 与 harness check（命令见 C 节）。
+2. 落盘 docs/methodology/execution/reviews/review_v2_hat_flow_YYYYMMDD.md。
+3. 若无阻塞：执行 **2.0.4 升级清单**（bump · CHANGELOG · commit · tag v2.0.4）。
+4. 若有阻塞：只输出修复清单与最小 diff 建议，**不要** bump 版本。
+5. 结尾输出：审查结论 · commit short-hash · 是否 ready for HG-RELEASE（npm 须人签）。
+
+## 标准流程真值（核对用）
+人+00 大纲 → 10-spec R0–R9 → 20-spec-audit + HG-SPEC-SIGNOFF → 00 起草 P0 task → 10-task → 20-task-audit R1 → HG-AUDIT-R1 → 30→40（同 Agent 自修重跑）→ 50（↺30）→ CLOSE。
+```
+
+---
+
+## 修订记录
+
+| 日期 | 摘要 |
+|------|------|
+| 2026-06-21 | v1：post b868671 复查 + 2.0.4 patch 升级 Prompt |

package/docs/methodology/execution/README.md

@@ -4,6 +4,7 @@
 | --- | --- |
 | **[`P0_V0.2_GAP.md`](./P0_V0.2_GAP.md)** | v0.2 最小闭环 · 已有/缺口 · 演示命令 |
 | **[`PILOT_EVIDENCE_B2_v1_zh.md`](./PILOT_EVIDENCE_B2_v1_zh.md)** | Track B · B2 量化 + SDD-Compliance bench（**draft · #8**） |
+| **[`PROMPT_review_v203_v2_hat_flow_bump_v1_zh.md`](./PROMPT_review_v203_v2_hat_flow_bump_v1_zh.md)** | V2 帽链 post-merge 复查 · **2.0.4** patch 升级 |
 
 **金样路径**：[`../../examples/demo_checkout/`](../../examples/demo_checkout/README.md) + [`ACCEPTANCE.md`](../../examples/demo_checkout/ACCEPTANCE.md)
 

package/docs/methodology/execution/reviews/review_v2_hat_flow_20260621.md

@@ -0,0 +1,71 @@
+# V2 帽链复查 · post b868671
+
+## 元信息
+
+| 项 | 值 |
+|----|-----|
+| **base commit** | `b868671` · `docs(product): V2 帽链 SDD_HAT_FLOW_v2 与本体/Starter 对齐` |
+| **审查 Agent** | cyning-harness 维护者复查 Agent |
+| **日期** | 2026-06-21 |
+| **task_slug** | `cyning-harness-v2-hat-flow-review` |
+| **当前包版本（审查时）** | 2.0.3 |
+| **目标版本** | 2.0.4（docs-only patch） |
+
+---
+
+## A · 帽链真值一致性
+
+| # | 结果 | 证据 |
+|---|------|------|
+| A1 | **pass** | [`SDD_HAT_FLOW_v2_zh.md`](../../product/SDD_HAT_FLOW_v2_zh.md) §1 标准流程与人描述一致：00→10-spec→20-spec-audit↔HG-SPEC-SIGNOFF→00 起草 P0→10-task→20-task-audit↔HG-AUDIT-R1→30→40（同 Agent）→50→CLOSE |
+| A2 | **pass** | [`DESIGN_ONTOLOGY_v1_zh.md`](../../product/DESIGN_ONTOLOGY_v1_zh.md) v1.3 · §3.2 / §4.1 / §8 与 A1 一致；§4.1 显式链 SDD_HAT_FLOW_v2 |
+| A3 | **pass** | [`ontology.yaml`](../../../../ontology.yaml) `version: "1.3"` · `starter_hats`（10-task/20-task-audit/30/40）· `extended_hats`（10-spec/20-spec-audit/00/50）· D1/D2 公理与 V2 一致 |
+| A4 | **pass** | [`harness/prompts/README.md`](../../../../harness/prompts/README.md) V2 流程 · 30/40 同 Agent；[`30-execute-code.md`](../../../../harness/prompts/30-execute-code.md) §输出形状含 40 闭环；[`40-self-check.md`](../../../../harness/prompts/40-self-check.md) §身份写明 30 同 Agent |
+| A5 | **pass** | [`README.md`](../../../../README.md) §典型工作流（V2）+ 链 SDD_HAT_FLOW_v2；[`AGENTS.md`](../../../../AGENTS.md) 阅读顺序 #2；[`ARCHITECTURE.md`](../../../ARCHITECTURE.md) §7 链 SDD_HAT_FLOW_v2 |
+
+---
+
+## B · 残留旧编号
+
+| # | 结果 | 证据 |
+|---|------|------|
+| B1 | **pass** | 无文档作为**唯一真值**写「10→22→30 金样」且无 V2 上下文；[`README.md`](../../../../README.md) / prompts README 已 V2。历史执行文档（`P0_V0.2_GAP.md` · `demo_checkout/ACCEPTANCE.md` · `golden/POINTER_*`）仍用文件名别名 **10→22→30**，属 v0.2 金样考古 · **非阻塞** |
+| B2 | **pass** | [`10-requirements.md`](../../../../harness/prompts/10-requirements.md) HEADER：`hat_id（V2）：10-task`；[`22-task-audit.md`](../../../../harness/prompts/22-task-audit.md) HEADER：`hat_id（V2）：20-task-audit` |
+| B3 | **pass** | `lib/task-meta.js` `evaluateMayStart30`：HG-AUDIT-R1 非 approved → blocked；`test/graph-hgm.test.js` checkAxioms D2；`test/verify.test.js` pending → exit 2 / may_start_30 false |
+| B4 | **pass** | [`pointers/SDD_HAT_FLOW_v1_zh.md`](../../pointers/SDD_HAT_FLOW_v1_zh.md) 产品仓真值 → SDD_HAT_FLOW_v2 |
+
+---
+
+## C · 机械验证
+
+| # | 结果 | 证据 |
+|---|------|------|
+| C1 | **pass** | `npm test` · **72/72** 绿 · exit **0**（须在非沙箱环境；沙箱 EPERM 读 `node_modules/js-yaml` 会误红） |
+| C2 | **pass** | `node bin/harness.js check --target examples/demo_checkout` · exit **0** · 状态：未接入（无 manifest）· 无 error |
+| C3 | **pass** | `npm pack --dry-run` · 无 `_sandbox` / `.env` / 密钥路径 |
+
+---
+
+## 阻塞 / 非阻塞
+
+### 阻塞
+
+无。
+
+### 非阻塞（可选后续）
+
+| 项 | 说明 |
+|----|------|
+| 历史金样文案 | `examples/demo_checkout/` · `P0_V0.2_GAP.md` 等仍写「10→22→30」文件名路径 · 可加 V2 脚注 |
+| USER_GUIDE FAQ | §12「10→22→30→40」可改为「10-task→20-task-audit→30→40」 |
+| `ontology.yaml` product_semver | 审查时为 `2.0.0` · 与 package 2.0.3 漂移 · **2.0.4 bump 一并修正** |
+
+---
+
+## 结论
+
+**`ready_for_2.0.4`**
+
+审查通过后执行：package.json 2.0.4 · ontology product_semver 2.0.4 · CHANGELOG · commit · tag v2.0.4。
+
+**HG-RELEASE**：npm publish / GitHub Release **须维护者人签** · 见 [`TEMPLATE_HG_RELEASE_v1_zh.md`](../TEMPLATE_HG_RELEASE_v1_zh.md)。

package/docs/methodology/pointers/SDD_HAT_FLOW_v1_zh.md

@@ -1,8 +1,9 @@
-# POINTER · SDD_HAT_FLOW（工作区）
+# POINTER · SDD 帽链流程
 
 | 项 | 内容 |
 | --- | --- |
-| **真值** | [`docs/harness/SDD_HAT_FLOW.md`](../../../../docs/harness/SDD_HAT_FLOW.md) |
-| **说明** | 历史帽编号流程 · **Starter 以产品仓为准** |
+| **产品仓真值** | [`../product/SDD_HAT_FLOW_v2_zh.md`](../product/SDD_HAT_FLOW_v2_zh.md) |
+| **工作区 Extended** | [`docs/harness/guides/GUIDANCE_harness_hat_v2_chain_v1_zh.md`](../../../../docs/harness/guides/GUIDANCE_harness_hat_v2_chain_v1_zh.md) |
+| **历史 v1** | [`docs/harness/SDD_HAT_FLOW.md`](../../../../docs/harness/SDD_HAT_FLOW.md)（旧编号 · 考古） |
 
-产品 SDD 对照：[`../product/DESIGN_ONTOLOGY_v1_zh.md`](../product/DESIGN_ONTOLOGY_v1_zh.md) §8
+本体对照：[`../product/DESIGN_ONTOLOGY_v1_zh.md`](../product/DESIGN_ONTOLOGY_v1_zh.md) §4.1 · §8

package/docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md

@@ -1,11 +1,11 @@
-# 产品设计本体 · cyning-harness（v1.2）
+# 产品设计本体 · cyning-harness（v1.3）
 
 
 | 项       | 内容                                                                                                                    |
 | ------- | --------------------------------------------------------------------------------------------------------------------- |
 | **状态**  | `draft`                                                                                                               |
-| **版本**  | v1.2                                                                                                                  |
-| **日期**  | 2026-06-15                                                                                                            |
+| **版本**  | v1.3                                                                                                                  |
+| **日期**  | 2026-06-21                                                                                                            |
 | **范围**  | **产品内部**概念模型 · 指导模板 / wizard / sync / SDD 链实现                                                                         |
 | **非范围** | 商业战略、ETCLOVG 行业对标（见 [`../pointers/STRATEGY_ONTOLOGY_v1_zh.md`](../pointers/STRATEGY_ONTOLOGY_v1_zh.md)） |
 | **真值**  | 本文件 + [`../../ARCHITECTURE.md`](../../ARCHITECTURE.md) + [`../../../harness/templates/`](../../../harness/templates/) + `ontology.yaml`（机器可读抽取 · v0.4+ · 与本文件同目录） |
@@ -64,7 +64,7 @@ Stakeholder                       Hat · Task · Gate · Review 运行时
 
 ```yaml
 # docs/ontology.yaml · 从本 Markdown 抽取 · 非第二真值
-version: "1.2"
+version: "1.3"
 classes:
   - id: Track
     domain: Package
@@ -110,7 +110,7 @@ schemas:
 | **VersionManifest**   | 钉住产品包版本（v0.3+）       | `.cyning-harness/manifest.json`    | `{ "version": "0.3.0" }`   |
 | **Task**              | 可验收工作项文档             | `docs/tasks/active/task_*.md`      | 改码 task                    |
 | **Epic**              | 多 Task 总纲（**v1 暂为 Task 特化** · 见 §1.4） | `docs/tasks/active/TASK_epic_*.md` | Epic 编排                    |
-| **Hat**               | SDD 角色帽（行为约束）        | `docs/harness/prompts/N-*.md`      | `22-task-audit`            |
+| **Hat**               | SDD 角色帽（行为约束）        | `docs/harness/prompts/N-*.md`      | `20-task-audit`（Starter 别名 `22-task-audit`） |
 | **InvokeSnapshot**    | 新帽开局时的调用体落盘          | `docs/harness/invokes/`            | `invoke_*_30_*.md`         |
 | **AuditReview**       | 任务审核书面产出             | `docs/harness/reviews/`            | `*_audit_R1_*.md`          |
 | **FailureReport**     | 30 执行失败时的结构化产出（v0.3+） | `docs/harness/reviews/` 或 task 附录 | `*_30_failure_*.md`        |
@@ -213,7 +213,7 @@ Task --executedIn--> ExecutionShell                [external]  # Cursor / Kimi C
 
 ```yaml
 Hat:
-  hat_id: string                 # 稳定 ID · 如 "22-task-audit" · gate-check 解析用
+  hat_id: string                 # 稳定 ID · 如 "20-task-audit" · gate-check 解析用 · 历史 "22-task-audit" 为别名
 
 Task:
   task_slug: string
@@ -259,7 +259,9 @@ SyncOperation:
 | HumanGate → blocks_hats     | **1..*** · **无重复 hat_id** | 同一 Gate 内不可重复阻塞同一帽 |
 | Hat → blocked_by_gates      | **0..***（同 Task 内） | 多 Gate 可叠阻塞同一 Hat（如 30） |
 | Task → HG-AUDIT-R1          | 改码类 **1:1 必须** | 30 前须存在且可解析   |
-| 22 每轮 → AuditReview         | **1:1 必须**     | 零阻塞也落盘        |
+| Task → HG-SPEC-SIGNOFF      | Epic / 功能轨 **0..1** | SPEC 已 signed 后 00 方可派 P0 task 链至 30 |
+| 20-task-audit 每轮 → AuditReview | **1:1 必须**     | 零阻塞也落盘        |
+| 20-spec-audit 每轮 → AuditReview | **1:1 必须**（功能轨） | 如 `*_spec_ACCEPT_*` |
 | InvokeSnapshot → 新帽开局       | **0..1**       | 每帽首次 §3 替换后落盘 |
 | Sync → Task/Reviews/by-task | **禁止覆盖**       | 业务数据与纪律层分离    |
 
@@ -304,23 +306,36 @@ instance_marker: .cyning-harness/tracks/process.yaml
 
 JSON Schema 真值：`docs/schemas/track-schema.json`（v0.4+ · 与 `ontology.yaml` 的 `schemas.track` 互链）。
 
-### 3.2 帽链（Hat 特化 · Starter vs Extended）
+### 3.2 帽链（Hat 特化 · Starter vs Extended · **V2**）
 
 ```text
 Hat（抽象）
-├── OrchestratorHat（00 · 工作区 Extended · 非 Starter 默认）
-├── StarterHat
-│   ├── RequirementsHat（10）
-│   ├── TaskAuditHat（22）
-│   └── ExecuteHat（30）
-└── ExtendedHat（工作区 POINTER · 20/40/50/链式 PROMPT）
+├── OrchestratorHat（00 · Extended · 工作区）
+├── RequirementsHat（10 · 拆为两子类）
+│   ├── SpecRequirementsHat（10-spec · Extended）
+│   └── TaskRequirementsHat（10-task · Starter 别名 10-requirements）
+├── AuditHat（20 · 拆为两子类 · 均须 reviews/）
+│   ├── SpecAuditHat（20-spec-audit · Extended · HG-SPEC-SIGNOFF）
+│   └── TaskAuditHat（20-task-audit · Starter 别名 22-task-audit · HG-AUDIT-R1）
+├── ExecuteHat（30 · Starter）
+├── SelfCheckHat（40 · Extended · A2 待入 Starter）
+└── ReinspectHat（50 · Extended）
 ```
 
+**10 / 20 双类型对照（V2 · 与工作区 [`GUIDANCE_harness_hat_v2_chain_v1_zh.md`](../../../../docs/harness/guides/GUIDANCE_harness_hat_v2_chain_v1_zh.md) 对齐）**
+
+| 10（思考回填） | 20（书面审） | 人闸 |
+|----------------|--------------|------|
+| **10-spec** | **20-spec-audit** | **HG-SPEC-SIGNOFF** |
+| **10-task** | **20-task-audit** | **HG-AUDIT-R1** |
+
+**轻量 task（维护者同意）**：SPEC 已 HG-SPEC-SIGNOFF → 00 草稿 → **10-task R0–R2** → **20-task-audit R1** → HG-AUDIT-R1 → 30→40→…
+
 **设计决策**：
 
-- 产品包默认闭包 = **StarterHat 子集 + ProcessTrack**。
-- **ExtendedHat 仅供内部 / 签约伙伴** · 工作区 POINTER · **不**复制进用户仓 · README 须明确声明，避免社区误以为功能缺失。
-- `blocks_hats` **必须**引用 `Hat.hat_id` · gate-check 动态解析 · **禁止**硬编码裸编号字符串作为唯一真值。
+- 产品包 Starter 闭包 = **10-task（10-requirements）+ 20-task-audit（22-task-audit）+ 30 + 40**（A2）。  
+- **10-spec / 20-spec-audit** 为 **ExtendedHat** · 工作区 POINTER · **不**默认复制进用户仓。  
+- `blocks_hats` **必须**引用 `Hat.hat_id` · gate-check 动态解析 · **禁止**硬编码裸编号字符串作为唯一真值 · **须**接受历史别名 `22-task-audit`。
 
 ### 3.3 Preset 特化
 
@@ -367,36 +382,69 @@ Task（抽象）
 
 ## 4. 状态机与生命周期
 
-### 4.1 SDD 帽链（ProcessTrack 核心）
+### 4.1 SDD 帽链（ProcessTrack 核心 · **V2**）
+
+**标准流程（人读版 · 与 [`SDD_HAT_FLOW_v2_zh.md`](./SDD_HAT_FLOW_v2_zh.md) 一致）**
 
 ```text
-[00] ──► 10 ◄──────────────────────────────────────────────┐
-          │ draft/pending/in_progress                        │
-          ▼                                                  │
-        [20?] ──► 22(R*) ──[HG approved]──► 30 ──► 40 ──► 22(CLOSE) ──► done
+人 + 00 chat 大纲
+  → 10-spec R0–R9
+  → 20-spec-audit + HG-SPEC-SIGNOFF（人签 · 可多轮修改）
+  → 00 起草 P0 task
+  → 10-task
+  → 20-task-audit R1（↺ 10-task）
+  → HG-AUDIT-R1（人签）
+  → 30 → 40（同 Agent · 自修重跑 40 直至通过）
+  → 50（↺ 30 · 可选）
+  → CLOSE（小问题 → 下一 task/SPEC · 偏差过大 → 10-spec/10-task）
+```
+
+**状态机（实现读版）**
+
+```text
+[00] ──► 10-spec ◄──────────────────────────────┐
+          │                                        │
+          ▼                                        │
+     20-spec-audit(R*) ──[HG-SPEC-SIGNOFF]──► [00 起草 task]
+          │         │                              │
+          │         └── 人 rejected / 未过 ──► 10-spec
+          └── 否决 ──► 10-spec                     │
+                                                   │
+[00] ──► 10-task ◄─────────────────────────────────┤
+          │                                        │
+          ▼                                        │
+     20-task-audit(R*) ──[HG-AUDIT-R1]──► 30 ══► 40（同 Agent 闭环）
           │         │                         │
-          │         ├── HG pending ──► blocked ──► (approve) ──► 继续
-          │         ├── HG rejected ──► task.status=draft ──► 10（强制）
-          │         └── 30 失败 ──► FailureReport ──► failed ──► 22 或 10
-          └── 否决 ──► 10
+          │         │                         ├── 50? ── fail ──► 30
+          │         │                         └── CLOSE ──► done | 下一 task | ↺ 10
+          │         ├── HG pending ──► blocked
+          │         ├── HG rejected ──► 10-task
+          │         └── 30 失败 ──► FailureReport ──► 20-task-audit 或 10-task
+          └── 否决 ──► 10-task
 ```
 
-**FailureReport 联动（模板级 · v0.3+）**：10 / 22 Prompt **须**检查 task 是否关联 `FailureReport`；若存在，`failed` 原因与退回路径须在 Review / 需求节 **显式引用** 该 Artifact 路径。
+**30→40 纪律**：40 为 Verify 子步；**默认不单独派 40 对话** · 30 Agent 跑 task 验证命令、回填自检结论 · 不通过则改码并重跑直至通过。
+
+**bugfix 轨**：跳过 10-spec / 20-spec-audit · 自 **10-task → 20-task-audit → 30**。
+
+**FailureReport 联动（模板级 · v0.3+）**：10-task / 20-task-audit Prompt **须**检查 task 是否关联 `FailureReport`；若存在，`failed` 原因与退回路径须在 Review / 需求节 **显式引用** 该 Artifact 路径。
 
 | 转移      | 条件                                              |
 | ------- | ----------------------------------------------- |
-| → 30    | `HG-AUDIT-R1 = approved` **且** 22 无内容阻塞         |
+| → 30    | `HG-AUDIT-R1 = approved` **且** 20-task-audit 无内容阻塞         |
+| Epic → 30（链） | **另须** `HG-SPEC-SIGNOFF = approved`（若 task 自 SPEC 投影） |
 | 30 拒开工  | 任一 blocking gate = pending · 或 failure_paths 缺失 → **blocked** |
-| 30 执行失败 | 产出 **FailureReport** · task.status → **failed** · 维护者选择退回 22 或 10 |
-| HG rejected | 记录否决理由 · task.status → **draft** · **强制** 回 10 | 
-| → CLOSE | 22 终轮「签收/关闭」节 + task status → done              |
-| 10 重入   | 来自 20 否决 · HG **rejected** · 30 **failed**（含 FailureReport） |
+| 30 执行失败 | 产出 **FailureReport** · task.status → **failed** · 维护者选择退回 20-task-audit 或 10-task |
+| HG rejected | 记录否决理由 · task.status → **draft** · **强制** 回 10-task | 
+| → CLOSE | 50 pass 或跳过 50 · task status → done · **小问题**留下一 task/SPEC · **偏差过大**维护者 ↺ 10-spec/10-task |
+| 50 fail | 打回 **30** 修复 |
+| 10-task 重入   | 20-spec-audit / 20-task-audit 否决 · HG **rejected** · 30 **failed** · CLOSE 决策重开 |
 
 
 | Task.status | 含义 | 恢复路径 |
 | --- | --- | --- |
 | `blocked` | Gate pending 或 30 拒开工 | Gate approved → 继续 30 |
-| `failed` | 30 执行失败已落 FailureReport | 退回 22 修复 或 退回 10 重定范围 |
+| `failed` | 30 执行失败已落 FailureReport | 退回 20-task-audit 或 退回 10-task 重定范围 |
 
 ### 4.2 HumanGate
 
@@ -410,7 +458,7 @@ pending ──(maintainer reject)──► rejected
 pending ──(Agent 30 扫描)──► BLOCKED（运行时 · 非持久 status）──► TEMPLATE_30_gate_stop
 ```
 
-| status | 22 行为 | 30 行为 | 后续 |
+| status | 20-task-audit 行为 | 30 行为 | 后续 |
 | --- | --- | --- | --- |
 | `pending` | 可产出 Review · **禁止**附 30 Prompt（D2） | **BLOCKED** | — |
 | `approved` | 正常 | 允许开工 | — |
@@ -494,8 +542,8 @@ R1 ──(零阻塞 + 人签)──► 30 允许
 
 | ID     | 公理                                                  |
 | ------ | --------------------------------------------------- |
-| **D1** | 每次 22 **必须** 产出 `AuditReview`（零阻塞须写明）               |
-| **D2** | `HG-AUDIT-R1 = pending` 时 22 **禁止** 附 30 Prompt     |
+| **D1** | 每次 **20-task-audit** **必须** 产出 `AuditReview`（零阻塞须写明）               |
+| **D2** | `HG-AUDIT-R1 = pending` 时 **20-task-audit** **禁止** 附 30 Prompt     |
 | **D3** | 30 首输出 **必须** 扫描 task 闸表（见 `TEMPLATE_30_gate_stop`） · 目标 CLI：`gate-check` |
 | **D4** | 改码 task 开工前 `HG-GRAPH-MODULES = approved`（D4-a）     |
 | **D5** | `test_strategy=required` → 须先失败测试再实现（或同 PR 可见红过）    |
@@ -620,18 +668,22 @@ npx CLI  ≡  WizardTool 新实例
 
 ---
 
-## 8. 与 SDD 编号对照（快速查）
+## 8. 与 SDD 编号对照（快速查 · **V2**）
+
+> 链真值（工作区）：[`docs/harness/guides/GUIDANCE_harness_hat_v2_chain_v1_zh.md`](../../../../docs/harness/guides/GUIDANCE_harness_hat_v2_chain_v1_zh.md)
 
+| 编号  | Hat 类 / hat_id      | 必落盘类             | Starter |
+| --- | --------------- | ---------------- | --- |
+| 00  | OrchestratorHat | —（Handoff / KPI · Extended） | — |
+| **10-spec** | SpecRequirementsHat | SPEC（更新） | Extended |
+| **10-task** | TaskRequirementsHat | Task（更新） | ✅（`10-requirements` 别名） |
+| **20-spec-audit** | SpecAuditHat | **AuditReview**（`*_spec_*`） | Extended |
+| **20-task-audit** | TaskAuditHat | **AuditReview**（`*_audit_*`） | ✅（`22-task-audit` 别名） |
+| 30  | ExecuteHat | 代码 diff · **FailureReport**（失败时） | ✅ |
+| 40  | SelfCheckHat | Task.自检结论 | Extended（A2 待入 Starter） |
+| 50  | ReinspectHat | 可选 Review | Extended |
 
-| 编号  | Hat 类           | 必落盘类             |
-| --- | --------------- | ---------------- |
-| 00  | OrchestratorHat | —（Handoff / KPI · Extended） |
-| 10  | RequirementsHat | Task（更新）         |
-| 20  | SpecReviewHat   | —（对话 · Extended） |
-| 22  | TaskAuditHat    | **AuditReview**  |
-| 30  | ExecuteHat      | 代码 diff · **FailureReport**（失败时） |
-| 40  | SelfCheckHat    | Task.自检结论 · Extended Starter 待 A2 |
-| 50  | ReinspectHat    | 可选 Review · Extended |
+**历史编号（别名 · 勿删）**：`20-review-spec-task` → **10-spec**；`10-requirements` → **10-task**；`22-task-audit` → **20-task-audit**。
 
 
 ---
@@ -697,7 +749,7 @@ npx CLI  ≡  WizardTool 新实例
 ### 11.1 下一步优先级（评审共识 · 非本体变更）
 
 ```text
-P0  最小 v0.2 闭环（harness-only · sync plan/apply · 10→22→30 金样）
+P0  最小 v0.2 闭环（harness-only · sync · 见 SDD_HAT_FLOW_v2 标准流程）
 P1  gate-check 基础 · README Quick Start + §7.5 展开
 P2  examples/kimi-code-integration（v0.3）· 第一篇对外博客
 P3  v0.2.0 tag · Kimi 社区触达 · 简历链 GitHub
@@ -716,4 +768,5 @@ P3  v0.2.0 tag · Kimi 社区触达 · 简历链 GitHub
 | v1.1 | 2026-06-15 | 吸收外部评审：元本体 · ICVO · 异常态 · 迁移/rollback · Epic 编排 · S5/S6/D7 · track.yaml · Q5 |
 | v1.1.1 | 2026-06-15 | Preset 更名 `kimi-code-meta` · §3.3.1 meta/bootstrap 用语 · 锁定 rejected→10 · 合并冲突强制人工 |
 | v1.2 | 2026-06-15 | v1.2 评审：§0.3 贡献清单 · §0.4 ontology.yaml · track-schema · D6-a · 合并 base 澄清 · plan 预检 · 状态图细化 · depends_on 禁环 |
+| v1.3 | 2026-06-21 | **V2 帽链**：10-spec/10-task · 20-spec-audit/20-task-audit · 30→40 同 Agent · 50/CLOSE 打回 · [`SDD_HAT_FLOW_v2_zh.md`](./SDD_HAT_FLOW_v2_zh.md) |
 

package/docs/methodology/product/README.md

@@ -2,7 +2,8 @@
 
 | 文档 | 说明 |
 | --- | --- |
-| **[`DESIGN_ONTOLOGY_v1_zh.md`](./DESIGN_ONTOLOGY_v1_zh.md)** | **真值** v1.2 · Track / Hat / Sync / P·S·D 公理 / ICVO |
+| **[`DESIGN_ONTOLOGY_v1_zh.md`](./DESIGN_ONTOLOGY_v1_zh.md)** | **真值** v1.3 · Track / Hat / Sync / P·S·D 公理 / ICVO |
+| **[`SDD_HAT_FLOW_v2_zh.md`](./SDD_HAT_FLOW_v2_zh.md)** | **帽链流程** · 人读版 · 30→40 · 打回规则 |
 
 **分层**：回答「产品 **是什么** · 由哪些实体组成 · 允许哪些状态转移」。
 

package/docs/methodology/product/SDD_HAT_FLOW_v2_zh.md

@@ -0,0 +1,78 @@
+# SDD 帽链流程（V2 · 产品仓真值）
+
+| 项 | 内容 |
+|----|------|
+| **版本** | v2.0 |
+| **日期** | 2026-06-21 |
+| **关联** | [`DESIGN_ONTOLOGY_v1_zh.md`](./DESIGN_ONTOLOGY_v1_zh.md) §3.2 · §4.1 · §8 · [`../../../harness/prompts/README.md`](../../../harness/prompts/README.md) |
+
+---
+
+## 1. 标准流程（功能 / Epic）
+
+```text
+人 + 00 chat 生成大纲
+  → 10-spec R0–R9（回填 SPEC · 可多轮）
+  → 20-spec-audit（规格验收 · reviews/）
+       ↔ HG-SPEC-SIGNOFF（人签 · 未过则回到 10-spec 或 20 再审）
+  → 00 起草 P0 task（自 SPEC §13 投影）
+  → 10-task（回填 task §5）
+  → 20-task-audit R1（reviews/ · 可打回 10-task）
+       ↔ HG-AUDIT-R1（人签）
+  → 30 实现
+  → 40 自检（通常由 30 同一 Agent 连续执行 · 失败自修并重跑 40 直至通过 · 无需单独开 40 对话）
+  → 50 独立复检（可选 · 未过打回 30）
+  → CLOSE（关账 · KPI）
+```
+
+**10 / 20 配对**
+
+| 10 | 20 | 人闸 |
+|----|-----|------|
+| 10-spec | 20-spec-audit | HG-SPEC-SIGNOFF |
+| 10-task | 20-task-audit | HG-AUDIT-R1 |
+
+历史别名：`10-requirements`→10-task · `22-task-audit`→20-task-audit。
+
+---
+
+## 2. 打回与关账
+
+| 节点 | 常见打回 | 说明 |
+|------|----------|------|
+| 20-spec-audit | → **10-spec** | 规格缺口 · 人闸 pending / rejected |
+| 20-task-audit | → **10-task** | task 验收 / failure_paths 不可执行 |
+| 50 | → **30** | 独立视角发现实现问题 |
+| CLOSE | → **下一 task / SPEC 增量** | 小问题留后续迭代 |
+| CLOSE | → **10-spec 或 10-task** | 结果与预期相差太远 · 维护者决策重开 |
+
+**30→40**：不强制新对话；30 Agent 跑验证命令、回填 `### 自检结论（执行者）`，不通过则改码再跑，直到 task 所列命令绿。
+
+**00**：编排层 · 不写产品代码 · 起草 SPEC/task · 派下一棒 Prompt。
+
+---
+
+## 3. bugfix 捷径
+
+Issue ≈ mini-SPEC 且已签收时：**跳过 10-spec / 20-spec-audit** · 自 **00 草稿 task → 10-task → 20-task-audit → …**。
+
+---
+
+## 4. Starter 包与用户仓
+
+| 帽 | 产品仓 Starter | 完整 Prompt |
+|----|----------------|-------------|
+| 10-task | `harness/prompts/10-requirements.md` | 工作区 Extended |
+| 20-task-audit | `harness/prompts/22-task-audit.md` | 同上 |
+| 30 / 40 | ✅ Starter | 同上 |
+| 10-spec / 20-spec-audit / 00 / 50 | POINTER | 工作区 `docs/harness/prompts/` |
+
+工作区 Ink 全量库：[`docs/harness/guides/GUIDANCE_harness_hat_v2_chain_v1_zh.md`](../../../../docs/harness/guides/GUIDANCE_harness_hat_v2_chain_v1_zh.md)（POINTER · 私有 monorepo）。
+
+---
+
+## 修订记录
+
+| 版本 | 日期 | 说明 |
+|------|------|------|
+| v2.0 | 2026-06-21 | 与 Ink 工作区 V2 对齐 · 30→40 同 Agent · 50/CLOSE 打回规则 |

package/harness/prompts/10-requirements.md

@@ -1,6 +1,8 @@
 # 帽子：需求 / 任务分析（Harness · Starter 子集）
 
-> **完整版 POINTER**（Ink 工作区）：`docs/harness/prompts/10-requirements.md`  
+> **hat_id（V2）**：**10-task** · 对应 **20-task-audit** · 历史文件名 **10-requirements** 保留。  
+> **姊妹帽**：SPEC 思考 **10-spec**（Extended · 工作区 `docs/harness/prompts/10-spec-requirements.md`）。  
+> **完整版 POINTER**（Ink 工作区）：`docs/harness/prompts/10-task-requirements.md`  
 > **本文件**：嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**。
 
 ## 身份

package/harness/prompts/22-task-audit.md

@@ -1,6 +1,8 @@
 # 帽子：任务审核（Harness · Starter 子集）
 
-> **完整版 POINTER**（Ink 工作区）：`docs/harness/prompts/22-task-audit.md`  
+> **hat_id（V2）**：**20-task-audit** · 对应 **10-task** · 历史文件名 **22-task-audit** 保留。  
+> **姊妹帽**：SPEC 书面审 **20-spec-audit**（Extended · 工作区 `docs/harness/prompts/20-spec-audit.md`）。  
+> **完整版 POINTER**（Ink 工作区）：`docs/harness/prompts/20-task-audit.md`  
 > **本文件**：嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**。
 
 ## 身份

package/harness/prompts/30-execute-code.md

@@ -38,7 +38,8 @@
 ## 输出形状
 
 - （拒开工）仅闸扫描 STOP 模板
-- （通过）diff + PR 验证说明 + invoke + task 自检回填 + 下一棒 40 Prompt
+- （通过）diff + 验证说明 + invoke + **40 自检闭环**（同上下文跑命令 · 不通过则改码重跑 · 回填 `### 自检结论`）
+- **40 不强制新开对话**；须 task 验证命令全绿后再交 50 / CLOSE
 
 ## 交接物
 

package/harness/prompts/40-self-check.md

@@ -5,7 +5,9 @@
 
 ## 身份
 
-**执行者自检**：与 30 执行帽 **可同上下文连续**；把「声称完成」变成 **可核对证据**。
+**执行者自检**：默认由 **30 同一 Agent** 在本轮连续完成；把「声称完成」变成 **可核对证据**。
+
+> **纪律**：不通过则 30 改码并重跑本帽步骤，直至 task 验证命令绿；**无需**维护者单独开 40 对话澄清。
 
 ## 只做什么
 
@@ -36,8 +38,9 @@
 
 ## 交接物
 
-- 给 50 复检 / 00 统筹：**diff + 日志摘要 + 自检验收表**  
-- task 内 **`### 自检结论（执行者）`** 相对路径引用
+- 给 50 复检 / 00 统筹 / **CLOSE**：diff + 日志 + 自检验收表  
+- task 内 **`### 自检结论（执行者）`** 须已回填  
+- 50 未过 → 打回 **30**；CLOSE 偏差过大 → 维护者决策 ↺ **10-task** 或 **10-spec**
 
 ---
 
@@ -45,4 +48,4 @@
 
 | 日期 | 摘要 |
 |------|------|
-| 2026-06-15 | A2 Starter 初版 · 与 Ink 完整库 POINTER 对齐 |
+| 2026-06-21 | 30 同 Agent 闭环 · 50/CLOSE 打回规则 |

package/harness/prompts/README.md

@@ -1,31 +1,40 @@
 # harness/prompts
 
-从本目录向用户仓 **`docs/harness/prompts/`** 复制 **Starter 子集**（非 Ink 全量帽子库）。
-
-## v0.1 已交付（T3 · M2）
-
-| 文件 | 状态 | 说明 |
-|------|------|------|
-| [`10-requirements.md`](./10-requirements.md) | ✅ | 需求 / 任务分析 · 精简 + POINTER |
-| [`22-task-audit.md`](./22-task-audit.md) | ✅ | 任务审核 · 落盘 reviews · HG-AUDIT-R1 |
-| [`30-execute-code.md`](./30-execute-code.md) | ✅ v0.1.1 | 执行编码 · 强制闸扫描 · AUDIT approved |
-| [`40-self-check.md`](./40-self-check.md) | ✅ v0.3.2 | 自检 · 命令证据 · 回填 task |
-| [`TEMPLATE_30_gate_stop.md`](./TEMPLATE_30_gate_stop.md) | ✅ v0.1.1 | 30 拒开工输出模板 |
+从本目录向用户仓 **`docs/harness/prompts/`** 复制 **Starter 子集**。
+
+## 标准流程（V2）
+
+```text
+人 + 00 chat 大纲
+  → 10-spec R0–R9
+  → 20-spec-audit + HG-SPEC-SIGNOFF（人签 · 可多轮）
+  → 00 起草 P0 task
+  → 10-task → 20-task-audit R1（↺ 10-task）→ HG-AUDIT-R1
+  → 30 → 40（同 Agent · 自修重跑直至通过）
+  → 50（↺ 30 · 可选）→ CLOSE
+```
 
-**Starter 闭包**：10 / 22 / 30 / **40**（A2 · v0.3.x）
+详述：[`../docs/methodology/product/SDD_HAT_FLOW_v2_zh.md`](../docs/methodology/product/SDD_HAT_FLOW_v2_zh.md)
 
-## 完整库（POINTER · 不复制全文）
+| 10 | 20 | 人闸 |
+|----|-----|------|
+| 10-spec | 20-spec-audit | HG-SPEC-SIGNOFF |
+| 10-task | 20-task-audit | HG-AUDIT-R1 |
 
-Extended 帽（00/20/40/50、链式 PROMPT）由维护者在 **私有工作区或签约伙伴仓** 维护 · **不**默认复制进用户仓。
+## Starter（本目录）
 
-嵌入用户仓后可在 README 追加（示例）：
+| 文件 | hat_id | 说明 |
+|------|--------|------|
+| [`10-requirements.md`](./10-requirements.md) | 10-task | task §5 思考 |
+| [`22-task-audit.md`](./22-task-audit.md) | 20-task-audit | reviews/ · HG-AUDIT-R1 |
+| [`30-execute-code.md`](./30-execute-code.md) | 30 | 实现 · **含 40 自检闭环** |
+| [`40-self-check.md`](./40-self-check.md) | 40 | 与 30 同 Agent · 规则分文件 |
+| [`TEMPLATE_30_gate_stop.md`](./TEMPLATE_30_gate_stop.md) | — | 30 拒开工 |
 
-```markdown
-## 完整 Harness 库
-- 上游：你的组织/monorepo `docs/harness/prompts/`（只读对照 · 非 Starter 默认）
-```
+Extended（10-spec / 20-spec-audit / 00 / 50）：工作区 `docs/harness/prompts/` · 见 [`SDD_HAT_FLOW_v2_zh.md`](../docs/methodology/product/SDD_HAT_FLOW_v2_zh.md) §4。
 
-## 链式执行
+## 修订记录
 
-- 串行 Task 链：维护者工作区链式 PROMPT（M3 `harness ctx` 前手工 `@` 引用）
-- 每帽 invoke：[`../invokes/TEMPLATE_invoke.md`](../invokes/TEMPLATE_invoke.md)
+| 日期 | 摘要 |
+|------|------|
+| 2026-06-21 | V2 标准流程 · 30→40 同 Agent · 50/CLOSE 打回 |

package/ontology.yaml

@@ -2,8 +2,8 @@
 # 人类真值：docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md
 # 冲突时以 Markdown 为准 · 供未来 harness ontology-check 使用
 
-version: "1.2"
-product_semver: "2.0.0"
+version: "1.3"
+product_semver: "2.0.4"
 license: MIT
 
 classes:
@@ -64,24 +64,44 @@ axioms:
     text: "禁止 sync 覆盖 docs/tasks、reviews、invokes/by-task"
   - id: S5
     text: "harness-sync apply 前须 git-clean（可 --force 跳过）"
+  - id: D1
+    text: "每次 20-task-audit 必须产出 AuditReview（零阻塞须写明）"
   - id: D2
-    text: "HG-AUDIT-R1 pending 时 22 不得附 30 Prompt"
+    text: "HG-AUDIT-R1 pending 时 20-task-audit 不得附 30 Prompt（别名 22-task-audit）"
   - id: D7
     text: "public push 须 HG-RELEASE 人闸 checklist 全勾"
 
+# V2 hat_id · Starter 闭包 + Extended POINTER（见 DESIGN_ONTOLOGY §3.2）
 starter_hats:
-  - hat_id: "10-requirements"
-    role: RequirementsHat
-  - hat_id: "22-task-audit"
+  - 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: ["22-task-audit", "30-execute-code"]
+    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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyning/harness",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "cyning-harness discipline package · init / upgrade / check CLI",
   "license": "MIT",
   "type": "module",