spec-wave 2.1.1

package/assets/ide/adapters/CLAUDE.md.fragment.example

@@ -0,0 +1,32 @@
+# Harness Starter（业务仓 · Claude Code）
+
+> **单源真值**：`docs/coding_wiki/` 读序 + `docs/standards/` + `AGENTS.md`。  
+> **本片段**：摘要 + **POINTER**；条文真值在 `docs/harness/prompts/`。  
+> **仓内定制（v2.22+）**：写在本产品块 **外** 的 `<!-- cyning-harness-local:begin/end -->`；勿改本 begin/end 内文。
+
+## 执行 task 前
+
+1. Open Folder = **本仓根**
+2. 读 `docs/tasks/active/task_*.md`：`test_strategy` · `failure_paths` · **人工闸**表
+3. **30 改码前** GATE_VERIFY（真值在 task **人工闸表**，**非** invoke 字面 `approved`）：
+   - 运行 `npx spec-wave verify --target . --task docs/tasks/active/task_*.md`
+   - 首输出闸扫描 · `FRAGMENT_30_gate_verify_v1_zh.md`
+   - **`HG-AUDIT-R1` pending** → **30 拒改码**
+   - 声称与 task 表冲突 → **STOP**
+4. 过程 invoke：`docs/harness/invokes/by-task/<task_slug>/`
+
+## Verify（合并前）
+
+| 栈 | 命令（与 `.github/workflows/` 一致） |
+|----|--------------------------------------|
+| 前端 | `pnpm lint` → `pnpm test` → `pnpm build` |
+| 后端 | `pytest tests`（按仓 marker 裁剪） |
+| iOS | `xcodebuild`（见 task `test_strategy_note`） |
+
+## 关键词
+
+`Harness`、`task`、`invoke`、`HG-AUDIT-R1`、`HG-GRAPH-MODULES`、`human_gate`、`拒开工`
+
+## 完整库 POINTER
+
+工作区：`docs/harness/prompts/`（22/30/TEMPLATE_30_gate_stop 等）

package/assets/ide/adapters/README.md

@@ -0,0 +1,57 @@
+# ide/adapters
+
+**单源 POINTER**：真值在 `docs/coding_wiki/` + `docs/standards/` + `AGENTS.md`；本目录仅 **IDE 入口片段**。
+
+## v0.2 已交付（D3 · M2 补完）
+
+| 文件 | 状态 | 勾选 IDE | 嵌入路径 |
+|------|------|----------|----------|
+| [`cursor-harness-starter.mdc.example`](./cursor-harness-starter.mdc.example) | ✅ | **Cursor**（默认推荐） | `.cursor/rules/05-harness-starter.mdc` |
+| [`CLAUDE.md.fragment.example`](./CLAUDE.md.fragment.example) | ✅ | **Claude Code** | 仓根 `CLAUDE.md`（marker merge） |
+| [`AGENTS.md.fragment.example`](./AGENTS.md.fragment.example) | ✅ | **通用 Agent** | 仓根 `AGENTS.md`（marker merge） |
+
+## 现行安装入口
+
+CLI 闸与模板以 **`npx spec-wave`** 为准（包内本目录 = npm `assets/ide/adapters/`）：
+
+```bash
+# 仓根：初始化 Harness 闸（不覆盖 S2 过程域）
+npx spec-wave init --preset harness-only --yes
+
+# 嵌入前建议先 verify（task 路径按仓调整）
+npx spec-wave verify --target . --task docs/tasks/active/task_*.md
+```
+
+IDE 片段默认需手工嵌入（见下）；`init` / `upgrade` 不写消费者仓 IDE 文件（`upgrade` 仅改写 `.cyning-harness/manifest.json`）。存量仓已嵌入 begin/end 块内的旧 `npx @cyning/harness` 命令字面，用 **`npx spec-wave refresh-ide-blocks`** 刷写（默认 dry-run 只读，`--yes` 才写盘；local 块、块外内容与 S2 路径永不动——映射表与纪律见仓根 README「refresh-ide-blocks」节）。
+
+profile 字段（历史）：`tracks.ide_cursor` · `tracks.ide_claude` · `tracks.ide_agents`（缺省：cursor=true，其余 false）。旧包 `cyning-harness` 的 `wizard/install.sh` 勾选路径已废弃，勿再当作现行入口。
+
+## marker merge 纪律（D3）
+
+- 块标记：`<!-- cyning-harness:begin -->` … `<!-- cyning-harness:end -->`（**marker 字符串**，不是 npx 包名；可保留）
+- **不覆盖**用户仓已有 `CLAUDE.md` / `AGENTS.md` 全文；**产品块外**手写保持不变
+- **仓内定制（v2.22+）**：使用 `<!-- cyning-harness-local:begin -->` … `<!-- cyning-harness-local:end -->`，且须在产品 begin/end **之外**。sync **永不**改写 local 块；若误写在产品块内，apply 会尝试 **salvage** 到产品块外。
+- G-L / 图谱模块页路径：`.cyning-harness/profile.json` 的可选 `"graph_modules_path"` 字段（旧包默认 `01_struct`）与 FRAGMENT 占位替换链 **当前不支持**（旧包 cyning-harness 史实机制，本包未接线；sync 仅生成 `invoke_index.json`，不读 profile.json、不写任何 FRAGMENT）。
+- **首次迁入操作序（推荐）**：先迁 profile/local 并 **git commit**，再 `npx spec-wave upgrade --yes`。`upgrade` 当前仅改写 `.cyning-harness/manifest.json`（src/cli.ts#155-178），**无 git-clean 前置检查**（脏树拦截本包未接线）；git commit 为推荐操作纪律，非本包强制。
+
+## 手工嵌入（备查）
+
+从已安装的 npm 包复制（路径相对消费者仓根）：
+
+```bash
+mkdir -p .cursor/rules
+cp node_modules/spec-wave/assets/ide/adapters/cursor-harness-starter.mdc.example \
+  .cursor/rules/05-harness-starter.mdc
+```
+
+或从本仓库源树：
+
+```bash
+cp assets/ide/adapters/cursor-harness-starter.mdc.example .cursor/rules/05-harness-starter.mdc
+```
+
+## 纪律（D3）
+
+- **多入口仅 POINTER** — 不在各 IDE 文件重复 L1/L2 全文
+- 过程轨（task、invoke、CI）**与 IDE 无关**
+- 向导 **默认不全选** IDE；按实际编辑器勾选

package/assets/ide/adapters/cursor-harness-starter.mdc.example

@@ -0,0 +1,39 @@
+---
+description: Harness Starter — 读序、task、人工闸与 Verify 纪律（嵌入业务仓 · Cursor）
+alwaysApply: true
+globs:
+  - "**/*"
+---
+
+# Harness Starter（业务仓 · Cursor）
+
+> **单源真值**：`docs/coding_wiki/` 读序 + `docs/standards/` + `AGENTS.md`。  
+> **本规则**：摘要 + **POINTER**；条文真值在 `docs/harness/prompts/`。  
+> **仓内定制（v2.22+）**：勿改本文件作仓特异词（upgrade 全量 `cp`）；关键词放 `AGENTS.md` 的 local 块或仓内非 sync 文档。
+
+## 执行 task 前
+
+1. Open Folder = **本仓根**
+2. 读 `docs/tasks/active/task_*.md`：`test_strategy` · `failure_paths` · **人工闸**表
+3. **30 改码前** GATE_VERIFY（真值在 task **人工闸表**，**非** invoke 字面 `approved`）：
+   - 运行 `npx spec-wave verify --target . --task docs/tasks/active/task_*.md`
+   - 首输出闸扫描 · `FRAGMENT_30_gate_verify_v1_zh.md`
+   - **`HG-AUDIT-R1` pending** → **30 拒改码**
+   - 声称与 task 表冲突 → **STOP**
+4. 过程 invoke：`docs/harness/invokes/by-task/<task_slug>/`
+
+## Verify（合并前）
+
+| 栈 | 命令（与 `.github/workflows/` 一致） |
+|----|--------------------------------------|
+| 前端 | `pnpm lint` → `pnpm test` → `pnpm build` |
+| 后端 | `pytest tests`（按仓 marker 裁剪） |
+| iOS | `xcodebuild`（见 task `test_strategy_note`） |
+
+## 关键词
+
+`Harness`、`task`、`invoke`、`HG-AUDIT-R1`、`HG-GRAPH-MODULES`、`human_gate`、`拒开工`
+
+## 完整库 POINTER
+
+工作区：`docs/harness/prompts/`（22/30/TEMPLATE_30_gate_stop 等）

package/assets/ide/commands/claude/kit/apply-standards.md

@@ -0,0 +1,10 @@
+---
+description: 指导应用 coding standards（POINTER；不静默改 S2）
+kit_command_id: 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，本命令只编排、不替代闸。

package/assets/ide/commands/claude/kit/gate-status.md

@@ -0,0 +1,10 @@
+---
+description: 扫人工闸与 status（声称与闸表冲突则 STOP）
+kit_command_id: 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/commands/claude/kit/graph-check.md

@@ -0,0 +1,8 @@
+---
+description: 结构变更后编排 graph yaml check（CLI 真值）
+kit_command_id: kit-graph-check
+---
+
+结构变更后：编排跑 `npx spec-wave graph yaml check`（按需 compile/export）。
+真值在 CLI；勿口头代过。POINTER：README graph 段 · 消费者仓 `docs/_tech_graph/`（若有）。
+禁止无闸 `kit-30` / `kit-publish`。

package/assets/ide/commands/claude/kit/hat-00-delegate.md

@@ -0,0 +1,9 @@
+---
+description: 00 只委派（POINTER → harness-00-delegate-only）
+kit_command_id: kit-hat-00-delegate
+---
+
+你是 00 统筹时：读 skill `harness-00-delegate-only`（POINTER，勿贴 L1 全文）。
+已有 SPEC/task 初稿时禁止亲自实现，只委派子 Agent。
+本命令不授予 30 改码权；禁止无闸 `kit-30` / `kit-publish`。
+勿冒充 opsx / speckit 前缀。

package/assets/ide/commands/claude/kit/hat-10-spec.md

@@ -0,0 +1,9 @@
+---
+description: 起草/修订 SPEC（POINTER → harness-10-spec）
+kit_command_id: kit-hat-10-spec
+---
+
+你是 10-spec：读 skill `harness-10-spec`（POINTER，勿贴 L1 全文）。
+产出写消费者仓 `docs/spec/`；不代替闸签收。
+本命令不授予 30 改码权；禁止无闸 `kit-30`。
+勿冒充 opsx / speckit 前缀。

package/assets/ide/commands/claude/kit/hat-10-task.md

@@ -0,0 +1,9 @@
+---
+description: 起草/修订 Harness task（POINTER → harness-10-task）
+kit_command_id: kit-hat-10-task
+---
+
+你是 10-task：读 skill `harness-10-task`（POINTER，勿贴 L1 全文）。
+产出写 `docs/tasks/`；闸表字段以 task 真值为准。
+本命令不授予 30 改码权；禁止无闸 `kit-30`。
+勿冒充 opsx / speckit 前缀。

package/assets/ide/commands/claude/kit/hat-20-spec-audit.md

@@ -0,0 +1,9 @@
+---
+description: 书面审查 SPEC（POINTER → harness-20-spec-audit）
+kit_command_id: kit-hat-20-spec-audit
+---
+
+你是 20-spec-audit：读 skill `harness-20-spec-audit`（POINTER，勿贴 L1 全文）。
+审查落 `docs/harness/reviews/`；不代人改闸状态。
+本命令不授予 30 改码权；禁止无闸 `kit-30`。
+勿冒充 opsx / speckit 前缀。

package/assets/ide/commands/claude/kit/hat-20-task-audit.md

@@ -0,0 +1,9 @@
+---
+description: 书面审查 task（POINTER → harness-20-task-audit）
+kit_command_id: kit-hat-20-task-audit
+---
+
+你是 20-task-audit：读 skill `harness-20-task-audit`（POINTER，勿贴 L1 全文）。
+审查落 `docs/harness/reviews/`；HG-AUDIT-R1 pending 时 30 仍拒改码。
+本命令不授予 30 改码权；禁止无闸 `kit-30`。
+勿冒充 opsx / speckit 前缀。

package/assets/ide/commands/claude/kit/hat-reanchor.md

@@ -0,0 +1,8 @@
+---
+description: 长对话丢帽时重锚（不替代 30 授权）
+kit_command_id: kit-hat-reanchor
+---
+
+长对话丢失角色时：读 skill harness-hat-reanchor / FRAGMENT_hat_reanchor（POINTER，勿贴全文）。
+本命令不授予 30 改码权；HG-AUDIT-R1 pending 时仍拒改码。
+勿冒充 opsx 或其他产品的 slash 前缀。

package/assets/ide/commands/claude/kit/init-guide.md

@@ -0,0 +1,16 @@
+---
+description: 分清插件 init_coding_kit 与 CLI init（双入口不合并）
+kit_command_id: 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/commands/claude/kit/sync-prompts-guide.md

@@ -0,0 +1,9 @@
+---
+description: sync prompts 纪律：默认 dry-run；conflict 不覆盖
+kit_command_id: kit-sync-prompts-guide
+---
+
+先跑 `npx spec-wave sync prompts`（默认 dry-run）看清单；再按需 `--yes`。
+已存在且内容不同 → conflict，不覆盖，除非显式 `--force`。
+只写 Starter prompts 白名单；禁止写入 S2（tasks/reviews/invokes）。
+禁止无闸 `kit-30` / `kit-publish`。

package/assets/ide/commands/claude/kit/verify.md

@@ -0,0 +1,16 @@
+---
+description: 编排跑 dsh-coding-kit verify（failClosed；解释 exit 0/1/2）
+kit_command_id: kit-verify
+---
+
+你是 ops 编排助手，不是门禁本身。Verify 真值在 CLI；禁止用本 markdown 假装闸过。
+
+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/ide/commands/cursor/kit-apply-standards.md

@@ -0,0 +1,12 @@
+---
+name: "/kit-apply-standards"
+id: "kit-apply-standards"
+description: "指导应用 coding standards（POINTER；不静默改 S2）"
+kit_command_id: 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，本命令只编排、不替代闸。

package/assets/ide/commands/cursor/kit-gate-status.md

@@ -0,0 +1,12 @@
+---
+name: "/kit-gate-status"
+id: "kit-gate-status"
+description: "扫人工闸与 status（声称与闸表冲突则 STOP）"
+kit_command_id: 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/commands/cursor/kit-graph-check.md

@@ -0,0 +1,10 @@
+---
+name: "/kit-graph-check"
+id: "kit-graph-check"
+description: "结构变更后编排 graph yaml check（CLI 真值）"
+kit_command_id: kit-graph-check
+---
+
+结构变更后：编排跑 `npx spec-wave graph yaml check`（按需 compile/export）。
+真值在 CLI；勿口头代过。POINTER：README graph 段 · 消费者仓 `docs/_tech_graph/`（若有）。
+禁止无闸 `kit-30` / `kit-publish`。

package/assets/ide/commands/cursor/kit-hat-00-delegate.md

@@ -0,0 +1,11 @@
+---
+name: "/kit-hat-00-delegate"
+id: "kit-hat-00-delegate"
+description: "00 只委派（POINTER → harness-00-delegate-only）"
+kit_command_id: kit-hat-00-delegate
+---
+
+你是 00 统筹时：读 skill `harness-00-delegate-only`（POINTER，勿贴 L1 全文）。
+已有 SPEC/task 初稿时禁止亲自实现，只委派子 Agent。
+本命令不授予 30 改码权；禁止无闸 `kit-30` / `kit-publish`。
+勿冒充 opsx / speckit 前缀。

package/assets/ide/commands/cursor/kit-hat-10-spec.md

@@ -0,0 +1,11 @@
+---
+name: "/kit-hat-10-spec"
+id: "kit-hat-10-spec"
+description: "起草/修订 SPEC（POINTER → harness-10-spec）"
+kit_command_id: kit-hat-10-spec
+---
+
+你是 10-spec：读 skill `harness-10-spec`（POINTER，勿贴 L1 全文）。
+产出写消费者仓 `docs/spec/`；不代替闸签收。
+本命令不授予 30 改码权；禁止无闸 `kit-30`。
+勿冒充 opsx / speckit 前缀。

package/assets/ide/commands/cursor/kit-hat-10-task.md

@@ -0,0 +1,11 @@
+---
+name: "/kit-hat-10-task"
+id: "kit-hat-10-task"
+description: "起草/修订 Harness task（POINTER → harness-10-task）"
+kit_command_id: kit-hat-10-task
+---
+
+你是 10-task：读 skill `harness-10-task`（POINTER，勿贴 L1 全文）。
+产出写 `docs/tasks/`；闸表字段以 task 真值为准。
+本命令不授予 30 改码权；禁止无闸 `kit-30`。
+勿冒充 opsx / speckit 前缀。

package/assets/ide/commands/cursor/kit-hat-20-spec-audit.md

@@ -0,0 +1,11 @@
+---
+name: "/kit-hat-20-spec-audit"
+id: "kit-hat-20-spec-audit"
+description: "书面审查 SPEC（POINTER → harness-20-spec-audit）"
+kit_command_id: kit-hat-20-spec-audit
+---
+
+你是 20-spec-audit：读 skill `harness-20-spec-audit`（POINTER，勿贴 L1 全文）。
+审查落 `docs/harness/reviews/`；不代人改闸状态。
+本命令不授予 30 改码权；禁止无闸 `kit-30`。
+勿冒充 opsx / speckit 前缀。

package/assets/ide/commands/cursor/kit-hat-20-task-audit.md

@@ -0,0 +1,11 @@
+---
+name: "/kit-hat-20-task-audit"
+id: "kit-hat-20-task-audit"
+description: "书面审查 task（POINTER → harness-20-task-audit）"
+kit_command_id: kit-hat-20-task-audit
+---
+
+你是 20-task-audit：读 skill `harness-20-task-audit`（POINTER，勿贴 L1 全文）。
+审查落 `docs/harness/reviews/`；HG-AUDIT-R1 pending 时 30 仍拒改码。
+本命令不授予 30 改码权；禁止无闸 `kit-30`。
+勿冒充 opsx / speckit 前缀。

package/assets/ide/commands/cursor/kit-hat-reanchor.md

@@ -0,0 +1,10 @@
+---
+name: "/kit-hat-reanchor"
+id: "kit-hat-reanchor"
+description: "长对话丢帽时重锚（不替代 30 授权）"
+kit_command_id: kit-hat-reanchor
+---
+
+长对话丢失角色时：读 skill harness-hat-reanchor / FRAGMENT_hat_reanchor（POINTER，勿贴全文）。
+本命令不授予 30 改码权；HG-AUDIT-R1 pending 时仍拒改码。
+勿冒充 opsx 或其他产品的 slash 前缀。

package/assets/ide/commands/cursor/kit-init-guide.md

@@ -0,0 +1,18 @@
+---
+name: "/kit-init-guide"
+id: "kit-init-guide"
+description: "分清插件 init_coding_kit 与 CLI init（双入口不合并）"
+kit_command_id: 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/commands/cursor/kit-sync-prompts-guide.md

@@ -0,0 +1,11 @@
+---
+name: "/kit-sync-prompts-guide"
+id: "kit-sync-prompts-guide"
+description: "sync prompts 纪律：默认 dry-run；conflict 不覆盖"
+kit_command_id: kit-sync-prompts-guide
+---
+
+先跑 `npx spec-wave sync prompts`（默认 dry-run）看清单；再按需 `--yes`。
+已存在且内容不同 → conflict，不覆盖，除非显式 `--force`。
+只写 Starter prompts 白名单；禁止写入 S2（tasks/reviews/invokes）。
+禁止无闸 `kit-30` / `kit-publish`。

package/assets/ide/commands/cursor/kit-verify.md

@@ -0,0 +1,18 @@
+---
+name: "/kit-verify"
+id: "kit-verify"
+description: "编排跑 dsh-coding-kit verify（failClosed；解释 exit 0/1/2）"
+kit_command_id: kit-verify
+---
+
+你是 ops 编排助手，不是门禁本身。Verify 真值在 CLI；禁止用本 markdown 假装闸过。
+
+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/ide/host-adapt/README.md

@@ -0,0 +1,113 @@
+# Host-adapt · 落点矩阵与 CLI（2.1.1）
+
+> 适配表示例：[`examples/mvp-hosts.yaml`](./examples/mvp-hosts.yaml)  
+> Schema：[`host-adapt.schema.json`](./host-adapt.schema.json)  
+> 仓根叙事：README「一包多宿主」· 录屏清单：[`../../../docs/guides/DOGFOOD_host_adapt_cursor_claude_录屏清单_v1_zh.md`](../../../docs/guides/DOGFOOD_host_adapt_cursor_claude_录屏清单_v1_zh.md)  
+> 规划：[`../../../docs/roadmap/PLAN_2_1_1_host_tools_ux_v1_zh.md`](../../../docs/roadmap/PLAN_2_1_1_host_tools_ux_v1_zh.md)
+
+## CLI
+
+```bash
+npx spec-wave host validate [--file PATH] [--json]
+npx spec-wave host apply --tools cursor,claude[,dsh,agents|all] --profile core|expanded [--dry-run|--yes]
+npx spec-wave host update [--tools LIST|all] [--profile core|expanded] [--yes] [--force]
+npx spec-wave init --preset harness-only [--tools all|none|LIST] [--profile core|expanded] [--host-adapt|--no-host-adapt] [--yes]
+```
+
+- 默认 **dry-run**；`--yes` 才写盘（`host apply` / `host update`）。  
+- **U-01**：表 version / 可选 `dsh-tools` peer 不匹配 → exit **2**、零写入。  
+- 默认**跳过** `harness-30-execute` / `harness-40-self-check`（与 `skills install` 同口径）。  
+- **`expanded`**：在 core 之上物化 `kit-hat-*`（及 `kit-graph-check` / `kit-sync-prompts-guide`）；禁 `kit-30` / `kit-publish`。  
+- **无 postinstall** 静默写盘；装包 ≠ 物化。
+
+### `--tools` 词表
+
+| 值 | 含义 |
+|----|------|
+| `cursor,claude,dsh` | 逗号列表（`host apply` **须**显式传） |
+| `all` | 适配表全部 `host_id` |
+| `none` | **仅 `init`**：跳过 host 物化（只做过程根） |
+
+## 粘性 · `.coding-kit/host-tools.json`
+
+`host apply` / `host update` / `init`（含物化）在 **`--yes` 成功写盘** 后写入或更新：
+
+```json
+{
+  "version": 1,
+  "host_ids": ["cursor", "claude", "dsh", "agents"],
+  "profile": "core",
+  "updated_at": "2026-09-10T00:00:00.000Z",
+  "kit_semver": "2.1.1"
+}
+```
+
+- 属过程根 `.coding-kit/`；**可入库**，便于团队同选型。  
+- dry-run **不**写粘性。  
+- `init --no-host-adapt`：**不** apply **亦**不写粘性（避免「记住了却未物化」）。  
+- `init --tools none`：只做过程根，不写粘性。
+
+## `host update` 解析序（方案 A · 相对 2.1.0 BREAKING 小）
+
+1. CLI 给了 `--tools`（含 `all`）→ 用 CLI  
+2. 否则若粘性存在且 `host_ids.length ≥ 1` → 用粘性  
+3. 否则 → **exit 1**（提示先 `apply` / `init`，或传 `--tools LIST` / `--tools all`）
+
+相对 **2.1.0**「省略 `--tools` = 适配表全量」：有粘性时 `host update --yes` **只**刷已选宿主；无粘性且无 `--tools` **不再**默默全表。
+
+升包后推荐：
+
+```bash
+npx spec-wave@2.1.1 host update --yes
+```
+
+## `init` 选型（对齐 OpenSpec）
+
+| 环境 | 无 `--tools` |
+|------|----------------|
+| TTY | **默认询问**（多选 cursor / claude / dsh / agents / all / none） |
+| 非 TTY / CI | **exit 1** · 须显式 `--tools all\|none\|LIST` |
+
+```bash
+# 非交互：过程根 + 物化
+npx spec-wave init --preset harness-only --tools cursor,claude,dsh --yes
+
+# 非交互：仅过程根
+npx spec-wave init --preset harness-only --tools none --yes
+```
+
+`tools≠none` 且未 `--no-host-adapt` → 同进程 `host apply` + 写粘性。
+
+## 宿主 × 表面（MVP）
+
+| host_id | always_on | commands (core) | skills |
+|---------|-----------|-----------------|--------|
+| `cursor` | `.cursor/rules/*.mdc` | `.cursor/commands/kit-*.md` | `.cursor/skills` |
+| `claude` | `CLAUDE.md`（marker merge） | `.claude/commands/kit/<verb>.md`（`/kit:verb`） | `.claude/skills` |
+| `dsh` | （可空） | **`[]`（禁止 `.dsh/commands`）** | `.dsh/skills`：帽子 `assets/skills/*` **+** 编排 `assets/ide/skills-orch/*`（`/kit-*`） |
+| `agents` | `AGENTS.md`（产品 marker + **local** 定制） | 可空 | `.agents/skills` |
+
+Core 五命令：`kit-apply-standards` · `kit-verify` · `kit-gate-status` · `kit-init-guide` · `kit-hat-reanchor`（前缀 **`kit-`**；禁止冒充 `opsx-*`）。  
+Expanded（`--profile expanded`）：`kit-hat-00-delegate` · `kit-hat-10-spec` · `kit-hat-10-task` · `kit-hat-20-spec-audit` · `kit-hat-20-task-audit` · `kit-graph-check` · `kit-sync-prompts-guide`。
+
+## 纪律
+
+- **S2**（`docs/tasks` / reviews / invokes）永不作为物化 target。  
+- **local** 块（`cyning-harness-local`）永不覆写。  
+- **update**：conflict 默认 skip；`--force` 显式覆盖并备份 `.coding-kit/backups/host-update/`。
+
+## 本仓 dogfood（最短路径）
+
+`dsh-coding-kit` **源码仓也是消费者**。发版后或改 assets 后在仓根：
+
+```bash
+# 首次 / 改选型
+node ./lib/cli.js host apply --tools cursor,claude,dsh,agents --profile core --yes
+# 或：npx spec-wave@2.1.1 host apply --tools cursor,claude,dsh,agents --profile core --yes
+
+# 升包后只刷已选（读粘性；不必再抄 LIST）
+npx spec-wave@2.1.1 host update --yes
+```
+
+落点（`.cursor/` · `.claude/` · `.dsh/` · `.agents/` · `CLAUDE.md` · `AGENTS.md`）**应入库**。  
+**`AGENTS.md`**：上方 harness 产品块 = 通用 Agent 入口；仓特定导航写在 `cyning-harness-local` 块（upgrade 不覆写）。真值源仍是 `assets/`。

package/assets/ide/host-adapt/examples/mvp-hosts.yaml

@@ -0,0 +1,78 @@
+# Host-adapt 声明式适配表 · MVP 宿主（dsh / cursor / claude / agents）
+# 校验：npx spec-wave host validate [--file PATH]
+# 物化：npx spec-wave host apply --tools cursor,claude --profile core|expanded [--dry-run|--yes]
+# 刷新：npx spec-wave host update [--tools LIST] [--profile core|expanded] [--dry-run|--yes] [--force]
+# schema：../host-adapt.schema.json
+# skills 落点矩阵：../README.md
+version: "1"
+hosts:
+  - host_id: dsh
+    surfaces:
+      always_on: []
+      skills:
+        # 帽子六条（跳过 30/40）
+        - target_dir: .dsh/skills
+          from: assets/skills/*
+        # 编排五条（B-DSH-ORCH=B · /kit-* skill；上游无 .dsh/commands）
+        - target_dir: .dsh/skills
+          from: assets/ide/skills-orch/*
+      # DSH：slash 发现根 = .dsh/skills；commands 必须空
+      commands: []
+      verify:
+        kind: cli
+        bin: dsh-coding-kit
+        failClosed: true
+
+  - host_id: cursor
+    surfaces:
+      always_on:
+        - target: .cursor/rules/05-kit-starter.mdc
+          source: assets/ide/adapters/cursor-harness-starter.mdc.example
+      skills:
+        - target_dir: .cursor/skills
+          from: assets/skills/*
+      commands:
+        - target_dir: .cursor/commands
+          from: assets/ide/commands/cursor/*
+          profile: core
+        - target_dir: .cursor/commands
+          from: assets/ide/commands/cursor/*
+          profile: expanded
+      verify:
+        kind: cli
+        bin: dsh-coding-kit
+        failClosed: true
+
+  - host_id: claude
+    surfaces:
+      always_on:
+        - target: CLAUDE.md
+          source: assets/ide/adapters/CLAUDE.md.fragment.example
+      skills:
+        - target_dir: .claude/skills
+          from: assets/skills/*
+      commands:
+        - target_dir: .claude/commands/kit
+          from: assets/ide/commands/claude/kit/*
+          profile: core
+        - target_dir: .claude/commands/kit
+          from: assets/ide/commands/claude/kit/*
+          profile: expanded
+      verify:
+        kind: cli
+        bin: dsh-coding-kit
+        failClosed: true
+
+  - host_id: agents
+    surfaces:
+      always_on:
+        - target: AGENTS.md
+          source: assets/ide/adapters/AGENTS.md.fragment.example
+      skills:
+        - target_dir: .agents/skills
+          from: assets/skills/*
+      commands: []
+      verify:
+        kind: cli
+        bin: dsh-coding-kit
+        failClosed: true