w2.0: plan doc closure — catalog relocation + CI/prompt audit + W2 task expansion

Add W2.0a/W2.0b/W2.2b/W2.3b/W2.3c pre-flight tasks before runtime deletion.
New §9b in design.md: catalog relocation decision, payload resource positioning,
file migration table, field cleanup (runtime_entry/entry_kind/supports_routes).
Update §9 keep-list/migration-list and §14 risk table with 3 new risks.

Author: Li-Sanze

.sopify-skills/plan/20260605_p8_protocol_kernel_runtime_retirement/design.md

@@ -552,6 +552,8 @@ P8 里的 CLI 不是新 runtime，只是少量辅助入口：
 | `sopify_writer/`（由 P6 writer 基础收敛/重命名） | 新真相源，新宿主唯一写路径 |
 | `sopify_contracts/`（P6 已切出） | contract schema 定义 |
 | `scripts/install_sopify.py` / `sopify_init.py`（解耦后） | 用户入口 |
+| `skills/catalog/`（由 W2.0b 从 `runtime/builtin_skill_packages/` 迁入） | builtin skill YAML 源 + generated JSON；payload resource（§9b） |
+| `sopify_contracts/skill_schema.py`（由 W2.0b 从 `runtime/skill_schema.py` 迁入） | skill.yaml schema 校验与常量定义 |
 
 **Delete-list（激进删除）**：
 
@@ -569,13 +571,70 @@ P8 里的 CLI 不是新 runtime，只是少量辅助入口：
 - `scripts/sopify_status.py` / `sopify_doctor.py` → 改为消费 `installer/inspection.py` 暴露的 contract，不调 runtime API
 - `tests/` 中 runtime-coupled 测试 → 按 Phase 1 经验分类：保留 contract / 删除 runtime-coupled / 迁移到 sopify_writer 测试
 - `canonical_writer` → `sopify_writer`（命名收敛），并与 sopify_contracts 适配 state/ 新结构（2 文件）
+- `runtime/builtin_skill_packages/` → `skills/catalog/`（YAML 源 + generated JSON；扁平路径，详见 §9b）
+- `runtime/skill_schema.py` → `sopify_contracts/skill_schema.py`（保留旧名）
+- `runtime/_yaml.py`（`load_yaml` 子集）→ `scripts/_yaml_subset.py`（裁剪迁移，不含 dump/写逻辑）
+- `scripts/generate-builtin-catalog.py` → runtime-free import + 新输入/输出路径（详见 §9b）
+- `.github/workflows/ci.yml` → restructure `runtime-tests` job 为 `protocol-tests` job（W2.3b）
+- `.github/copilot-instructions.md` → runtime-first 措辞替换为 protocol-first 入口（W2.3c）
 
 **目标 LOC**：
 
 - 起点：runtime ~16K LOC
 - 终点：runtime 0 + sopify_writer + sopify_contracts ~1,160 + installer（保留部分 ~2K）
 - 净效果：Sopify 真相源从 ~16K runtime 切换到 ~4K protocol+writer+installer
 
+## 9b. Catalog Relocation Decision（W2.0b）
+
+**背景**：`runtime/` 物理删除时会带走 builtin skill catalog 的 YAML 源、生成产物和 schema 校验器。catalog 链路必须在 W2.10 之前独立迁出，否则 CI drift check、header template 引用和 host 安装链一起断裂。
+
+**Catalog post-P8 定位**：**payload resource**（选项 B）
+
+- 安装时把 generated JSON 拷贝进 host payload
+- `payload-manifest.json` 记录 catalog 路径
+- `sopify_doctor` 可检查 catalog 存在性
+- 不做动态路由、不做 runtime loader、不让 host 每轮解析
+- catalog 是"安装包随身带的说明书目录"，host/doctor 可以看它知道有哪些内置工作流，但它不指挥执行
+
+**文件迁移表**：
+
+| 源 | 目标 | 动作 |
+|---|---|---|
+| `runtime/builtin_skill_packages/*/skill.yaml` | `skills/catalog/<skill_id>/skill.yaml` | 迁移（扁平路径，去掉 `builtin_skill_packages/` 中间层） |
+| `runtime/builtin_catalog.generated.json` | `skills/catalog/builtin_catalog.generated.json` | 迁移 |
+| `runtime/skill_schema.py` | `sopify_contracts/skill_schema.py` | 迁移（保留旧名，不改为 `skill_manifest.py`） |
+| `runtime/_yaml.py`（`load_yaml` 子集） | `scripts/_yaml_subset.py` | 裁剪迁移（不含 `dump_yaml` / 写逻辑） |
+| `runtime/builtin_catalog.py` | — | 不迁移，随 runtime 退场（唯一消费者 `manifest.py` 同步退场） |
+| `runtime/manifest.py` | — | 不迁移，随 runtime 退场 |
+
+**字段清理**：从 skill schema normalizer（`normalize_skill_manifest`）和 generated JSON 删除以下 runtime 残留字段：
+
+- `runtime_entry`：runtime 入口路径，P8 后无 runtime
+- `entry_kind`：runtime entry 分类，P8 后无意义
+- `supports_routes`：runtime router 的路由分类概念，P8 后退场
+
+保留字段：`id` / `names` / `descriptions` / `mode` / `handoff_kind` / `contract_version` / `triggers` / `tools` / `disallowed_tools` / `allowed_paths` / `requires_network` / `host_support` / `permission_mode` / `metadata`
+
+**Post-P8 消费链**：
+
+```
+skills/catalog/<skill_id>/skill.yaml
+  → scripts/generate-builtin-catalog.py（runtime-free imports）
+  → skills/catalog/builtin_catalog.generated.json
+  → CI drift check + header template 引用
+  → installer/payload.py 拷贝到 payload（W2.2b）
+  → payload-manifest.json 记录路径
+  → sopify_doctor 检查存在性
+```
+
+**命名决策记录**：
+
+| 决策 | 结论 | 理由 |
+|---|---|---|
+| normalizer 命名 | 保留 `skill_schema.py` | 模块定义 schema 常量（版本、模式、权限），不只校验源 manifest；`skill_manifest.py` 与 `payload-manifest.json` / `bundle manifest` 歧义 |
+| YAML helper 位置 | `scripts/_yaml_subset.py` | 只是生成脚本工具，不污染协议包；只保留 `load_yaml`，不迁移 registry 用的 dump/写逻辑 |
+| catalog YAML 路径 | `skills/catalog/<skill_id>/skill.yaml` | 扁平化，与 `skills/<lang>/skills/sopify/<skill_id>/SKILL.md` 命名习惯对齐 |
+
 ## 10. P8 后的 Sopify 形态
 
 P8 收口后，Sopify 是一个**审计资产协议内核 + 文件资产 + 轻量安装器**：
@@ -669,6 +728,9 @@ P8 收口后，Sopify 是一个**审计资产协议内核 + 文件资产 + 轻
 | sopify_writer 未经历真实场景考验 | 中 | W3 Qoder proof 强制走 sopify_writer 写路径，作为硬验收 |
 | Qoder 试点卡在宿主能力限制 | 中 | 基线是 payload + 完整接续读写；若不能直接调库，只允许薄 writer wrapper，不扩大成 runtime CLI |
 | Verifier read-only 约束被绕过 | 中 | P8 只做 schema freeze + compliance；bridge enforcement 后续独立落地 |
+| Catalog 源链断裂（W2.10 删 runtime 时 YAML 源 + generated JSON + schema 校验器一起丢失） | 高 | W2.0b 在 W2.10 前完成迁移到 `skills/catalog/` + `sopify_contracts/skill_schema.py`；CI drift check 路径同步更新 |
+| CI/release-preflight 仍绑 runtime smoke（W2.10 删 runtime 后 CI 直接红） | 高 | W2.3b 在 W2.7 前 restructure CI：删除 runtime-only steps，替换为 protocol smoke，保留 catalog drift + installer smoke |
+| Host prompt / copilot-instructions 仍 runtime-first（dogfood 自相矛盾） | 中 | W2.3c 切 protocol-first 入口；删除不存在的 `go_plan_runtime.py` 引用 |
 
 ## 15. 不在 P8 的延后项（明确登记）
 

.sopify-skills/plan/20260605_p8_protocol_kernel_runtime_retirement/tasks.md

@@ -163,6 +163,31 @@ created: 2026-06-05
 
 目标：硬切到 protocol kernel。线上用户少，不做 shadow writer，不保留 runtime compatibility layer。
 
+### W2.0a Registry Snapshot
+
+- [ ] Depends: W1 gate
+- [ ] Input: `.sopify-skills/plan/_registry.yaml`（当前全部 registry entries，当前预期 4 条）
+- [ ] Output: 导出当前全部 registry entries 为人类可读摘要，存入当前 P8 plan 的 `assets/registry-lifecycle-snapshot.md`（随 P8 归档时一起进 history）
+- [ ] Verify: 快照文件存在于 `assets/` 且包含全部 plan 的 id + lifecycle_state + 关键时间戳
+
+### W2.0b Catalog Relocation + Generator Runtime-Free
+
+- [ ] Depends: W1 gate
+- [ ] Input: `runtime/builtin_skill_packages/*/skill.yaml`（5 个 builtin skill YAML 源）
+- [ ] Input: `runtime/builtin_catalog.generated.json`
+- [ ] Input: `runtime/skill_schema.py` / `runtime/_yaml.py`
+- [ ] Output: 迁移 YAML 源 → `skills/catalog/<skill_id>/skill.yaml`（扁平路径，去掉 `builtin_skill_packages/` 中间层）
+- [ ] Output: 迁移生成产物 → `skills/catalog/builtin_catalog.generated.json`
+- [ ] Output: 迁移 `runtime/skill_schema.py` → `sopify_contracts/skill_schema.py`（保留旧名，不改为 skill_manifest.py）
+- [ ] Output: 创建 `scripts/_yaml_subset.py`：仅 `load_yaml` 最小解析子集，不含 `dump_yaml` / 写逻辑
+- [ ] Output: 改造 `scripts/generate-builtin-catalog.py`：import 改为 `sopify_contracts.skill_schema` + `_yaml_subset`；输入路径改为 `skills/catalog/*/skill.yaml`；输出路径改为 `skills/catalog/builtin_catalog.generated.json`
+- [ ] Output: 从 skill schema normalizer（`normalize_skill_manifest`）和 generated JSON 删除 `runtime_entry` + `entry_kind` + `supports_routes` 字段
+- [ ] Output: 更新 CI drift check 路径（`ci.yml:36` + `scripts/release-preflight.sh:28,70`）
+- [ ] Output: 更新 `skills/{en,zh}/header.md.template:351` 对 generated JSON 路径的引用
+- [ ] Verify: `python3 scripts/generate-builtin-catalog.py` 成功输出 `skills/catalog/builtin_catalog.generated.json`
+- [ ] Verify: generated JSON 不含 `runtime_entry` / `entry_kind` / `supports_routes` 字段
+- [ ] Verify: `rg "from runtime|import runtime" scripts/generate-builtin-catalog.py` returns no matches
+
 ### W2.1 Extract/Keep Minimal CLI Entrypoints
 
 - [ ] Depends: W1 gate
@@ -184,6 +209,16 @@ created: 2026-06-05
 - [ ] Verify: `rg "runtime_gate|sopify_runtime|runtime/" installer scripts/install_sopify.py` has no active dependency except retired docs/tests slated for deletion
 - [ ] Verify: install smoke still installs payload assets
 
+### W2.2b Catalog Payload Resource
+
+- [ ] Depends: W2.2, W2.0b
+- [ ] Input: `skills/catalog/builtin_catalog.generated.json` / `installer/payload.py` / `installer/inspection.py`
+- [ ] Output: `installer/payload.py` 安装时拷贝 `builtin_catalog.generated.json` 到 payload
+- [ ] Output: `payload-manifest.json` 记录 catalog 路径
+- [ ] Output: `sopify_doctor` 检查 catalog 文件存在性
+- [ ] Verify: install smoke 安装后 payload 目录包含 catalog JSON
+- [ ] Verify: `sopify_doctor` 报告 catalog 健康状态
+
 ### W2.3 Rename and Scope sopify_writer
 
 - [ ] Depends: W1 schemas
@@ -195,6 +230,28 @@ created: 2026-06-05
 - [ ] Verify: no new writer CLI is introduced by default
 - [ ] Verify: old `canonical_writer` import path is removed; no compatibility alias by default
 
+### W2.3b CI Runtime Detachment
+
+- [ ] Depends: W2.3, W2.0b
+- [ ] Input: `.github/workflows/ci.yml` / `scripts/release-preflight.sh`
+- [ ] Output: restructure `runtime-tests` job 为 `protocol-tests` job：删除 runtime-only test steps，保留 catalog drift / protocol smoke / installer-payload smoke / 非 runtime 测试
+- [ ] Output: 删除 `check-bundle-smoke.sh` step
+- [ ] Output: 删除 `check-prompt-runtime-gate-smoke.py` step
+- [ ] Output: 替换为 `sopify_protocol_check` smoke（W1.6 已建）
+- [ ] Output: 保留 catalog drift check（路径已更新 by W2.0b）+ installer/payload smoke
+- [ ] Verify: CI pipeline 绿；无 runtime-only test step
+- [ ] Verify: catalog drift check 和 protocol smoke 在 CI 中正常运行
+
+### W2.3c Host Prompt / Copilot Instructions Cutover
+
+- [ ] Depends: W2.3b
+- [ ] Input: `.github/copilot-instructions.md`
+- [ ] Output: 清理 runtime-first 措辞（runtime gate / sopify_runtime 引用）
+- [ ] Output: 删除不存在的 `go_plan_runtime.py` 引用
+- [ ] Output: 替换为 protocol-first 入口（protocol.md + sopify_protocol_check + sopify_writer）
+- [ ] Verify: `rg "runtime_gate|sopify_runtime|go_plan_runtime" .github/copilot-instructions.md` returns no matches
+- [ ] Verify: copilot-instructions.md 不再引用 runtime-first 入口
+
 ### W2.4 Migrate StateStore to 2-File Model
 
 - [ ] Depends: W2.3
@@ -231,7 +288,7 @@ created: 2026-06-05
 
 ### W2.7 Reclassify Tests
 
-- [ ] Depends: W2.1-W2.6
+- [ ] Depends: W2.0b, W2.1-W2.3, W2.2b, W2.3b-W2.3c, W2.4-W2.6
 - [ ] Input: all tests importing runtime
 - [ ] Output: keep protocol / contracts / sopify_writer / installer / compliance tests
 - [ ] Output: delete runtime router/engine/gate/output tests
@@ -259,7 +316,7 @@ created: 2026-06-05
 
 ### W2.10 Delete runtime/ Directory
 
-- [ ] Depends: W2.1-W2.9
+- [ ] Depends: W2.0b, W2.1-W2.3, W2.2b, W2.3b-W2.3c, W2.4-W2.9
 - [ ] Input: `runtime/` all files
 - [ ] Output: delete `runtime/`
 - [ ] Verify: `test ! -d runtime`
@@ -280,7 +337,7 @@ created: 2026-06-05
 
 ### Wave 2 Gate
 
-- [ ] Depends: W2.1-W2.11
+- [ ] Depends: W2.0a-W2.0b, W2.1-W2.3, W2.2b, W2.3b-W2.3c, W2.4-W2.11
 - [ ] Verify: runtime directory absent
 - [ ] Verify: registry absent
 - [ ] Verify: no runtime imports in active code/tests