spec-wave 2.1.1

package/README.zh-CN.md

@@ -0,0 +1,327 @@
+# SpecGate
+
+简体中文 | [English](README.md)
+
+**SpecGate**（`spec-wave@2.1.1`）是 **多宿主编码 CLI**（Cursor · Claude Code · 可选 DSH），带 **P0 闸 / Harness 过程命令** 与 IDE 物化。曾用名 **dsh-coding-kit**。纪律资产仍是 ICVO（Inform · Constrain · Verify · Orchestrate）。
+
+> **加载 ≠ 注入。** 安装或加载可选 DSH 插件 **不会** 自动改写 system prompt。`apply()` 只注册工具。必须由你或模型调用 `apply_coding_standards` 之后，后续回合的 runtime context 才会含 `# Coding Standards`。
+
+## 选哪条入口
+
+| 你是谁 | 入口 | 不要用 |
+|--------|------|--------|
+| Cursor / Claude Code / CI · 存量仓 | `npx spec-wave`（可选 `host apply`） | 不要把插件 `init_coding_kit` 与 CLI `init` 当成同一入口 |
+| DSH 会话 / 模型调工具（可选） | `dsh plugin add dsh-coding-kit`（过渡包名；同一包） | 不要只 `npm install`（缺 bundle 层则工具不出现） |
+
+主入口是 npm 包 **`spec-wave@2.1.1`** 的 **`npx spec-wave`**。过渡 bin `specgate` / `dsh-coding-kit` 仍可用。插件面与 CLI 面互不替代。
+
+### 一包多宿主（F6 · 2.0 + 技能/编排 · 2.1 · tools UX · 2.1.1）
+
+单一声明式适配表 → 多个宿主原生落点（always_on + skills + **commands**）。Verify 真值仍在 CLI（`failClosed` exit **2**）；IDE slash/command 只编排。**装 npm 包不会自动物化 IDE 文件**（无 postinstall）；须显式跑 `init --tools` / `host apply`。
+
+| 宿主 | `host apply`（profile `core`）写入 |
+|------|-------------------------------------|
+| **Cursor** | `.cursor/rules/*.mdc` · `.cursor/commands/kit-*.md` · `.cursor/skills/` |
+| **Claude Code** | `CLAUDE.md` 产品 marker 块 · `.claude/commands/kit/<verb>.md` → **`/kit:verb`** · `.claude/skills/` |
+| **DSH** | `.dsh/skills/` — 帽子技能 **+** 编排 `kit-*`（`/` 可发现；**不**建 `.dsh/commands/`） |
+| **agents**（可选） | `AGENTS.md` 片段 · `.agents/skills/` |
+
+**2.1 增量**（同一包）：Claude `/kit:` 命名空间 · DSH `.dsh/skills/kit-*` 编排 · 可选 `--profile expanded` 物化 `kit-hat-*` 薄壳（默认仍 `core`）。
+
+**2.1.1 · 安装/升级 UX**（对齐 OpenSpec `init --tools`）：
+
+| 主题 | 行为 |
+|------|------|
+| 粘性 | `host apply` / `host update` / `init`（含物化）在 `--yes` 成功写盘后更新 `.coding-kit/host-tools.json`（`host_ids` + `profile`）。dry-run **不**写粘性。 |
+| `--tools` | `LIST`（如 `cursor,claude,dsh`）· `all`（适配表全部 host_id）· `none`（**仅 init**：只过程根、不物化）。`host apply` **必须**带 `--tools`。 |
+| `host update`（方案 **A**） | 解析序：CLI `--tools` → 粘性 → 否则 **exit 1**。有粘性时 `host update --yes` **只**刷已选宿主。相对 2.1.0「省略 `--tools` = 全表」为 **BREAKING（小）**。 |
+| `init` | TTY 无 `--tools` → **询问**（多选 / all / none）。非 TTY / CI 无 `--tools` → **exit 1**。`tools≠none` 且未 `--no-host-adapt` → 同进程 `host apply` + 写粘性。`--no-host-adapt` → 不 apply **亦不**写粘性。 |
+
+最短路径（先 dry-run，再写盘）：
+
+```bash
+npx spec-wave@2.1.1 host validate
+npx spec-wave@2.1.1 host apply --tools cursor,claude,dsh --profile core
+npx spec-wave@2.1.1 host apply --tools cursor,claude,dsh --profile core --yes
+# 可选：--profile expanded   # kit-hat-* 薄壳
+# 可选：--tools all
+
+# 升包后：刷粘性已选宿主（不必再抄 --tools）
+npx spec-wave@2.1.1 host update --yes
+
+# 首次 / CI：init 选型（仅过程根：--tools none）
+npx spec-wave@2.1.1 init --preset harness-only --tools cursor,claude,dsh --yes
+```
+
+`--yes` 后：Cursor 命令面板应可见 `kit-verify` / `kit-gate-status` 等；Claude Code 应对应出现 `/kit:verify` 等；DSH 应列出 `.dsh/skills/kit-*`。完整矩阵见 [`assets/ide/host-adapt/README.md`](assets/ide/host-adapt/README.md)；录屏清单见 [`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)。
+
+`peerDependencies` 中的 `@deepseek-ai/cordis` 与 `@deepseek-ai/dsh-tools` 是 **DSH 宿主插件契约**（仅宿主加载本包为插件时需要；CLI-only 不需要），已在 `peerDependenciesMeta` 标为 **optional**。
+
+## 入口 A · DSH 插件
+
+优先 npm（预构建，无需 allowBuilds）：
+
+```bash
+dsh plugin --profile web add dsh-coding-kit
+```
+
+备选：从 GitHub 安装（需 Node 构建；pnpm 10+ 可能要 allowBuilds）：
+
+```bash
+dsh plugin --profile web add github:Cyning12/SpecGate#main
+```
+
+### 确认层
+
+```bash
+dsh --profile web --dump-config
+```
+
+安装成功后，profile 的 `package.json` 会出现依赖 `dsh-coding-kit`，且 `dsh.profile.bundles` 含该包名。用户一般不必手写 bundles；`dsh plugin add` 会维护。
+
+### 激活与调用
+
+1. 用该 profile 启动 DSH（例如 `dsh --profile web` / `dsh --profile web web`）。
+2. 在对话中说：**请应用 coding standards**（或「按 coding-kit 规范写代码」）。
+3. 模型应调用工具 `apply_coding_standards`。
+4. 成功后后续回合的 runtime context 含 `# Coding Standards`。
+
+可选参数：`profile=l1|l1+l2|full`（默认 `l1+l2`）；`persist=false` 表示只在当轮工具结果里给出正文。
+
+profile 档语义：
+
+| 档 | 内容 |
+|----|------|
+| `l1` | L1 规范 + coding_wiki |
+| `l1+l2`（默认） | 全部 standards + coding_wiki |
+| `full` | **当前版本等价于 `l1+l2`**；保留枚举值，为后续扩展 bundle（差异化注入内容）预留 |
+
+**override 根查找规则（自 1.3.0）**：`apply_coding_standards` 从当前工作目录逐级向上探测 `.coding-kit` 与 `.dsh/coding-kit`，在最近的含 `.git` 的祖先目录（git root）处截止——monorepo 子目录启动 DSH 也能命中仓根 override；git root 之外的更上层目录不会被误吸。无 `.git` 时向上查找到文件系统根。工具输出的 `source=override|package` 与 `root=` 行可观测实际命中。
+
+注入内容超 24k 字符时按**文件边界**截断：截断点只落在文件之间，不会注入半份文件；被略文件可由 `root` 下全集减去工具输出的 `files` 列表推出，且 `truncated=true` 附截断标记。
+
+### 初始化项目模板（插件面）
+
+初始化走工具 **`init_coding_kit`**（不是 CLI `init`）。
+
+对话：**请把 coding-kit 模板初始化到本项目** → 模型调用 `init_coding_kit`。  
+之后修改 `.coding-kit/`，再调用 `apply_coding_standards`（`source=override`）。`init_coding_kit` 不覆盖已有文件。
+
+注意（读写根口径不对称，自 1.3.0 明示）：**读取面**（`apply_coding_standards`）向上查找到 git root；**写入面**（`init_coding_kit`）仍写入当前工作目录。请在**仓根**对话中调用 `init_coding_kit`，避免在 monorepo 子目录里初始化后读取面却命中仓根。
+
+部分 IDE / yaml-language-server 会把根目录 `cordis.patch.yml` 当成 RFC6902 JSON Patch，报缺 `op` / `path` / `value`。这是误报，可忽略；该文件必须保持 `- insert`，不要改成 JSON Patch。
+
+## 入口 B · CLI（Cursor / Claude Code / CI）
+
+P0 闸与 G1–G7（**1.2.0 已交付**）：
+
+```bash
+npx spec-wave init [--preset NAME] [--tools all|none|LIST] [--profile core|expanded] [--host-adapt|--no-host-adapt] [--yes]   # NAME 词表: harness-only（唯一合法值）
+npx spec-wave upgrade --yes
+npx spec-wave refresh-ide-blocks [--target PATH] [--dry-run] [--yes] [--json]
+npx spec-wave check
+npx spec-wave verify --task <task.md> [--with-wiki-lint]
+npx spec-wave verify --spec <SPEC.md>   # SPEC→00 前审查文存在性闸（与 --task 互斥 · --with-wiki-lint 同生效）
+npx spec-wave gate-check --task <task.md>
+npx spec-wave audit --task <task.md>
+npx spec-wave task lint --file <task.md>
+npx spec-wave task close --file <task.md>
+npx spec-wave status [--target] [--task] [--json] [--check]
+npx spec-wave timeline --task FILE
+npx spec-wave lifecycle show [--json]
+npx spec-wave lifecycle dry-run --transition ID --from STATE
+npx spec-wave discipline show [--json]
+npx spec-wave graph yaml compile|check|export
+npx spec-wave graph ingest|snapshot|axioms
+npx spec-wave sync index
+npx spec-wave sync prompts [--target PATH] [--yes] [--force] [--json]
+npx spec-wave skills install [--target DIR] [--out DIR] [--global] [--force] [--with-execute-hats]
+npx spec-wave skills build [--with-execute-hats]
+npx spec-wave skills check
+npx spec-wave host validate [--file PATH] [--json]
+npx spec-wave host apply --tools cursor,claude --profile core [--target PATH] [--file PATH] [--json] [--dry-run|--yes]
+npx spec-wave host update [--tools LIST|all] [--profile core] [--target PATH] [--file PATH] [--json] [--dry-run|--yes] [--force]
+npx spec-wave wiki export --json
+npx spec-wave task lint-done
+npx spec-wave task lint-wiki-delta
+npx spec-wave task check --file PATH
+```
+
+`host apply` / `host update` 嗅探适配表 version 与可选 `@deepseek-ai/dsh-tools` peer（**U-01**）：不匹配 → exit 2、零写入（`--json` 含 `contract.status`）。`--tools dsh` 仍 commands=[]（不建 `.dsh/commands/`），编排落在 `.dsh/skills/kit-*`。**`host update` 省略 `--tools`** 时读粘性 `.coding-kit/host-tools.json`（否则 exit 1）。落点见上方 **一包多宿主**。
+
+kit **源码仓**以 `docs/_tech_graph/` 做 `graph yaml compile|check|export` 的 dogfood（**不随 npm 包发布**；https://github.com/Cyning12/SpecGate/tree/main/docs/_tech_graph）。
+
+`init` / `upgrade` / `sync index` / `skills build` 不覆盖 S2 过程域（`docs/tasks/`、`docs/harness/reviews/`、`docs/harness/invokes/by-task/`，以及 legacy 裸 `reviews/` / `invokes/by-task/`）。**S2 前缀真值源唯一**（`cli-shared` 的 `S2_TRUTH_PREFIXES`；F1 / 1.x MVP）。`sync prompts` 仅写入 Starter 白名单（`docs/harness/prompts/` **11** 文件 + `docs/harness/templates/TASK_TEMPLATE.md`）——默认 dry-run；本地内容与包内不同则列为 conflict 且不覆盖（`--force` 显式覆盖）。
+
+`verify --with-wiki-lint`（显式旗标 · 非破坏）：在既有检查之上追加 `lint-wiki-delta`（默认档 · `scope=all`），`--task` 与 `--spec` 模式同生效。有缺口时 verify 判 BLOCKED，列出 issue（缺口可能来自兄弟 active/done task），并打印与 PR CI 逐字一致的复跑命令 `npx --yes spec-wave task lint-wiki-delta --target .`（见 `assets/ci/samples/lint-wiki-delta.yml.example`）；`--json` 增 `wiki_lint` 块（`ok` / `issues` / `scanned`）。target 无 `docs/tasks/` 目录时 scanned:0，不会误 BLOCKED。无旗标时 `verify` 行为与之前逐字一致。
+
+`graph yaml export` / `graph yaml check` 的 graph 面行为自 1.7.0 起修正：① export 的 `graph_id` 以 yaml 声明值（`data.graph_id`，如 `00_main`）为唯一真值源写入 graphs/nodes/edges，不再用路径命名空间 id（如 `l0/00_main`）——路径 id 仅作输入兼容定位（`--graph-id` / 文件发现）；② `check --all` 的 graph.json 切片过滤口径与 export 输出对齐（同一声明值真值源），kit 自产根 json 与 check 互认；③ export 保留全部 mark 类型（`?>` / `~>` / `::…` / `[…]`）的边 label（拓扑协议标记作为边属性呈现，不再丢弃 label 文本）；④ compile 生成的 Mermaid class 段按 `nodes[].kind`（`flow`/`struct`/`external` → `phase`/`doc`/`infra`）生成，无 `kind` 时保留 id 推断作兜底。exit 码不变。**消费者注意**：依赖旧 export 输出（命名空间 graph_id / 空 label）的消费方需重跑 `graph yaml export`。
+
+`check` 对 `manifest.version` 与包版本做三向比较（已是最新 / 可升级 / 高于）。自 1.5.2 起，当 manifest 带非 null `from_version`（即从旧 `@cyning/harness` 产品线迁来）时，「高于」分支输出跨产品线迁移语义（`@cyning/harness X → dsh-coding-kit Y`——跨产品线版本号不可比）并建议 `npx spec-wave upgrade --yes`，不再误报「可能为降级安装」；自 1.7.0 起该判据收窄为 `from_version` 属旧包产品线词表（2.x 系列）才走迁移文案，kit 线（1.x）`from_version` 与 `from_version: null` 均保留原三向文案。exit 码不变（恒 0）。
+
+### refresh-ide-blocks（R-07 · 存量 IDE 块旧命令字面刷写）
+
+旧包 `@cyning/harness` 时代 wizard marker merge 嵌入的 IDE 块（`<!-- cyning-harness:begin -->` … `<!-- cyning-harness:end -->`）内可能滞留旧命令字面。`refresh-ide-blocks` 仅在这类 **product marker 块体内** 做白名单字面替换：
+
+- **默认 dry-run**：无旗标（或显式 `--dry-run`）只扫描 + 报告，零写入，exit 0；`--yes` 才写盘。
+- **发现面（冻结白名单）**：仓根 `AGENTS.md`、`CLAUDE.md`、`.cursor/rules/*.mdc`（单层）。发现面之外的文件即使含 marker 也不处理。
+- **映射表（冻结 · 仅块体内生效）**：
+
+  | 组 | 规则 | 行为 |
+  |----|------|------|
+  | A1 | `npx @cyning/harness` → `npx spec-wave` | 自动替换，子命令与参数原样保留 |
+  | A2 | `npx @cyning/harness@<version>` → `npx spec-wave` | 自动替换，钉版整体丢弃（报告记 dropped_pin） |
+  | A3 | `npx --yes @cyning/harness[@<version>]` → `npx --yes spec-wave` | 自动替换，`--yes` 保留、钉版丢弃 |
+  | A4 | 裸 bin 形态 `harness skills build` / `harness skills check` → `npx spec-wave skills build` / `npx spec-wave skills check` | 自动替换（行前缀已含 `npx spec-wave` 时防二刷） |
+  | A5 | `npx dsh-coding-kit` → `npx spec-wave` | 自动替换（B-REFRESH · SpecGate 改名） |
+  | A6 | `npx dsh-coding-kit@<version>` → `npx spec-wave` | 自动替换，钉版丢弃（dropped_pin） |
+  | A7 | `npx --yes dsh-coding-kit[@<version>]` → `npx --yes spec-wave` | 自动替换，`--yes` 保留、钉版丢弃 |
+  | B1–B5 | `CYNING_HARNESS` / `--with-scripts` / `wizard/` 路径 / `harness:<name>` script 名 / 其他裸 `@cyning/harness` 引用 | **仅报告「需人工」，不替换** |
+
+- **纪律**：marker 行与块外内容字节不动；`<!-- cyning-harness-local:begin -->` 块永不改写；`docs/tasks/`、`docs/harness/reviews/`、`docs/harness/invokes/by-task/`（S2）一律拒写。
+- **preflight（--yes 专用 fail-fast，exit 2 零写入）**：git 脏树 / 单文件新旧字面混杂（MIXED）/ marker 配对畸形（MALFORMED）/ S2 断言闸任一命中即拒写。脏树判定采用 `git status --porcelain` 语义——**untracked 文件也计入脏树**，`--yes` 前请先 commit 或 `git stash -u`。
+- **备份与回滚**：--yes 写盘前原字节备份到 `.coding-kit/backups/refresh-ide-blocks/<UTCts>/`（保留最近 5 代）；回滚首选 `git checkout -- <path>`，非 git 仓用备份 cp 回。备份仅供本机回滚——建议消费者将 `.coding-kit/backups/` 加入 `.gitignore`（不入库）。存量树可能仍有 legacy `.cyning-harness/backups/`；新写不再以此为目标。
+- **无 marker 文件（仅报告，绝不改写）**：发现面内 0 product 块文件用 A/B 组同一组正则做只读扫描，命中入人类报告「无 marker 检出（仅报告，不刷写）」段与 --json top-level `plain_mentions: [{path, rule, count}]` 字段（schema 保持 `@1`，向后兼容增量）；不触发 preflight fail-fast，不改 exit 码。
+- **幂等**：已刷写文件再次运行 A 组命中 0，`files_written=0`、字节不变、exit 0。
+- `--json` 输出单行机器报告（schema `dsh-coding-kit/refresh-ide-blocks-report@1`；自 1.5.2 起向后兼容增量含 `plain_mentions` / `totals.plain_mentions`）。
+
+### D5 测试制品探测边界（audit / verify · test_strategy=required）
+
+`audit` / `verify` 在 task 声明 `test_strategy=required` 时执行 D5 强检查：目标仓须存在**真实测试制品**，否则 exit 2。D5 是制品探测，不执行测试命令。探测口径（自 1.3.0 收紧）：
+
+**强信号探针（存在即 PASS）**
+
+- 目录：`test/` `tests/` `spec/` `specs/` `__tests__/`
+- 配置文件：`jest.config.{js,ts}` `vitest.config.{js,ts}` `playwright.config.{js,ts}` `cypress.config.js` `pytest.ini`
+- 测试文件名（仓根起 3 层内）：`*.(test|spec).(js|ts|mjs|cjs)`、`*_test.py`、`test_*.py`
+
+**CI 探测**：`.github/workflows/` 下 `*.yml|*.yaml` 逐一读文本，命中以下任一 test 步骤模式才算有 CI 测试：`pytest` `vitest` `jest` `npm (run )?test` `pnpm (run )?test` `yarn test` `node --test` `go test` `cargo test` `tox` `unittest`，或 step `name:` 含 `test`。
+
+**已知误判面与逃生口**
+
+- `pyproject.toml` / `setup.py` 存在**不再**视为测试制品（任意现代 Python 仓都有，与有无测试无关）。
+- 纯 lint / 纯部署 workflow（无 test 步骤）不再放行。
+- 探测深度为仓根起 3 层；monorepo 更深层或自定义测试命令（如 `make test`）不命中白名单时，在仓内放任一强信号文件（如 `tests/` 目录、`*_test.py`）即可。
+- **WARN 过渡已硬化（1.5.0）**：1.3.0–1.4.0 期间「新探测失败但旧启发式通过 → `D5: WARN 过渡` exit 0 不阻塞」的过渡分支已删除；自 1.5.0 起上述情形一律 **FAIL**（verify BLOCKED / audit FAIL，exit 2）。升级前请在仓内补真实测试制品（如 `tests/`、`*_test.py`、`*.test.ts` 或含 test 步骤的 CI）。
+
+
+### P0 门禁退出码（failClosed · F2 / 1.x MVP）
+
+| 退出码 | 含义 | 典型命令 |
+|--------|------|----------|
+| **0** | 通过 / 仅信息 | `check` **恒为** 0（只给版本建议） |
+| **1** | 用法错误或非阻断失败 | 缺必填旗标、未知参数 |
+| **2** | **门禁阻断** — failClosed，不得放行 | `verify` / `gate-check` / `audit` 的 P0 失败；`test_strategy=required` 时 D5 无测试制品 |
+
+**failClosed**：P0 门禁失败一律 **exit 2**。CI / Agent 须把 2 当硬停（与 Claude Code hook「退出码 2 阻断」同族）。禁止在本地把 2 改映射成 0 以求「继续跑」。
+
+**分层强制（文档级 · 1.x 不引入云/远程策略引擎）**：
+
+1. 消费者仓库内的机械门禁结论（`verify` / `gate-check` / `audit` 的 exit 2）优先于「本地习惯跳过门禁」。  
+2. task 表 `HG-AUDIT-R1=approved` 之后，hat 30 才可改码。  
+3. kit P0 **不依赖**宿主 hooks——判定在进程内 CLI 完成。
+
+
+## 从 @cyning/harness 迁移
+
+完整清单、F4 方案 B 布局与 **已公布** EOS / deprecate 日历：见 [`MIGRATION.md`](./MIGRATION.md)。
+
+钉 **spec-wave@2.1.1** 后可去掉 `@cyning/harness`。最小路径三步（必须，按序）：
+
+1. 把 `devDependency` `@cyning/harness` 换成 `spec-wave`（钉 `2.1.1`；曾用名 `dsh-coding-kit`）。
+2. 在仓根执行 `npx spec-wave upgrade --yes`（读优先 `.coding-kit/manifest.json`，否则 legacy `.cyning-harness/manifest.json`；**写入** `.coding-kit/manifest.json`，`version` 钉 2.1.1，`from_version` 记旧号；**不删除** `.cyning-harness/`）。
+3. CI / 脚本里把 `npx @cyning/harness` / `npx dsh-coding-kit` 换成 `npx spec-wave`。
+
+**布局**：过程落盘现行根为 **`.coding-kit/`**；`.cyning-harness/` 为 **legacy 只读**。勿再把 `.cyning-harness` 当新标准目录。
+
+Skill 安装为 **推荐、非必须**（最小路径不依赖 DSH 扫 skill）。命令一律 `npx spec-wave`。旧包 **`@cyning/harness` 已在 npm deprecate**（2026-09-10 · 仅维护者可操作）；请钉 **`spec-wave@2.1.1`** 并按 `MIGRATION.md` 迁移。
+
+### FAQ · pnpm peer
+
+若 pnpm 安装仍因 peer 链失败（例如解析到未公开发布的宿主包）：在仓根设 `auto-install-peers=false`（或单次 `pnpm add -D spec-wave --config.auto-install-peers=false`）。即使 **1.2.2** 已将 cordis / dsh-tools 标为 optional，也建议保留此兜底。
+
+### 可复制 Prompt（给存量仓 Agent）
+
+整段粘贴：
+
+````text
+你 = 本仓库维护 Agent。把本仓从 @cyning/harness 迁到 spec-wave@2.1.1。
+
+最小路径（必须，按序）：
+1. package.json 的 devDependency：删除 @cyning/harness，改为 spec-wave（钉 2.1.1；曾用名 dsh-coding-kit）。
+2. 在仓根执行：npx spec-wave upgrade --yes
+   （读 .coding-kit/manifest.json 或 legacy .cyning-harness/manifest.json；写入 .coding-kit/manifest.json；version 钉 2.1.1，from_version 记旧号；不删除 .cyning-harness/；不覆盖 docs/tasks、reviews、invokes/by-task。）
+3. CI 与脚本里所有 npx @cyning/harness 与 npx dsh-coding-kit 换成 npx spec-wave。
+命令一律 npx spec-wave。禁止再写 npx @cyning/harness skills build。
+布局与 EOS 日历见 MIGRATION.md（人闸未批前不得宣称已 deprecate）。
+
+推荐（非必须 · Skill 安装）：
+- 仓内：npx spec-wave skills install
+  复制 npm 包内已生成 skills（默认不含 30/40）到本仓 .dsh/skills。已有文件默认不覆盖；要覆盖才加 --force。
+- 用户级：npx spec-wave skills install --global
+  写到 $HOME/.dsh/skills（展开 HOME；不要把 ~ 当成相对路径）。
+
+路径对照（禁止混用）：
+- .dsh/skills 或 $HOME/.dsh/skills = Skill 安装落点（本命令）。
+- .claude/skills 或 ~/.claude/skills = Claude Code 的 skill 目录（本命令默认不写；若你用 Claude 可另拷或 --out）。
+- .dsh/coding-kit 或 .coding-kit = 规范覆盖（apply_coding_standards / init_coding_kit），不是 skill 目录。
+
+已验证（对照 DSH 上游源码）：DSH runtime 自动扫描本仓 .dsh/skills 与 $HOME/.dsh/skills 并按需加载。skill 形态为 <name>/SKILL.md 目录包或 <name>.md 平铺文件，frontmatter 必填 name/description；证据锚点见 README「扫描验证」节。
+
+不要做：GitHub Archive；npm publish / deprecate；让 apply 在加载时自动注入；默认安装 30/40；把 skills 拷进 .dsh/coding-kit。
+````
+
+### 路径对照
+
+| 路径 | 用途 | 谁写入 |
+|------|------|--------|
+| 产品包 `assets/skills` | 生成物真值；`skills check` 对照根 | 维护者 `skills build`（G5 freeze） |
+| `<repo>/.dsh/skills` | 消费者 Skill **安装落点** | `skills install` |
+| `$HOME/.dsh/skills` | 用户级安装落点 | `skills install --global` |
+| `<repo>/.claude/skills` 或 `~/.claude/skills` | Claude Code skill 目录 | 用户另拷或 `--out`；**默认不写** |
+| `<repo>/.dsh/coding-kit` 或 `.coding-kit` | 规范覆盖（standards / wiki） | `init_coding_kit`；**禁止**当作 skill dest |
+
+### 扫描验证（已对照 DSH 上游源码）
+
+**已验证（2026-08-22 · 对照 DSH 上游源码 deepseek-harness@141eb6f，即 dsh 0.1.0-rc.8）**：DSH runtime **会自动扫描** `<repo>/.dsh/skills` 与 `$HOME/.dsh/skills` 并 **按需加载**，二者正是本包 `skills install` 的两个 **安装落点**。证据锚点：
+
+- `packages/skill/skill-filesystem/src/index.ts:246` —— 扫描 `<projectRoot>/.dsh/skills`（source=`project-dsh`，rank 100）；同文件 `:253` —— 扫描 `<dshHome>/skills`（`$DSH_HOME` 或 `~/.dsh`，source=`user-dsh`，rank 400）。
+- `docs/subsystems/skills.md`「Local discovery priority」表同口径（rank 100/400 两行）；加载机制：skill 摘要注入会话 catalog，模型经 `skill({ name })` 工具按需拉取正文（该文档「Session catalog and tool contract」节）。
+
+结构与 frontmatter 要求（同源码）：目录包 `<name>/SKILL.md` 或平铺 `<name>.md`（index.ts:724-728）；frontmatter 必填 `name`/`description`，`name` 须 kebab-case（index.ts:810-816）；projectRoot = 最近含 `.git` 的祖先目录（index.ts:937-947）。
+
+注意：扫描/加载是 **DSH runtime 的行为契约**，随上游版本演进；以上锚点对应 0.1.0-rc.8。本包职责止于把 skill 写入正确落点并保持 frontmatter 合法（`skills check`）。
+
+## Host 使用 coding-kit（沟通 Agent / 产品 Chat）
+
+Skills **不能**覆盖全部过程能力。Host 要嵌套 Harness 过程，须同时具备：Process Kernel 对象 + CLI Capability + PromptAssembly 槽，而不是只拷 Skills。
+
+推荐 Capability 白名单（**须走 Policy / H2**：默认关 · Host env 显式授权 · 禁止任意 shell）：
+
+- `npx --yes spec-wave@<pin> verify …`
+- `npx --yes spec-wave@<pin> task …`
+
+| 能力 | Skills 能否覆盖 |
+|------|----------------|
+| 10/20 审过程指引 | 能（默认分发） |
+| 00 委派纪律 | 弱：全文不进默认；delegate-only 短 Skill 可默认装 |
+| 30/40 执行 | 弱：不进默认（T1 前）；且执行仍须 `verify` |
+| 闸 / pre-30 / may_start_30 | **否**：须 CLI `verify`（或 Host 封装同一 CLI） |
+| 帽身份常驻 system | **否**：Skills 为 on-demand，非 system |
+| Host 业务答题 | **否**：属产品 Prompt Pack |
+
+三分：**System/Re-anchor** = 短身份；**prompts 全文** = 换帽加载；**verify** = 机械。不可互替。
+
+## 发版（维护者）
+
+**现行包**：**`spec-wave@2.1.1`** — **npm `latest=2.1.1`**（2026-09-10 · 人 publish · tag `v2.1.1`）。前一发版：**2.1.0**（技能/编排）。
+
+发布流程见 [RELEASING.md](RELEASING.md) —— publish 前硬步骤 checklist（先 commit 后 publish · 四门全绿 · 版本钉同步 · **Agent 可 bump/tag** · **`npm publish` 仅人**；DEF-001 教训制度化）。
+
+## GitHub topic
+
+本仓库当前 GitHub topics：**`dsh-plugin`**（DSH 官方发现机制 tag，见上游 deepseek-harness `README.md` 与 `CONTRIBUTING.md`；无应用商店）、**`deepseek-harness`**、**`dsh-plugins`**、**`dsh`**。`package.json` 的 npm keywords 同样含 `dsh-plugin` 与 `deepseek-harness`。
+
+## License
+
+MIT

package/RELEASING.md

@@ -0,0 +1,52 @@
+# RELEASING · SpecGate（`spec-wave`）发版硬步骤 Checklist
+
+> **制度化来源**：DEF-001 教训 —— 曾从未提交工作树 publish，导致发布物与仓库真值漂移、无法溯源。  
+> 本清单把「publish 前 commit + tag」固化为**硬步骤**：任何一步未完成即停止，不得跳步。  
+> **职责分工（2026-09-09 起）**：**维护 Agent 可执行 ①–⑦ 与 bump/tag**；**⑧ `npm publish` 仅人**；⑨ 可由 Agent 在人 publish 后核验（或人自核）。  
+> **仍仅人**：`npm publish` · `npm deprecate`（另须 `HG-EOS-DATE`）· 云/账号 2FA 操作。  
+> **包名**：现行 **`spec-wave`**（曾用名 `dsh-coding-kit`；曾拟裸 `specgate` 遭 E403 相似拒）。
+
+## 最近一次发版
+
+| 项 | 值 |
+|----|-----|
+| **npm `latest`（旧包名）** | **`dsh-coding-kit@2.1.1`**（2026-09-10 · 人 publish · **仍 published** 直至 deprecate） |
+| **preparing（新包名）** | **`spec-wave@2.1.1` first publish**（仓内 name 已切；**尚未** `npm publish` · `HG-PUBLISH` pending · 仅人） |
+| **git** | tag **`v2.1.1`** · commit `cc61324`（能力线同版；改名不 bump） |
+| **主题（已发）** | patch：host tools 粘性 · update 缺省 A · `init --tools`（对齐 OpenSpec） |
+| **主题（准备中）** | SpecGate 改名：包身份 `spec-wave` · 三 bin · 文档/GitHub 已切 · W4 仅人 publish + deprecate 旧 `dsh-coding-kit` |
+| **前一发版** | **`2.1.0`**（多平台 Skills + Commands · published as `dsh-coding-kit`） |
+| **更早旧包** | `@cyning/harness` **已 deprecate**（2026-09-10 · registry 文案曾钉 `dsh-coding-kit@1.12.0`） |
+| **1.x** | **CLOSED**（见 `docs/roadmap/AUDIT_1x_residual_after_1_12_1_zh.md`） |
+| **下一主线** | SpecGate W4 发版后 · **2.1.x+ / 2.2**（workspaces / onboard 等观察项；另闸） |
+| **验收（2.1.1 UX）** | [`docs/roadmap/ACCEPTANCE_2_1_1_host_tools_ux_2_1_1_zh.md`](docs/roadmap/ACCEPTANCE_2_1_1_host_tools_ux_2_1_1_zh.md) |
+| **验收（改名 · 准备档）** | [`docs/roadmap/ACCEPTANCE_rename_specgate_2_1_1_zh.md`](docs/roadmap/ACCEPTANCE_rename_specgate_2_1_1_zh.md) |
+
+### 前一发版（2.0.x–2.1.0）
+
+1. `2.0.0` / `2.0.1` / `2.0.2` 已 npm 发版（人 · 2026-09-10）  
+2. `2.1.0` 多平台技能+编排（registry 曾为 `latest=2.1.0`）  
+3. `2.1.1` host tools UX（checklist ⑨ 已核 · registry `latest=2.1.1`）
+
+> 下方 checklist 供下一次发版勾选；勿永久勾死。
+
+## 硬步骤（按序执行 · 全部满足后方可 publish）
+
+- [ ] **① 工作树干净且所有改动已提交**：`git status --porcelain` 为空；拟发布内容全部进入 git 历史。**禁止从未提交工作树 publish**（DEF-001 教训：工作树残留 = 发布物不可溯源）。（Agent 可做）
+- [ ] **② 质量闸门全绿**：`npm run typecheck && npm test && npm run build && npm run test:lib` 依次全绿（与 `prepublishOnly` 同一四门；任一红即停止，先修再发）。（Agent 可做）
+- [ ] **③ CHANGELOG 版本节已归拢**：`CHANGELOG.md` 的 `## [Unreleased]` 内容已归入 `## [X.Y.Z] - YYYY-MM-DD` 版本节（日期 + 版本号齐全），无残留 Unreleased 条目遗漏。（Agent 可做）
+- [ ] **④ 版本钉（pins）已同步（F5 方案 B）**：新版本号已同步全部**现行钉点** —— `assets/ontology.yaml#product_semver`、`assets/harness/discipline-coverage.yaml#as_of_package_version`、README 双文件中的 `spec-wave@x.y.z`、以及含版本断言的测试。闸测：`test/version-pins-f5.test.ts`（及既有 ontology / discipline 分面测）。**仓根 `SPEC.md` 为 archived epic，不要求与包版本对齐，禁止再把其标题当作现行契约。**（Agent 可做）
+- [ ] **⑤ npm version + tag（Agent 默认可做）**：`npm version <patch|minor|major>`（或等价：改 `package.json` + 钉点同步后落 version commit + `vX.Y.Z` tag）；确认 tag 与 CHANGELOG 版本节一致。**禁止**在钉点未同步时 bump。
+- [ ] **⑥ PR 合并 + CI 绿**：发版 PR 已 merge 进 `main` 且 CI 全绿（**CI 未绿禁合**）；`git push` 含 `--follow-tags`（或单独 push tag），远端 main 与 tag 指向发布真值。（Agent 可推送，须用户/环境授权）
+- [ ] **⑦ npm pack --dry-run 检查**：`npm pack --dry-run` 逐行核对 tarball 清单 —— 无 `test/` 泄漏、无工作区/私仓文件；仅 `package.json#files` 白名单（`bin` / `lib` / `assets` / `cordis.patch.yml` / `README.md` / `LICENSE`）内的内容入包。（Agent 可做）
+- [ ] **⑧ npm publish（仅人）**：`npm publish`（`prepublishOnly` 会自动重跑②四门；⑦已核对清单）。**Agent 不得执行本步。**
+- [ ] **⑨ publish 后核验 + 过程档状态更新**：`npm view spec-wave version`（及 `dist-tags`）确认新版本已生效；抽样验证；更新过程档状态为已发布。（人 publish 后 · Agent 可代核）
+
+## 禁令速查
+
+- **禁止从未提交工作树 publish**（① · DEF-001）。
+- **CI 未绿禁合**（⑥ · 合并前 CI 必须全绿）。
+- **Agent 禁止 `npm publish`**（⑧ 仅人）。**Agent 允许 `npm version` / tag / 钉点同步**（⑤ · 须先过 ①–④）。
+- **Agent 禁止 `npm deprecate`**（另闸 `HG-EOS-DATE`）。
+- `npm pack --dry-run` 清单异常（`test/` 泄漏、白名单外文件）→ 停止发版，先修 `files` 白名单或 .npmignore 口径（⑦）。
+- **CI 不得自动 `npm publish`**（与 Agent 同禁；registry 凭证仅人侧）。

package/assets/README.md

@@ -0,0 +1,30 @@
+# assets · 资产地图
+
+本目录是从旧仓 `cyning-harness` 按白名单复制的 **P0 模板资产**。目录名 `assets/harness/` 仅保留历史路径，对外产品名是 **coding-kit / ICVO / SDD**，不是 “harness”。
+
+`apply_coding_standards`（T2）默认只读 `standards/` 与 `coding_wiki/`。其余目录供 `init_coding_kit` 整树复制，给人与 IDE `@` 使用，不全部灌进 prompt。
+
+## 旧路径对照
+
+| 旧路径（相对 `cyning-harness/`） | 本仓路径 | 用途 |
+|----------------------------------|----------|------|
+| `coding_wiki/` | `assets/coding_wiki/` | Inform：LLM 读序模板 |
+| `standards/` | `assets/standards/` | Constrain：L1/L2 编码规范模板 |
+| `graph/` | `assets/graph/` | Inform：图谱模板 |
+| `harness/` | `assets/harness/` | Orchestrate：过程/帽模板（历史目录名） |
+| `ci/` | `assets/ci/` | Verify：CI 样例 |
+| `ide/` | `assets/ide/` | IDE 入口片段 |
+| `skills/` | `assets/skills/` | Agent Skills 封装 |
+| `ontology.yaml` | `assets/ontology.yaml` | ICVO 机器可读抽取 |
+| `LICENSE` | 仓根 `LICENSE` | MIT · Copyright (c) 2026 Cyning |
+
+## 明确不在本目录
+
+| 旧路径 | 原因 |
+|--------|------|
+| `bin/` `lib/` | CLI 运行时，不属 1.0.0 |
+| `wizard/*.sh` | CLI 安装器 |
+| `eval/` `examples/` `golden/` | 评测夹具，P1 |
+| `node_modules/` | 依赖，禁止拷入 |
+
+过程轨（SPEC / task / invoke / reviews）在工作区 `docs/dsh_coding_kit_init/`，不进本仓。

package/assets/ci/samples/README.md

@@ -0,0 +1,76 @@
+# ci/samples · Verify 轨
+
+复制并改写为用户仓 **`.github/workflows/`** workflow。
+
+## v0.1 已交付（T4 · M2）
+
+| 样例 | 状态 | 适用栈 | 三门禁 / 说明 |
+|------|------|--------|----------------|
+| [`quality.yml.example`](./quality.yml.example) | ✅ | Node/TS · Next 等 | install → lint → test → build |
+| [`pytest.yml.example`](./pytest.yml.example) | ✅ | Python · FastAPI 等 | install → pytest |
+| [`tech-graph.yml.example`](./tech-graph.yml.example) | ✅ · **可选** | 已接入 `docs/_tech_graph` + `scripts/graph-compile.sh` | graph compile（业务仓自备脚本）。kit **自身**用源码仓 `.github/workflows/tech-graph.yml` + 本仓 bin compile/check，不走本样例脚本 |
+| [`hgm-ingest.yml.example`](./hgm-ingest.yml.example) | ✅ · **可选** | 任意已接入 Harness 的仓 | `graph ingest`（默认 continue-on-error） |
+| [`lint-wiki-delta.yml.example`](./lint-wiki-delta.yml.example) | ✅ · **可选** | ≥2.18 须有 `wiki_delta` 的仓 | 默认硬失败；注释含 `--strict` / 读 pin |
+| [`lint-wiki-delta.pin.yml.example`](./lint-wiki-delta.pin.yml.example) | ✅ · **可选** | 有 `harness.pin.json` 的仓 | 从 pin 解析版本再 `npx`（F-220-02） |
+
+## 嵌入步骤
+
+    mkdir -p .github/workflows
+    cp cyning-harness/ci/samples/quality.yml.example .github/workflows/quality.yml
+    # 或
+    cp cyning-harness/ci/samples/pytest.yml.example .github/workflows/pytest.yml
+    # 图谱编译（可选 · 须自备 graph-compile.sh）
+    cp cyning-harness/ci/samples/tech-graph.yml.example .github/workflows/tech-graph.yml
+    # 过程可观测（可选 · 非三门禁必绿）
+    cp cyning-harness/ci/samples/hgm-ingest.yml.example .github/workflows/hgm-ingest.yml
+    # wiki_delta（可选）
+    cp cyning-harness/ci/samples/lint-wiki-delta.yml.example .github/workflows/lint-wiki-delta.yml
+    # 有 pin：
+    # cp cyning-harness/ci/samples/lint-wiki-delta.pin.yml.example .github/workflows/lint-wiki-delta.yml
+
+无 monorepo checkout 时：见薄指针页 [`POINTER_RUNBOOK_wiki_delta.md`](../../docs/POINTER_RUNBOOK_wiki_delta.md)（原文不随包发布 · §5.1 `npm pack` / GitHub raw）。
+
+按 `package.json` / `requirements.txt` / Node 版本 / env 变量 **裁剪注释块**。
+
+## 摩擦 / 坑 · setup-node × packageManager(pnpm) × npx-only
+
+`actions/setup-node@v5` 默认会按 `package.json` 的 `packageManager` 开 **package-manager-cache**。若字段为 `pnpm@…`，但本 job **只装 Node、用 npx / 不跑 pnpm install**（未先 `pnpm/action-setup`），则会红：
+
+    Unable to locate executable file: pnpm
+
+| Job 类型 | 正确做法 |
+|----------|----------|
+| **npx-only**（`tech-graph` / `hgm-ingest` / `lint-wiki-delta` 等） | `setup-node` 显式 `package-manager-cache: false` |
+| **Python / 无 package.json**（FastAPI 等） | **同样**必须 `package-manager-cache: false`（防日后加 `packageManager` 踩坑；ops dogfood） |
+| **质量三门禁**（`quality.yml.example`） | 先 `pnpm/action-setup`，再 `setup-node` 且 `cache: pnpm` |
+
+不要把 npx-only 样例抄成「开了 cache 却没装 pnpm」。
+
+## 金样 POINTER（Ink · 只读对照）
+
+| 栈 | 路径（工作区） |
+|----|----------------|
+| 前端 | `ai-ink-brain/.github/workflows/quality.yml` |
+| 后端 | `ai-ink-brain-api-python/.github/workflows/pytest.yml` |
+| 图谱 | `ai-ink-brain-api-python/.github/workflows/tech-graph.yml`（业务专有；Starter 为最小 compile 样例） |
+
+Ink workflow 含图谱 export、跨仓 checkout 等 **业务专有** 步骤；Starter 样例为 **最小三门禁 / 最小 compile**，按需从金样增量合并。
+
+## 与 Harness 关系
+
+- task `test_strategy: required` → 本地/CI 须与 workflow 命令一致
+- L2 模板 CI 对齐节：[`standards/TEMPLATE_CODING_BASELINE_L2_*.md`](../../standards/)
+- ONBOARDING §5：五轨检查清单含 CI 样例已适配
+- **不**把 tech-graph / pre-commit hook 绑进 `init` 默认拷贝；按需从本目录 `cp`
+
+## 修订记录
+
+| 日期 | 说明 |
+|------|------|
+| 2026-08-28 | `tech-graph.yml.example` 行旁注：kit 自身 workflow 为源码仓 `.github/workflows/tech-graph.yml`（本仓 bin）；样例仍给自备 `graph-compile.sh` 的业务仓 |
+| 2026-07-28 | `lint-wiki-delta.pin.yml.example` · 样例矩阵 / Python 交叉链（v2.21 · web+ops FEEDBACK） |
+| 2026-07-28 | `lint-wiki-delta` 样例注明：迁完再硬失败；可选 `--strict`（v2.20） |
+| 2026-07-28 | 增 `lint-wiki-delta.yml.example`（升级扫迁 · v2.19.1） |
+| 2026-07-27 | 增 `tech-graph.yml.example`；`hgm-ingest` 补 `package-manager-cache: false`；专节摩擦说明 |
+| 2026-07-27 | 增 `hgm-ingest.yml.example`（过程可观测 P2 · 可选） |
+| 2026-06-09 | T4 M2 首版样例 |

package/assets/ci/samples/hgm-ingest.yml.example

@@ -0,0 +1,42 @@
+# Optional · HGM graph ingest（过程可观测 · 非默认必绿）
+#
+# 用途：复制为 .github/workflows/hgm-ingest.yml（或并入既有 workflow 的一步）。
+# 失败策略：continue-on-error: true（样例默认）· 需要硬闸时改为 false。
+#
+# 与 status --check / timeline 配合：保证 events JSONL 较新，便于过程投影。
+
+name: hgm-ingest
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  ingest:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      # npx-only：关闭 setup-node@v5 默认 packageManager 缓存
+      # （package.json 若声明 packageManager=pnpm 且未装 pnpm → Unable to locate executable file: pnpm）
+      - name: Setup Node
+        uses: actions/setup-node@v5
+        with:
+          node-version: "24"
+          package-manager-cache: false
+
+      - name: graph ingest（幂等）
+        continue-on-error: true
+        run: npx --yes spec-wave graph ingest --target .
+
+      # 可选：过程闸（须业务仓有 active task 路径）
+      # - name: status --check
+      #   continue-on-error: true
+      #   run: |
+      #     npx --yes spec-wave status --target . \
+      #       --task docs/harness/tasks/active/task_xxx.md --check

package/assets/ci/samples/lint-wiki-delta.pin.yml.example

@@ -0,0 +1,47 @@
+# Optional · wiki_delta 扫描 · 读 harness.pin.json（消费者自管 pin · v2.21+）
+# 【旧机制示例】旧包 @cyning/harness 已弃用，现行为 dsh-coding-kit；本文件仅为旧包 pin 流程存档，
+# 本包未接线 harness.pin.json 读取，现行样例见 lint-wiki-delta.yml.example。
+#
+# 适用：仓根有 harness.pin.json（或等价单源版本文件，须改 jq/node 取值）。
+# 对比：lint-wiki-delta.yml.example 曾写死 @cyning/harness@2.21（旧包，已弃用，现行为 dsh-coding-kit）。
+# 获取：同 RUNBOOK §5.1（clone / npm pack / raw）。
+#
+# Python / npx-only：package-manager-cache: false（见 ci/samples/README）
+
+name: lint-wiki-delta
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  lint-wiki-delta:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Node
+        uses: actions/setup-node@v5
+        with:
+          node-version: "24"
+          package-manager-cache: false
+
+      - name: Resolve pin
+        id: pin
+        run: echo "version=$(node -p "require('./harness.pin.json').version")" >> "$GITHUB_OUTPUT"
+
+      # 可选：本仓若有 check-harness-pin 脚本，在此先跑
+      # - name: check-harness-pin
+      #   run: node scripts/check-harness-pin.mjs
+
+      - name: task lint-wiki-delta
+        run: npx --yes "@cyning/harness@${{ steps.pin.outputs.version }}" task lint-wiki-delta --target .
+
+      # 可选 · 迁完后关账预检（半迁勿开）
+      # - name: task lint-wiki-delta --strict
+      #   run: npx --yes "@cyning/harness@${{ steps.pin.outputs.version }}" task lint-wiki-delta --target . --strict

package/assets/ci/samples/lint-wiki-delta.yml.example

@@ -0,0 +1,49 @@
+# Optional · wiki_delta 扫描（默认硬失败 · v2.19+）
+#
+# 获取本文件：见薄指针页 assets/docs/POINTER_RUNBOOK_wiki_delta.md（原文不随包发布）§5.1（clone / npm pack / GitHub raw）
+# 失败策略：迁移中 continue-on-error: true；迁完硬失败；--strict 半迁勿开。
+# Python / 无 package.json：必须 package-manager-cache: false（见 ci/samples/README）
+# 有 harness.pin.json：改用 lint-wiki-delta.pin.yml.example，或按下方「读 pin」注释改写。
+
+name: lint-wiki-delta
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  lint-wiki-delta:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Node
+        uses: actions/setup-node@v5
+        with:
+          node-version: "24"
+          package-manager-cache: false
+
+      - name: task lint-wiki-delta
+        # 迁移中可改为 continue-on-error: true
+        # 本地预检（30/40 自检与本 CI 对齐 · verify 已并入本检查，BLOCKED 时打印同一复跑命令）：
+        #   npx spec-wave verify --task <task.md> --with-wiki-lint
+        run: npx --yes spec-wave task lint-wiki-delta --target .
+
+      # 可选矩阵 B · 关账预检（迁完字段后再开；半迁勿开）
+      # - name: task lint-wiki-delta --strict
+      #   run: npx --yes spec-wave task lint-wiki-delta --target . --strict
+
+      # 可选：仅扫 active
+      # - name: lint-wiki-delta · active only
+      #   run: npx --yes spec-wave task lint-wiki-delta --target . --scope active
+
+      # 可选 · 读 pin【旧机制示例：旧包 @cyning/harness 已弃用，现行为 dsh-coding-kit；harness.pin.json 为旧包 pin 流程，本包未接线】：
+      # - name: lint from pin
+      #   run: |
+      #     PIN=$(node -p "require('./harness.pin.json').version")
+      #     npx --yes "@cyning/harness@${PIN}" task lint-wiki-delta --target .