spec-wave 2.1.1

package/assets/harness/discipline-coverage.yaml

@@ -0,0 +1,320 @@
+# Discipline coverage · Starter 子集机械化率资产（方向一）
+#
+# 运行时真值：本文件（随 npm 包分发）。
+# 历史叙事：私仓 rethink 文档 03_coverage_matrix.md（2026-07 mechanization-rate · 不随包分发）
+# 维护：新闸合入时更新 statements[].status / gaps[] / as_of_package_version
+# 禁止：把本文件当「每周全量重盘」流程；不做 audit --discipline UI（本波）
+# status 口径（DEF-005 重盘 · as_of = 本包实接线）：
+#   mechanical  = 机制在本包 src/ 已接线（mechanism 带锚点）
+#   partial     = 有机制但覆盖不全
+#   prompt-only = 无机制，仅条文约束
+#   not_wired   = 声称的机制在本包未接线（旧包机制名仅见于「旧包史实」notes · 接线计划见 PRD_DEF-003 阶段二）
+
+version: "1"
+as_of_package_version: "2.1.1"
+scope: "Starter · harness/prompts （10/22/30/40 + FRAGMENT）+ TEMPLATE_invoke"
+source_audit: "私仓 rethink 2026-07 mechanization-rate 转录聚合 · 2026-08-24 按 dsh-coding-kit 1.2.3 src/ 逐条重盘（DEF-005 机制台账）"
+
+gaps:
+  - id: WIKI-DELTA
+    title: wiki_delta close 闸 + 晋升指针 + wiki export
+    status: closed
+    closed_in: "unreleased"
+    note: "task lint-wiki-delta（src/cli-task-extra.ts）与 wiki export（src/cli.ts）本包已接线；close_wiki_delta close 闸已接线（PRD_DEF-003 阶段二 T6 · src/cli-checks.ts evalCloseWikiDelta）；close_wiki_promotion 晋升指针闸已接线（PRD_DEF-003 后续棒 · src/cli-checks.ts evalCloseWikiPromotion 对照旧包 @cyning/harness@2.24.0 evaluateWikiPromotionPointer · 豁免与 wiki_delta 共用 --allow-wiki-gap · test/cli-task-close-guards.test.ts 钉死）· 旧包史实（@cyning/harness 2.18.0 closed · SPEC-experience-wiki-feedback_loop）"
+  - id: G1
+    title: task md 结构 lint
+    status: closed
+    closed_in: "1.1.0"
+    note: "task lint E1–E7 本包已接线（src/cli.ts#430-511）· 旧包史实（@cyning/harness 2.3.0）"
+  - id: G2
+    title: reviews 留档闸
+    status: not_wired
+    closed_in: null
+    note: "findReview 仅 status 使用（src/cli-status.ts#70）；verify/close 无 reviews 闸 · 旧包史实（@cyning/harness 2.5.0 · N4 全量 2.9.0）· 接线计划见 PRD_DEF-003 阶段二"
+  - id: G3
+    title: 文本纪律（绝对路径）
+    status: closed
+    closed_in: "1.1.0"
+    note: "task lint E6 本包已接线（src/cli.ts#481-485）· 旧包史实（@cyning/harness 2.3.0）；invoke 预写 approved grep 仍缓做"
+  - id: G4
+    title: 思考轮结构
+    status: not_wired
+    closed_in: null
+    note: "本包仅 W4 warn-only（src/cli.ts#498-503）；旧包 E8–E10 / W5 未随包 · 旧包史实（@cyning/harness 2.6.0）· 接线计划见 PRD_DEF-003 阶段二"
+  - id: G6
+    title: git 行为层
+    status: deferred
+    closed_in: null
+    note: "方向三"
+  - id: G7
+    title: 执行证据（真跑过）
+    status: deferred
+    closed_in: null
+    note: "方向二 runner；跟 lifecycle dry-run 之后"
+  - id: N2-C
+    title: verify --task lint → block
+    status: deferred
+    closed_in: null
+    note: "本包 verify 不含 lint 步（src/cli.ts#381-428）· 旧包史实（@cyning/harness warn-only 2.7.0）· 须 FAIL 率下降"
+  - id: SPEC-reviews
+    title: SPEC 审查文闸
+    status: closed
+    closed_in: "unreleased"
+    note: "verify --spec 本包已接线（src/cli.ts verifySpecMode · findSpecReview src/cli-checks.ts 单一实现源 · 缺失 exit 2 BLOCKED · --allow-no-spec-review 豁免留痕 · PRD_DEF-003 后续棒）· 旧包史实（@cyning/harness 2.8.0）"
+  - id: FULL-reviews
+    title: 裸 verify 全量 reviews + 双路径
+    status: not_wired
+    closed_in: null
+    note: "verify 须 --task 且不查 reviews（src/cli.ts#402）· 旧包史实（@cyning/harness N4 2.9.0）· 接线计划见 PRD_DEF-003 阶段二"
+  - id: LIFECYCLE-ENGINE
+    title: lifecycle dry-run 最小引擎
+    status: closed
+    closed_in: "1.1.0"
+    note: "lifecycle dry-run 本包已接线（src/cli-lifecycle.ts）· 旧包史实（@cyning/harness 2.10.0 · Epic T2 旁路报告）"
+  - id: INVOKE-HATS
+    title: 多帽 invoke 留档集合闸
+    status: not_wired
+    closed_in: null
+    note: "close 无 invoke 集合闸（src/cli.ts#535-607 仅 slug/自检/验收/状态四项）；task lint-done 仅 slug 级（src/cli-task-extra.ts#282）· 旧包史实（@cyning/harness 2.12.0 · default 10,30,40）· 接线计划见 PRD_DEF-003 阶段二"
+
+statements:
+  - id: A1
+    source: 30-execute-code.md
+    summary: HG pending → 拒开工、禁改码
+    status: mechanical
+    mechanism: "gate-check + verify（src/cli.ts#325,#381 · 1.1.0 P0 子集 · 须 --task）"
+    gap: null
+    notes: null
+    mechanism_quality: null
+  - id: A2
+    source: 30-execute-code.md
+    summary: 开工前首输出 GATE_VERIFY 闸扫描表
+    status: partial
+    mechanism: "verify 提供判定（src/cli.ts#381-428）；Agent 是否先输出表无检查"
+    gap: null
+    notes: null
+    mechanism_quality: null
+  - id: A3
+    source: 30-execute-code.md
+    summary: 真值在 task 表；声称 vs 表 pending → STOP
+    status: partial
+    mechanism: "gate-check/verify 读 task 闸表（src/cli.ts#204-248）"
+    gap: null
+    notes: "用户声称侧不可机械"
+    mechanism_quality: null
+  - id: A4
+    source: 30-execute-code.md
+    summary: test_strategy required → 先可失败测试再改实现
+    status: partial
+    mechanism: "audit/verify D5 探测测试文件存在（src/cli.ts#270-322）"
+    gap: null
+    notes: "先红后绿顺序无机制 · mechanism_quality 预留"
+    mechanism_quality: null
+  - id: A5
+    source: 30-execute-code.md
+    summary: 运行验证命令 + 回填自检结论
+    status: mechanical
+    mechanism: "task close 自检结论非占位符检查（src/cli.ts#556-566）"
+    gap: G7
+    notes: "命令真跑过仍靠 40 诚实"
+    mechanism_quality: null
+  - id: A6
+    source: 30-execute-code.md
+    summary: invoke 快照落盘 by-task/<slug>/（按 required_invoke_hats 集合）
+    status: partial
+    mechanism: "task lint-done（src/cli-task-extra.ts#282 · slug 级存在性）；帽集合覆盖闸未接线"
+    gap: null
+    notes: "旧包史实（@cyning/harness · close 集合闸 evaluateInvokeHatsRetention · v2.12.0 默认 10,30,40 · profile minimal/full · v2.12.1 前缀 hat run）· 本包未接线 · 接线计划见 PRD_DEF-003 阶段二"
+    mechanism_quality: null
+  - id: A7
+    source: 30-execute-code.md
+    summary: 归档只能 task close PASS 后进行
+    status: mechanical
+    mechanism: "task close（src/cli.ts#535-607）"
+    gap: null
+    notes: "手动 mv 旁路由 task lint-done 兜底（src/cli-task-extra.ts#282）"
+    mechanism_quality: null
+  - id: A8
+    source: 30-execute-code.md
+    summary: HG-GRAPH-MODULES pending → 禁改码
+    status: mechanical
+    mechanism: "gate-check 默认检查 HG-GRAPH-MODULES pending → blocked（src/cli.ts#238-241）"
+    gap: null
+    notes: "--graph 旗标被吞无语义（src/cli.ts#326 · DEF-011）；该检查为默认行为非旗标触发"
+    mechanism_quality: null
+  - id: A9
+    source: 30-execute-code.md
+    summary: 缺验收/failure_paths/必读 → 仅输出阻塞清单
+    status: mechanical
+    mechanism: "task lint E1–E7（src/cli.ts#430-511）"
+    gap: G1
+    notes: "02 原 ❌ · 已刷新（G1 本包已接线）"
+    mechanism_quality: null
+  - id: A10
+    source: 30-execute-code.md
+    summary: 交接物 commit 仅本轮路径、禁 git add -A
+    status: prompt-only
+    mechanism: null
+    gap: G6
+    notes: null
+    mechanism_quality: null
+  - id: B1
+    source: 40-self-check.md
+    summary: 逐条对照验收标准标记 pass/fail
+    status: partial
+    mechanism: "task close 查无未勾选（src/cli.ts#567-574）"
+    gap: null
+    notes: null
+    mechanism_quality: null
+  - id: B2
+    source: 40-self-check.md
+    summary: 必须运行验证命令并摘要退出码
+    status: prompt-only
+    mechanism: null
+    gap: G7
+    notes: "真跑过无证据"
+    mechanism_quality: null
+  - id: B3
+    source: 40-self-check.md
+    summary: 必须回填自检结论（执行者）
+    status: mechanical
+    mechanism: "task close 自检结论回填闸（src/cli.ts#556-566）"
+    gap: null
+    notes: null
+    mechanism_quality: null
+  - id: B4
+    source: 40-self-check.md
+    summary: 禁止改 tasks/reviews/invokes（S2）
+    status: prompt-only
+    mechanism: null
+    gap: G6
+    notes: null
+    mechanism_quality: null
+  - id: B5
+    source: 40-self-check.md
+    summary: 不凭记忆声称测过
+    status: prompt-only
+    mechanism: null
+    gap: null
+    notes: "诚实纪律 · 设计上留 Prompt"
+    mechanism_quality: null
+  - id: C1
+    source: 22-task-audit.md
+    summary: 必须落盘 reviews task_*_audit_R*
+    status: not_wired
+    mechanism: "本包未接线（findReview 仅 status 使用 · src/cli-status.ts#70）"
+    gap: G2
+    notes: "旧包史实（@cyning/harness · verify/close reviews 闸 G2 v2.5+ · 全量 N4 v2.9）· 接线计划见 PRD_DEF-003 阶段二；内容质量仍 prompt-only"
+    mechanism_quality: null
+  - id: C2
+    source: 22-task-audit.md
+    summary: HG-AUDIT-R1 pending 时禁止附 30 Prompt
+    status: not_wired
+    mechanism: "本包未接线（无 reviews 存在性闸）"
+    gap: G2
+    notes: "旧包史实（@cyning/harness · 存在性闸随 G2）· 接线计划见 PRD_DEF-003 阶段二；审查文内容无检查"
+    mechanism_quality: null
+  - id: C3
+    source: 22-task-audit.md
+    summary: 思考轮审查不通过 → 退回 10
+    status: prompt-only
+    mechanism: null
+    gap: null
+    notes: "流程纪律"
+    mechanism_quality: null
+  - id: C4
+    source: 22-task-audit.md
+    summary: 零阻塞写已核对项；终轮写签收
+    status: prompt-only
+    mechanism: null
+    gap: null
+    notes: "审查文结构无 lint"
+    mechanism_quality: null
+  - id: D1
+    source: 10-requirements.md
+    summary: task 必含验收/failure_paths/非范围/依赖
+    status: mechanical
+    mechanism: "task lint E3/E4（src/cli.ts#458-466）"
+    gap: G1
+    notes: "02 原 ❌ · 已刷新（G1 本包已接线）"
+    mechanism_quality: null
+  - id: D2
+    source: 10-requirements.md
+    summary: 不写绝对本机路径
+    status: mechanical
+    mechanism: "task lint E6（src/cli.ts#481-485）"
+    gap: G3
+    notes: "02 原 ❌ · 已刷新（G3 本包已接线）"
+    mechanism_quality: null
+  - id: D3
+    source: 10-requirements.md
+    summary: 预置 R0–R5 + 思考轮控制表
+    status: not_wired
+    mechanism: "本包未接线（仅 W4 warn-only · src/cli.ts#498-503）"
+    gap: G4
+    notes: "旧包史实（@cyning/harness · task lint E8–E10 条件触发）· 接线计划见 PRD_DEF-003 阶段二；内容质量仍 20 帽"
+    mechanism_quality: null
+  - id: D4
+    source: 10-requirements.md
+    summary: 缺验收/failure_paths → 仅输出阻塞清单
+    status: mechanical
+    mechanism: "task lint E3/E4（src/cli.ts#458-466）"
+    gap: G1
+    notes: null
+    mechanism_quality: null
+  - id: E1
+    source: FRAGMENT_30
+    summary: invoke 中禁止预写 HG-AUDIT-R1 approved
+    status: prompt-only
+    mechanism: null
+    gap: G3
+    notes: "SPEC R2 缓做 · 误报风险"
+    mechanism_quality: null
+  - id: E2
+    source: FRAGMENT_30
+    summary: 用户确认 approved = 须核验非事实
+    status: partial
+    mechanism: "verify 读 task 闸表（src/cli.ts#204-248）"
+    gap: null
+    notes: null
+    mechanism_quality: null
+  - id: F1
+    source: TEMPLATE_invoke.md
+    summary: 落盘路径 by-task/<task_slug>/ 且帽子集合覆盖
+    status: partial
+    mechanism: "task lint-done（src/cli-task-extra.ts#282 · slug 级）；帽集合覆盖闸未接线"
+    gap: null
+    notes: "旧包史实（@cyning/harness · evaluateInvokeHatsRetention · v2.12.0 文件名 hat token · 合并 30_40 可双计 · v2.12.1 前缀 run 防 slug 误计）· 本包未接线 · 接线计划见 PRD_DEF-003 阶段二"
+    mechanism_quality: null
+  - id: F2
+    source: TEMPLATE_invoke.md
+    summary: 同帽追问不新增 invoke；打回用 _r2
+    status: prompt-only
+    mechanism: null
+    gap: null
+    notes: "命名纪律 · 可留 prompt"
+    mechanism_quality: null
+  - id: F3
+    source: TEMPLATE_invoke.md
+    summary: 落盘 + task 回填后再 commit
+    status: prompt-only
+    mechanism: null
+    gap: G6
+    notes: null
+    mechanism_quality: null
+  - id: SK1
+    source: SPEC-agent-skills-packaging_v1（旧包史实 @cyning/harness v2.23.0 · Agent Skills 封装）
+    summary: skills/ 为纯生成物 · 条文改正文未重跑 build → skills check 挡
+    status: mechanical
+    mechanism: "skills check drift 闸（src/cli-skills.ts#227-235,#416-423）+ test/cli-docs-121.test.ts（生成物==落盘断言）+ test/cli-skills-install.test.ts"
+    gap: null
+    notes: "非条文纪律 · 新机制登记（格式纪律机械闸）"
+    mechanism_quality: null
+  - id: SK2
+    source: SPEC-agent-skills-packaging_v1（旧包史实 @cyning/harness v2.23.0）
+    summary: 30/40 执行帽不进 skills 默认分发（T1 评测判死 · eval_t1_gate_bypass 20260806）
+    status: mechanical
+    mechanism: "generateSkills track=starter-experimental 过滤（src/cli-skills.ts#16,#159,#283）+ 默认集断言（skills build --with-execute-hats 仅评测通道）"
+    gap: null
+    notes: "隔离编码进构建默认值 · 非文档呼吁"
+    mechanism_quality: null

package/assets/harness/invokes/README.md

@@ -0,0 +1,22 @@
+# harness/invokes
+
+## 约定
+
+- 路径：`docs/harness/invokes/by-task/<task_slug>/invoke_YYYYMMDD_<hat>_<slug>.md`
+- 每 **新帽** 开局落盘 §3 调用体（同帽追问不新增）
+- 与 task `### 自检结论`、`docs/harness/reviews/` 并列可追溯
+
+## v0.1 已交付（T3 · M2）
+
+| 文件 | 状态 | 说明 |
+|------|------|------|
+| [`TEMPLATE_invoke.md`](./TEMPLATE_invoke.md) | ✅ | 元信息表 + Prompt 快照 + 交付摘要骨架 |
+
+## 完整规范 POINTER
+
+Ink 工作区：`docs/harness/invokes/README.md`（命名、by-task 布局、pointer 策略）
+
+## 纪律
+
+- **M2 产品仓执行过程** invoke 可留工作区 `by-task/`（见 cyning-harness ONBOARDING）
+- 用户仓 Epic / task 执行 invoke **落本仓** `docs/harness/invokes/`

package/assets/harness/invokes/TEMPLATE_invoke.md

@@ -0,0 +1,61 @@
+# Harness invoke 快照模板
+
+> **用途**：每 **新帽** 开局时，将 **占位符已全部替换** 的 §3 Prompt 落盘。  
+> **路径**：`docs/harness/invokes/by-task/<task_slug>/invoke_YYYYMMDD_<hat>_<slug>.md`
+
+---
+
+## 元信息表（必填）
+
+| 字段 | 值 |
+|------|-----|
+| hat_id | 10 / 22 / 30 / 40 / 50 / 00 / CLOSE（合并可写 `30（含 40）`） |
+| task_slug | `<slug>` |
+| freeze_id | （可选） |
+| task_paths | `docs/tasks/active/task_….md` |
+| related_review_or_none | `docs/harness/reviews/…` 或 `无` |
+| git_branch | `task/<slug>` |
+| worktree_root | （并行时必填 · 相对仓根） |
+| created_utc_or_local | YYYY-MM-DD |
+| notes | （可选） |
+
+---
+
+## 可复制 Prompt 快照
+
+```text
+（粘贴本帽 TEMPLATE-*-invoke §3 全文 · 占位符须全部替换）
+```
+
+---
+
+## 交付摘要（本帽结束时填）
+
+- **验证命令** + 退出码
+- **变更路径** 列表
+- **下一棒** slug 或「交还 00」
+
+---
+
+## 纪律
+
+| 规则 | 说明 |
+|------|------|
+| 同帽追问 | **不** 新增 invoke；沿用本节路径 |
+| 打回重开 | 新文件或 `_r2` 后缀 |
+| 与 reviews 分工 | reviews = 结论；invoke = **当时指令** |
+| close 机械闸 | `task close` 按 task 元信息 `required_invoke_hats` / `invoke_retention_profile` 校验帽集合覆盖（v2.12+；缺省 `10,30,40`；文件名含 `30_40` 可双计；`--allow-invoke-gap` 豁免）——**本包已接线**（src/cli-checks.ts evalCloseGuard close_invoke · PRD_DEF-003 阶段二 T6 · test/cli-task-close-guards.test.ts 钉死）；另含 **close_pr_merged** / **close_hub_index**（doc-health · v1.7.0+）；dry-run=`CLOSE: READY`；`--yes` 成功=`CLOSE: PASS` |
+| 命名 | `invoke_YYYYMMDD_<hat>[_<hat>...]_<slug>.md`（hat token **仅**在日期后、slug 前连续段；slug 勿夹 `10`/`40` 等白名单段 · v2.12.1） |
+| commit | 落盘 + task 回填后再 commit（见 HANDOFF） |
+
+---
+
+## 完整库 POINTER
+
+Ink 工作区：`docs/harness/invokes/README.md` · 各 `TEMPLATE-*-invoke.md` §3
+
+## 修订记录
+
+| 日期 | 说明 |
+|------|------|
+| YYYY-MM-DD | 从 cyning-harness 嵌入 |

package/assets/harness/lifecycle.yaml

@@ -0,0 +1,127 @@
+# Task lifecycle · 最小真值（方向二 · v1）
+#
+# 登记真值：状态 / 转移 / 守卫。yaml 本身不是引擎。
+# 由 `lifecycle dry-run` 引擎消费（v2.10+ · 资格判定旁路报告 · 不写盘）。
+# v2.11+ to_30：HG-AUDIT-R1 · HG-TASK-DRAFT 已接线（本包真接线）；reviews_retention · audit_D5 · task_lint 已接线（PRD_DEF-003 阶段二 T3 · src/cli-lifecycle.ts evalGuard · test/cli-lifecycle-guards.test.ts 钉死）
+# v2.13+ close：close_self_check · close_acceptance · close_slug · close_status 已接线；close_invoke · close_review 已接线（PRD_DEF-003 阶段二 T6 · src/cli-checks.ts evalCloseGuard · test/cli-task-close-guards.test.ts 钉死）；close_wiki_promotion 已接线（见 v2.18 行）
+# v2.17+ close 增补：close_graph_delta · close_kpi · close_experience —— 已接线（PRD_DEF-003 阶段二 T6 · 同 T6 锚点）；close_wiki_promotion 已接线（PRD_DEF-003 后续棒 · 见 v2.18 行）
+# v2.18+ close 增补：close_wiki_delta 已接线（PRD_DEF-003 阶段二 T6）；close_wiki_promotion —— 已接线（PRD_DEF-003 后续棒 · src/cli-checks.ts evalCloseWikiPromotion 对照旧包 2.24.0 evaluateWikiPromotionPointer · test/cli-task-close-guards.test.ts 钉死）
+# v2.19+ to_00：spec_reviews_retention 已接线（verify --spec 真闸交付 · src/cli-checks.ts findSpecReview/evalSpecReviewsRetention 单一实现源 · PRD_DEF-003 后续棒 · test/cli-verify-spec.test.ts 钉死）；to_00/to_30/close 登记守卫全部已接线（dry-run 恒真求值 · 无 unevaluated 残留）
+# v1.7.0+ close：close_pr_merged · close_hub_index 已接线（doc-health SPEC · src/cli-checks.ts · test/cli-task-close-guards.test.ts）
+# 只读展示：npx spec-wave lifecycle show [--json]
+# 本包未附带 JSON Schema（旧 schema 指针已移除 · DEF-009）
+
+version: "1"
+
+states:
+  - id: draft
+    note: "含 pending / active 等词表别名 · 见 KNOWN_STATUS_TOKENS；SPEC 侧亦用 draft"
+  - id: signed
+    note: "SPEC 人签 HG-SPEC-SIGNOFF 后 · 可起草 task"
+  - id: in_progress
+  - id: done
+    note: "close 可接受 completed 别名"
+  - id: archived
+    note: "task close 归档后 · 物理上在 done/ 目录"
+
+transitions:
+  - id: to_00
+    from: ["draft", "signed"]
+    to: signed
+    hat: "00"
+    description: "SPEC 签收后起草 task（verify --spec 聚合 · v2.8+）"
+    # 守卫接线真值（本包）：spec_reviews_retention 已接线（dry-run 真求值 · --task 携带待签收 SPEC 路径 · 与 verify --spec 同一实现源）
+    guards:
+      - id: spec_reviews_retention
+        command_or_check: "verify --spec · findSpecReview（v2.8+）"
+        severity: block
+        allow_flag: "--allow-no-spec-review"
+        note: "bugfix / skip_spec_audit 元信息豁免 · 不挂 verify --task"
+
+  - id: to_30
+    from: ["draft", "in_progress"]
+    to: in_progress
+    hat: "30"
+    description: "执行帽开工（verify --task 与全量模式聚合 · v2.9+）"
+    # 守卫接线真值（本包）：to_30 五守卫全部已接线（HG-AUDIT-R1 / HG-TASK-DRAFT / reviews_retention / audit_D5 / task_lint · PRD_DEF-003 阶段二 T3 dry-run adapter 真求值）
+    guards:
+      - id: HG-AUDIT-R1
+        command_or_check: "gate-check · human_gate HG-AUDIT-R1=approved"
+        severity: block
+      - id: HG-TASK-DRAFT
+        command_or_check: "gate-check · HG-TASK-DRAFT=approved（blocks 22,30）"
+        severity: block
+      - id: audit_D5
+        command_or_check: "verify/audit · test_strategy vs 测试文件存在"
+        severity: block
+      - id: reviews_retention
+        command_or_check: "verify --task 与全量 · findReview R<n> 存在性（v2.5+ · 全量 v2.9+）"
+        severity: block
+        allow_flag: "--allow-no-review"
+        note: "全量模式扫描双路径 active；不跑 lint / D5"
+      - id: task_lint
+        command_or_check: "verify --task · lintTaskFile（v2.7+）"
+        severity: warn
+        allow_flag: "--allow-lint-fail"
+        note: "升 block 前置：active lint FAIL 率下降或另立「仅新流转」SPEC（N2-C）"
+
+  - id: close
+    from: ["done"]
+    to: archived
+    hat: "close"
+    description: "task close · active→done 归档（逻辑态 done→archived）"
+    # 守卫接线真值：既有 close_* + doc-health close_pr_merged / close_hub_index（src/cli-checks.ts evalCloseGuard · task close 与 lifecycle dry-run 同一实现源）
+    guards:
+      - id: close_invoke
+        command_or_check: "task close 检查1 · invoke hats 集合覆盖（required_invoke_hats / profile · v2.12+）"
+        severity: block
+        allow_flag: "--allow-invoke-gap"
+        note: "缺省 default=10,30,40；minimal=30；full=10,20,30,40,00,CLOSE（与旧包 2.24.0 口径已核对一致 · 不含 22/50）；40 可与 30 合并文件名；v2.12.1 去掉 invoke_hats_retention 别名"
+      - id: close_self_check
+        command_or_check: "task close 检查2 · 自检结论已回填"
+        severity: block
+      - id: close_acceptance
+        command_or_check: "task close 检查3 · 验收勾选"
+        severity: block
+        allow_flag: "--allow-unchecked"
+      - id: close_slug
+        command_or_check: "task close 检查4 · slug 一致"
+        severity: block
+      - id: close_status
+        command_or_check: "task close 检查5 · 状态 done/completed"
+        severity: block
+      - id: close_review
+        command_or_check: "task close 检查6 · R<n> 审查文（v2.5+）"
+        severity: block
+        allow_flag: "--allow-no-review"
+      - id: close_graph_delta
+        command_or_check: "task close · graph_delta（缺字段 WARN；none 无 note / 路径不存在 BLOCK · v2.17+）"
+        severity: block
+        note: "缺字段由 adapter 返回 warn · 不挡 dry-run；fail 级与 close 同语义"
+      - id: close_kpi
+        command_or_check: "task close · KPI 可解析分数（kpi_aggregator=CLOSE · v2.17+）"
+        severity: block
+        allow_flag: "--allow-kpi-gap"
+      - id: close_experience
+        command_or_check: "task close · experience_capture（required 硬闸 · v2.17+ · 本包已接线 PRD_DEF-003 阶段二 T6）"
+        severity: block
+        allow_flag: "--allow-experience-gap"
+      - id: close_wiki_delta
+        command_or_check: "task close · wiki_delta（缺字段 BLOCK；none|n/a 无 note / 路径不存在 BLOCK · v2.18+）"
+        severity: block
+        allow_flag: "--allow-wiki-gap"
+      - id: close_wiki_promotion
+        command_or_check: "task close · wiki 晋升指针（experience=required 且 wiki_delta=path · v2.18+）"
+        severity: block
+        allow_flag: "--allow-wiki-gap"
+        note: "本包已接线（PRD_DEF-003 后续棒 · src/cli-checks.ts evalCloseWikiPromotion · 与 task close / dry-run 同一实现源 · 豁免与 wiki_delta 共用 --allow-wiki-gap）"
+      - id: close_pr_merged
+        command_or_check: "task close · 关联 PR MERGED（related_pr / gh pr view 当前分支 · doc-health）"
+        severity: block
+        allow_flag: "--allow-no-pr-merge"
+        note: "close_pr_policy=exempt + close_pr_exempt_note 亦可；不自动 gh pr merge"
+      - id: close_hub_index
+        command_or_check: "task close · Hub 索引行（检测 Hub 文件则要求含 basename · A+manifest 可关）"
+        severity: block
+        allow_flag: "--allow-no-hub"
+        note: "仓级 close_hub_gate 缺省 true；false 则 skip；无 Hub 文件 skip"

package/assets/harness/prompts/00-orchestrator.md

@@ -0,0 +1,91 @@
+# 帽子：总调度（Harness · 00 · Starter 精简）
+
+> **编号 `00`**：**不插入** SDD 链 10→50 的法定顺序；由 **主 Chat Agent** 承担编排。  
+> **本文件**：随 `dsh-coding-kit` 发布的 **Starter 精简真值**（默认行为强制）。  
+> **完整 Extended**（KPI / Handoff 模板 / 链式 PROMPT）：工作区或私仓 Extended 集；薄指针见 `assets/docs/POINTER_SDD_HAT_FLOW.md`。
+
+---
+
+## 默认行为（强制）
+
+> **问题**：未特别说明时，自称 00 的会话常把 10/20/30/文档迁移等过程工作**自己做完**。  
+> **预期默认**：00 是 **编排与收口**，不是全栈代劳。
+
+| 阶段 | 00 默认做什么 | 00 默认不做什么 |
+|------|----------------|-----------------|
+| **开工前** | 读闸 / 大纲 / 定路径（A/B/C/D）；产出 **下一棒可复制 Prompt** 交给子 Agent | 不顺手把整链做完 |
+| **bulk-split 后 · 派 30 前** | bulk-split（一次拆 ≥2 个 active task）后、派第一棒 30 前**必跑** `npx --yes spec-wave task lint-wiki-delta --target .`（命令串与 lint-wiki-delta CI sample `run:` 行逐字一致），并确认每个新 task 文件已预填 `## Harness 元信息` + `wiki_delta` | 不跳过早检直接派第一棒 30 |
+| **最多参与的第一步** | 按复杂度：**无初稿**时起草 SPEC **或** task 初版（二选一或「极简壳 + 交 10」） | 不兼做 20 审、30 改码、大段文档迁移实现 |
+| **中间全链** | **全部交子 Agent**（`Task` / 新会话）：10 → 20 → 30/40 → …；00 只收 ≤10 行回报、更新阶段表、准备下一棒 Prompt | **不**自己实现内容（含「顺手改 kit / 迁文档 / 写单测」） |
+| **收口** | **50**（可自做 **或** 再开新 Agent）+ **CLOSE**（关账清单 / Hub / KPI / `task close`） | 50 未过时不擅自扩 scope 代 30 改 |
+
+### 已有初版 SPEC 或 task 时（硬规则）
+
+当用户明确 **「你是 00」**，且仓库里 **已存在** 可读的初版 SPEC 和/或 task（`docs/spec/**`、`docs/tasks/active/task_*.md` 等）：
+
+1. **禁止** 00 参与该题的 **实际内容实现**（改 `src/` / 业务文档正文落地 / 单测实现 / 大段迁移执行等）。  
+2. 00 **只**：闸扫描 → 产出/刷新 **下一棒 Prompt** → `Task` 派发 → 收短报 → 阶段表 → 最终 **50 + CLOSE**。  
+3. 若缺审核文 / 缺 invoke：00 **派 20 / 提醒落盘**，不自己扮 20/30 写完。
+
+### 例外（须用户明示，写入 invoke notes）
+
+仅当用户 **显式**写明下列之一，00 才可越权亲自做中间步：
+
+- 「00 本窗亲自 30 / 亲自落地」  
+- 「同会话做完、不派子 Agent」  
+- 「授权 00 代签过程文档 **且** 亲自改码」（代签 ≠ 亲自实现；二者分开授权）
+
+无例外句 → **按上表默认**。
+
+### 长对话须 re-anchor
+
+多轮读码 / 大 diff / 口头换帽后若上下文脏：**先读** [`FRAGMENT_hat_reanchor_v1_zh.md`](./FRAGMENT_hat_reanchor_v1_zh.md)，再继续本帽。已有初稿时的只委派硬规则（**不改上表语义**）见 [`FRAGMENT_00_delegate_only_v1_zh.md`](./FRAGMENT_00_delegate_only_v1_zh.md)。
+
+---
+
+## 身份
+
+你是 **总调度** Agent：读 task 元信息与 `human_gate`；决定派哪顶帽、是否 `Task` 子代理；组 **Handoff**；收各帽短报告；汇总 **KPI**（若 `kpi_aggregator: 00`）；对人类只报阶段结论 / 阻塞 / 待签字。
+
+## 只做什么
+
+- 扫描 task：`orchestration`、`audit_profile`、`human_gate`、`experience_capture`、`test_strategy`、`freeze_id`。  
+- 为每顶帽准备 **Handoff**（路径表 + ≤15 行结论；**禁止**贴 30/总 Chat 长文）。  
+- 用 **`Task` 工具** 派发子代理；默认中间帽全部派发；收口 50+CLOSE。  
+- 触发 **CLOSE** 时核对关账清单（含 dry-run=`CLOSE: READY` ≠ `PASS`；Hub / PR 闸若启用）。
+
+## 禁止什么
+
+- 不替人改 `human_gate` 为 `approved`；不代签审查（除非用户 **明示**授权代签过程文档）。  
+- 不把子代理工具日志贴回主会话（只收结构化短报告）。  
+- 不静默扩 task scope。  
+- **默认禁止**：在已有 SPEC/task 初版后，00 亲自做内容实现；禁止把「统筹落地」自行解释成「我把 30 做完」。
+
+## 输出形状（对人类）
+
+```text
+阶段：{帽} · {pass|blocked|待 HG-xxx}
+交付：{Deliverable 路径列表}
+下一棒：{帽 | CLOSE | 停—原因}
+下一棒 Prompt：{已落盘路径或「见下复制区」}
+```
+
+有初版 SPEC/task 且无「亲自实现」授权时，汇报须含一句：**本窗未改实现码 · 已派 / 待派子 Agent：{帽}**。
+
+## 停止条件
+
+- 关账完成（task → `done/` + 关闭回溯）。  
+- 或输出 **阻塞清单**（缺 gate、缺自检、KPI blocked、CI 红）。
+
+## Judgment（00 自评 · 关账轮）
+
+- **gate/risk**：是否仍有 pending 闸。  
+- **hat_self**：编排是否漏帽；**是否违反「默认不亲自实现」**（违规则记 fail 并说明例外授权句）。
+
+## 修订记录
+
+| 日期 | 摘要 |
+|------|------|
+| 2026-08-26 | v1.7.1：Starter 入包 · 默认行为表（自工作区 Extended 收敛） |
+| 2026-08-27 | K4：默认行为表增 bulk-split 后 lint-wiki-delta 早检行（命令串与 CI sample 逐字一致） |
+| 2026-08-31 | 长对话须 re-anchor：链到 FRAGMENT_hat_reanchor / FRAGMENT_00_delegate_only（不改默认表语义） |