release-skill 0.5.1 → 0.6.0

package/skills/release-help/SKILL.md

@@ -78,6 +78,45 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" docs refresh --unit <id> \
 | 请求生产发布 | 已有公开版本先调用 `release-prepare --online --production` 观察 bound 基线；人工审阅后再路由 `release-publish` |
 | RELEASE_DOCS_INVALID | 配置或说明源语义非法（重复键、alias、未知字段、版本漂移等）；修正配置或说明源后重新演练 |
 | RELEASE_DOCS_TRANSLATION_MISSING | 配置语种缺失或多余；补齐说明源语种，与 `releaseDocuments.locales` 完全一致，不得回退 |
+
+## Routing Suggestions (§4.3 Quickstart Routing)
+
+对于不清楚如何开始的用户，推荐使用 `release-skill route` 命令进行自动化工作流选择：
+
+```bash
+# 快速分类变更并推荐工作流
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route --root <path> --json
+
+# JSON 输出包含 classification 和 recommendation 字段
+{
+  "classification": {
+    "code": [],
+    "docs": ["README.md"],
+    "config": [],
+    "marketplace": [],
+    "mixed": false
+  },
+  "recommendation": {
+    "workflowKind": "docs-only",
+    "reason": "Pure documentation changes detected...",
+    "firstCommand": "release-docs"
+  }
+}
+```
+
+**可用工作流**:
+- `docs-only`: 纯文档变更（跳过代码类门限）
+- `config-only`: 纯配置变更（schema 验证 + 决策分支）
+- `marketplace-only`: 纯 marketplace 索引变更（条目更新 + snapshot 同步）
+- `full-happy-end`: 混合变更或无法确定（fail-closed 到最安全路径）
+- `reconcile`: 存在 PARTIAL 运行时需先恢复
+- `help`: 无变更且未指定目标版本
+
+参考文档：
+- [`release-docs`](../release-docs/SKILL.md) - 文档工作流详解
+- [`release-config`](../release-config/SKILL.md) - 配置工作流详解
+- [`release-marketplace`](../release-marketplace/SKILL.md) - Marketplace 工作流详解
+
 | RELEASE_DOCS_CONFLICT | 目标含非受管同版本条目、受管标记损坏或人工冲突；人工修复目标并保留人工修改后重新演练 |
 | RELEASE_DOCS_REFRESH_STALE | 确认绑定后候选已变化；重新演练取得新 `refreshDigest` 再确认写入 |
 | RELEASE_DOCS_STALE | prepare 检测到文档未刷新；按 `docs refresh` → 审阅 → 提交 → 重新 prepare 恢复 |

package/skills/release-marketplace/SKILL.md

@@ -0,0 +1,147 @@
+---
+name: release-marketplace
+description: "Marketplace-only workflow profile: route confirms marketplace-only diff (plugins.mjs/public-snapshot), update plugins.mjs entry (manual review), regenerate public-snapshot via workspace generator, prepare --workflow marketplace (code-class gates trimmed), then delegate publish to the target workspace's own marketplace release skill"
+---
+
+# release-marketplace
+
+## 触发
+
+用户询问或执行纯 marketplace 变更的发布流程。包含 `plugins.mjs` 入口文件、`public-snapshot/` 制品目录的修改，且无代码、文档或配置变更。
+
+## 当前状态
+
+`release-marketplace` 是工作流配置文件 (§4) 定义的独立工作流之一，专门处理仅 marketplace 索引变更的场景。
+
+**机械实现**: `prepare --workflow marketplace` 确定性地裁剪代码类门禁（H5），plan
+记录 `workflowKind: 'marketplace'` 与 `workflowDecision`。**本工作流不执行发布**：
+发布委托给目标 workspace 的**专属发布技能**（各 marketplace workspace 有独立的
+`publish-marketplace` 流程，如 artifact-skill-set-workspace、glaf4-skill-set-workspace
+等）。release-skill 的 CLI 没有 `sync` 命令，也没有 `exclusive-release.mjs`——
+这些接口不存在，不得调用。
+
+**边界**: plugin source unmodified（不修改 plugin 源码）。市场索引一致性、snapshot
+byte、platform manifest 是核心 gate，由 workspace 自己的生成器与
+`generate-platform-manifest.mjs --check` 机械保证。
+
+## 职责与边界
+
+- **步骤① diff 确认 marketplace-only**: 调用 `release-skill route` command 确认仅有 marketplace 变更（`plugins.mjs` / `public-snapshot/` 归 marketplace 类）
+- **步骤② workspace plugins.mjs 更新**: 手动审查更新入口文件（entry 是唯一 truth source，`plugins.mjs` 属 marketplace 类而非 code 类）
+- **步骤③ 再生成 public-snapshot**: 调用 workspace 自己的快照生成器
+- **步骤④ 一致性验证**: 快照字节 + `generate-platform-manifest.mjs --check`（平台清单漂移检测）
+- **步骤⑤ prepare --workflow marketplace**: 冻结计划，记录 workflow 裁剪决策
+- **步骤⑥ 委托发布**: 调用目标 workspace 的专属 `publish-marketplace` 技能执行发布
+
+**授权边界**:
+- Step②需要人工确认（entry 是唯一 truth source）
+- Step③–④自动验证，不允许不一致状态通过
+- Step⑥依赖外部 workspace 的发布技能，不直接控制其执行
+
+**阶段通过规则**:
+- Steps①–⑤完成且一致：plan `workflowKind === 'marketplace'` 冻结
+- Step⑥成功：以目标 workspace 的发布技能验收标准为准（通常 `status === 'VERIFIED'`）
+
+## 正向执行路径
+
+1. 运行 `release-skill route --root <path> --json` 获取 diff 分类
+2. 若推荐 `workflowKind === 'marketplace-only'`，则使用本技能
+3. 执行步骤②：手动审查并更新 `plugins.mjs`（唯一 truth source）
+4. 执行步骤③：调用 workspace 自己的生成器再生成 `public-snapshot/`
+5. 执行步骤④：运行 `generate-platform-manifest.mjs --check` 验证平台清单与快照字节无漂移
+6. 执行步骤⑤：运行 `release-skill prepare --offline --workflow marketplace --target-version <ver>` 冻结计划
+7. 执行步骤⑥：调用目标 workspace 的专属发布技能（如 `publish-marketplace`）执行发布
+8. (Step⑥续) 汇总目标 workspace 流程的最终状态
+
+## 确定性脚本调用
+
+```bash
+# Step 1: Diff classification confirmation (marketplace-only)
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route \
+  --root <workspace-root> --json
+
+# Step 2: Manual review and update plugins.mjs
+# Human-in-the-loop: entry is the sole truth source
+# Edit: <workspace>/plugins.mjs (add/remove/update plugin entries)
+
+# Step 3: Regenerate public-snapshot (workspace's own generator)
+cd <workspace-root>
+node <workspace-root>/scripts/regenerate-public-snapshot.mjs
+
+# Step 4: Consistency check (snapshot bytes + platform manifest drift)
+node <workspace-root>/scripts/generate-platform-manifest.mjs --check
+
+# Step 5: Freeze the marketplace workflow plan
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" prepare --offline \
+  --workflow marketplace --target-version <version> --json
+
+# Step 6: Delegate publish to the target workspace's own marketplace release
+# skill (each marketplace workspace ships its own publish-marketplace flow;
+# release-skill does NOT publish marketplace indexes itself)
+```
+
+## 故障路由
+
+| 场景 | 状态 | 处理 |
+|------|------|------|
+| 非纯 marketplace 变更 | full-happy-end | 路由到 `release-skill ship` 完整工作流 |
+| plugins.mjs 语法错误 | MARKETPLACE_INDEX_INVALID | 修正语法后重试 step② |
+| plugins.mjs 重复 entry | MARKETPLACE_DUPLICATE_ENTRY | 删除重复项后重试 step② |
+| plugins.mjs entry 缺少必需字段 | MARKETPLACE_ENTRY_INVALID | 补充 required fields（id/name/version）后重试 step② |
+| snapshot byte 不一致 | SNAPSHOT_BYTE_MISMATCH | 重新执行 step③ 再生成快照 |
+| platform manifest 漂移 | PLATFORM_MANIFEST_DRIFT | 重新生成 platform manifest 后重试 step④ |
+| snapshot ≠ manifest | SNAPSHOT_MANIFEST_CONFLICT | 人工决策：以哪个为准后继续 |
+| workspace 发布技能不可用 | WORKSPACE_SKILL_NOT_FOUND | 检查 workspace 发布流程路径，不绕过其安全门禁 |
+
+## 一致性验证 (Step 4)
+
+```
+┌──────────────────────────────────────┐
+│ regenerate public-snapshot completed │
+└──────────────┬───────────────────────┘
+               │
+       ┌───────┴────────┐
+       │                  │
+       ▼                  ▼
+┌──────────────┐   ┌──────────────────┐
+│ snapshot     │   │ platform         │
+│ byte hash    │   │ manifest digest  │
+└──────┬───────┘   └────────┬─────────┘
+       │                    │
+       └────────┬───────────┘
+                │
+        ┌───────┴────────┐
+        │                  │
+        ▼                  ▼
+   ══ CONSISTENT ══   ══ MISMATCH ══
+        │                  │
+        ▼                  ▼
+   Continue → Step 5    Retry Step 3 or
+                 human decision
+```
+
+## 与其他工作流的关系
+
+- **docs-only**: 若 marketplace 更新伴随文档变更，使用 `marketplace-docs` 组合推荐
+- **config-only**: 若同时修改 project.yaml，使用 `marketplace-config` 组合推荐
+- **full-happy-end**: 多类型混合变更（code+marketplace）时降级到此路径
+
+## 关联技能
+
+- `release-skill route`: 快速入门决策路由（§4.3）
+- `release-prepare`: 冻结计划（`--workflow marketplace`）
+- 各 workspace 的专属发布技能（`publish-marketplace`，如 artifact-skill-set-workspace、
+  glaf4-skill-set-workspace、skill-family-hub-workspace 等）
+- `generate-platform-manifest.mjs`: 平台清单漂移检测（--check）
+
+## Workspace Coordination Notes
+
+每个 workspace 管理自己的 marketplace 入口和制品，并通过其专属发布技能发布：
+- `artifact-skill-set-workspace`: `plugins.mjs` 是条目唯一事实源，`publish-marketplace`
+  技能执行发布
+- `glaf4-skill-set-workspace`: 同上，项目专属 `publish-marketplace` 技能
+- `skill-family-hub-workspace`: `plugins.mjs` 只记录已满足公开收录条件的插件
+
+本技能作为协调器，确认 route 分类并冻结 marketplace 工作流计划，但发布动作必须
+委托给目标 workspace 自己的发布技能执行，release-skill 不直接操作其他 workspace
+的代码库。

package/skills/release-publish/SKILL.md

@@ -1,15 +1,11 @@
 ---
 name: release-publish
-description: 从已批准的生产计划发布冻结 Git branch/tag、npm tarball 与 GitHub Release，并执行已配置的 Claude/Codex marketplace 隔离消费者安装检查以达到 PUBLISHED；随后必须路由 release-verify 才可能达到 VERIFIED；遇到冲突或不确定远端状态时失败关闭并要求人工介入
+description: "从已批准的生产计划发布冻结 Git branch/tag、npm tarball 与 GitHub Release，并执行已配置的 Claude/Codex marketplace 隔离消费者安装检查以达到 PUBLISHED；随后必须路由 release-verify 才可能达到 VERIFIED；遇到冲突或不确定远端状态时失败关闭并要求人工介入"
 ---
 
 # release-publish
 
-## 触发
-
-用户明确要求执行已经人工审阅的 GitHub+npm 生产计划。
-
-## 成熟度与边界
+## 生产边界
 
 冻结 Git branch/tag、GitHub Release、npm tarball 路径已通过本地生产等价沙箱（协议级 fake），
 测试没有提供 OS 级网络隔离。
@@ -23,6 +19,29 @@ description: 从已批准的生产计划发布冻结 Git branch/tag、npm tarbal
 认证失败或摘要漂移时，在全局预检阶段停止并交给人工。禁止覆盖、删除和自动回滚；
 新建 ref 的 create-only CAS（`--force-with-lease=<ref>:`）只断言目标不存在，不授权覆盖。
 
+## 前置条件：工作流选择
+
+在运行 `release-publish` 之前，必须先完成快速入门决策路由（§4.3 Workflow Profile Support）：
+
+1. 使用 `release-skill route --root <path> --json` 确定变更类型
+2. 根据推荐的 `workflowKind` 选择对应路径：
+   - `docs-only` → 先执行 `release-docs` 完整流程
+   - `config-only` → 先执行 `release-config`，仅在 public surface 变化时进入 publish
+   - `marketplace-only` → 先执行 `release-marketplace`，然后由 workspace exclusive skill 接管
+   - `full-happy-end` → 直接进入标准完整流程：`prepare → approve → publish → verify`
+   - `reconcile` → 先执行 `release-reconcile` 恢复 PARTIAL 状态
+   - `help` → 无变更，无需 publish
+
+**注意**: `release-publish` 是标准工作流中的第⑦步，必须在以下步骤之后：
+- 步骤⑤: `release-prepare` (或轻量级 prepare)
+- 步骤⑥: `release-approve` (非过期 approval record)
+
+决策表链接：参见 [`release-help`](../release-help/SKILL.md) 的 Routing Suggestions 章节。
+
+## 触发
+
+用户明确要求执行已经人工审阅的 GitHub+npm 生产计划。
+
 ## 授权门
 
 1. 展示可读的 `approvalSummary`：版本、仓库/包名、branch/tag、全部 actions 和例外。

package/skills/release-verify/SKILL.md

@@ -15,6 +15,16 @@ verify 是发布流程的最终验证阶段，是唯一能将状态提升到 `VE
 它执行远端状态重检、精确 npm 安装烟雾测试和消费者插件安装验证。
 verify 只接受 `PUBLISHED` 状态的源 run；`VERIFIED` 是终态，不会再次派生运行。
 
+**注意**: distribute gate (W1) 已经实现并集成在标准 verify 流程中。verify 现在会检查 postPublish 分发状态（git mirror + marketplace index），只有当所有外部动作都完成并通过验证时才达到 VERIFIED。
+
+**工作流兼容性**: 
+- `docs-only`: consumer-verify preserved (步骤⑧)
+- `config-only`: scene B completes full chain including verify  
+- `marketplace-only`: delegates to workspace's exclusive skill for final verification
+- `full-happy-end`: standard complete path with all gates
+
+所有工作流 profile 最终都路由到此 verify 命令作为终态验证门。
+
 ## 职责与边界
 
 验证远端所有自动化 action 的实际状态与冻结计划一致。执行精确 `<package>@<version>` npm 安装到隔离目录，验证包名、版本、静态入口闭包，并在配置时验证 bin 路径安全和 CLI 烟雾输出。对 Claude/Codex marketplace distribution 执行全新隔离消费者安装验证。新计划中的 Kimi/CodeBuddy 安装只返回 `manualFollowUps`，明确标记 `verifiedBySystem: false`，不阻塞 `VERIFIED`；缺少该策略字段的旧冻结计划继续走历史 attestation 兼容路径。

package/skills-src/release-config/SKILL.md

@@ -0,0 +1,140 @@
+---
+name: release-config
+description: "Config-only workflow profile: route confirms config-only diff, assess with schema validation, prepare --workflow config (code-class gates trimmed), workflowDecision records publish path (public bytes unchanged → no publish path; changed → lightchain prepare→approve→publish→verify)"
+---
+
+# release-config
+
+## 触发
+
+用户询问或执行纯配置变更的发布流程。包含 `.release-skill/project.yaml`、配置 schema 等配置文件的修改，且无代码、文档或 marketplace 变更。
+
+## 当前状态
+
+`release-config` 是工作流配置文件 (§4) 定义的独立工作流之一，专门处理仅配置变更的场景。它遵循简化生命周期，专注于配置验证和发布路径决策分支。
+
+**机械实现**: `prepare --workflow config` 确定性地裁剪代码类门禁（H5），并比较当前
+per-unit `snapshotDigest` 与最新冻结 plan——公开字节未变 → `publishPath:
+'no-publish-needed'`（externalActions 被移除，无 publish 路径）；字节变化或无对比
+plan → `publishPath: 'publish-needed'`（fail-safe）。决策以 `workflowDecision` 绑定
+进 plan digest，不可篡改。**不存在** `NO_PUBLISH_NEEDED`/`REPORTED` 虚构状态：
+prepare 的真实输出是 plan 内的 `workflowDecision`。
+
+**边界**: 跳过代码类 gates（declared hooks、snapshot-verify gates、source-authority
+closure、skill-resource-closure）。保留 baseline/snapshots/plan freeze/docs
+freshness。consumer-verify 仅在触发生效发布时参与。
+
+## 职责与边界
+
+- **步骤① diff 确认 config-only**: 调用 `release-skill route` command 确认仅有配置变更
+- **步骤② assess with schema validation**: 执行配置结构验证、schema 检查、contract 一致性
+- **步骤③ prepare --workflow config**: 本地 freeze 检查，生成只读计划；输出 `workflowDecision`
+- **步骤④ decision branch**（来自 plan.workflowDecision）:
+  - 场景 A：`publishPath === 'no-publish-needed'`（公开字节未变化）→ 记录决策并结束，
+    无 publish 路径，不运行 approve/publish/verify
+  - 场景 B：`publishPath === 'publish-needed'`（公开 surface 变化或不可判定）→ 运行
+    轻链 (approve→publish→verify)
+
+**授权边界**: 命令调用本身即授权执行配置的 hooks/gates。config-only 工作流的远程写操作受标准 approval 机制约束，不 bypass 安全 gate。
+
+**阶段通过规则**:
+- 场景 A: prepare 输出 `workflowDecision.decision === 'public-bytes-unchanged'`（无 publish 路径）
+- 场景 B: `status === 'VERIFIED'` + CLI exit code 0
+
+## 正向执行路径
+
+1. 运行 `release-skill route --root <path> --json` 获取 diff 分类
+2. 若推荐 `workflowKind === 'config-only'`，则使用本技能
+3. 执行步骤②：运行 `release-skill assess --root <path> --offline --json` 进行 schema validation
+4. 执行步骤③：运行 `release-skill prepare --offline --workflow config --target-version <ver> --json`
+5. 读取输出中的 `workflowDecision`：
+   - **A**: `publishPath === 'no-publish-needed'` → 记录决策（plan 已冻结，无
+     externalActions），结束。无需 approve/publish/verify
+   - **B**: `publishPath === 'publish-needed'` → 继续 approve → publish → verify 链条
+6. (场景 B 续) 执行步骤⑥：运行 `release-skill approve --plan <path> --actor <name>`
+7. (场景 B 续) 执行步骤⑦：运行 `release-skill publish --plan <path> --approval <path>`
+8. (场景 B 续) 执行步骤⑧：运行 `release-skill verify --plan <path> --run <path>`
+
+## 确定性脚本调用
+
+```bash
+# Step 1: Diff classification confirmation (config-only)
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route --root <path> --json
+
+# Step 2: Assess with schema validation
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" assess --root <path> --offline --json
+
+# Step 3: Prepare --workflow config (local freeze + publish-path decision)
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" prepare --offline \
+  --workflow config --target-version <version> --json
+# Output (JSON): { workflowKind: 'config',
+#   workflowDecision: { decision: 'public-bytes-unchanged'|'public-bytes-changed'|'indeterminable',
+#     publishPath: 'no-publish-needed'|'publish-needed', comparedPlan: '<digest>.json' } }
+
+# Decision Branch A (no-publish-needed): plan frozen with zero externalActions;
+# the decision is bound into the plan digest. No publish commands run.
+
+# Decision Branch B (publish-needed): light chain execution
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" approve \
+  --plan <path> --actor <person-name>
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" publish \
+  --plan <path> --approval <path>
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" verify \
+  --plan <path> --run <path> --json
+```
+
+## 故障路由
+
+| 场景 | 状态 | 处理 |
+|------|------|------|
+| 非纯配置变更（mixed=true） | full-happy-end | 路由到 `release-skill ship` 完整工作流 |
+| schema validation 失败 | CONFIG_SCHEMA_INVALID | 修正 project.yaml 或 schemas 结构错误后重试 step② |
+| contract verification 失败 | CONFIG_CONFLICT | 解决配置冲突后重试 step② |
+| prepare 检测到基线漂移 | BASELINE_DRIFT_DETECTED | 人工审查 drift 后决定是否继续或回滚 |
+| workflowDecision 不可判定（无对比 plan） | indeterminable | fail-safe 到 publish-needed，走场景 B |
+| approval expired | APPROVAL_EXPIRED | 重新执行 approve，digest 必须匹配 |
+| remote conflict at publish | REMOTE_CONFLICT | 人工决策：force override 或 cancel |
+
+## 决策树 (Step 4)
+
+```
+┌─────────────────────────────────────────┐
+│  prepare --workflow config completed    │
+└──────────────────┬──────────────────────┘
+                   │
+        ┌──────────┴──────────┐
+        │                     │
+        ▼                     ▼
+┌───────────────┐   ┌───────────────────┐
+│ public bytes  │   │ public bytes      │
+│ unchanged     │   │ changed /         │
+│ (or no plan   │   │ indeterminable    │
+│  → fail-safe  │   │                   │
+│  → publish    │   │                   │
+│  needed)      │   │                   │
+└───────┬───────┘   └────────┬──────────┘
+        │                    │
+        ▼                    ▼
+┌───────────────┐   ┌───────────────────┐
+│ no-publish    │   │ light chain       │
+│ needed:       │   │ approve→publish   │
+│ decision      │   │ →verify           │
+│ recorded in   │   │                   │
+│ plan digest   │   │                   │
+└───────────────┘   └───────────────────┘
+```
+
+## 与其他工作流的关系
+
+- **docs-only**: 纯文档变更时使用 `release-docs`
+- **marketplace-only**: 仅 marketplace 变更时使用独立工作流
+- **full-happy-end**: 混合变更（code+config+docs）时降级到此完整路径
+
+## 关联技能
+
+- `release-skill route`: 快速入门决策路由（§4.3）
+- `release-assess`: 配置 schema/contract 验证入口
+- `release-prepare`: 离线冻结检查（`--workflow config` 输出 publish-path 决策）
+- `release-approve`: Plan approval（仅场景 B）
+- `release-publish`: 制品发布（仅在 public surface 变化时执行）
+- `release-verify`: 消费者验证（场景 B 的最终验证门）

package/skills-src/release-docs/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: release-docs
+description: "Docs-only workflow profile: route confirms docs-only diff, style-guard gates (check-style.mjs file paths), render-public-site --check drift scan, docs refresh rehearsal → binder write, prepare --workflow docs (code-class gates trimmed), approve/publish/verify with consumer-verify preserved"
+---
+
+# release-docs
+
+## 触发
+
+用户询问或执行纯文档变更的发布流程。包含 `docs/public/site/`, `README*`, `CHANGELOG`, `release-notes/` 等文件的修改，且无代码、配置或 marketplace 变更。
+
+## 当前状态
+
+`release-docs` 是工作流配置文件 (§4) 定义的独立工作流之一，专门处理仅文档变更的场景。它遵循标准发布生命周期，但跳过代码类检查门（声明式 hooks、snapshot-verify gates、source-authority closure、skill-resource-closure），专注于文档质量 gate。
+
+**机械实现**: `prepare --workflow docs` 在 prepare 内确定性地裁剪代码类门禁（H5），
+plan 记录 `workflowKind: 'docs'` 与 `workflowDecision`（绑定进 plan digest）。
+**边界**: NOT merging repos；不对代码类 gates（如 schema validation、contract verification）负责。
+
+## 职责与边界
+
+- **步骤① diff 分类确认**: 调用 `release-skill route` command 对工作树 diff 分类，确认仅有文档变更
+- **步骤② style-guard 三道门**: 调用 `check-style.mjs`（只接受文件路径参数，exit 0/1/2）执行事实性/可读性/风格检查
+- **步骤③ render-public-site --check**: 调用 `render-public-site.mjs --check [--repo <name>]` 做渲染漂移扫描（内存泄漏扫描 + 树基线对比）
+- **步骤④ docs refresh**: 执行 rehearsal → binder 写入（本地文档更新，不 commit/push）
+- **步骤⑤ prepare --workflow docs**: 轻量 freeze（裁剪代码类 gates，保留 docs freshness/public-surface/baseline/snapshots/plan freeze）
+- **步骤⑥–⑧**: approve → publish → verify（consumer-verify 保留）
+
+**授权边界**: 命令调用本身即授权执行配置的 hooks/gates。本地文档写入授权只覆盖声明的本地文档目标，不是 Git commit/push/publish 或安装的授权。
+
+**阶段通过规则**: `status === 'VERIFIED'` 且 CLI exit code 为 0。`PARTIAL` 状态允许安全重试已完成的 checkpoint。
+
+## 正向执行路径
+
+1. 运行 `release-skill route --root <path> [--target-version <ver>] --json` 获取 diff 分类和工作流推荐
+2. 若推荐 `workflowKind === 'docs-only'`，则使用本技能
+3. 执行步骤②：调用 `check-style.mjs <doc-path>...` 执行事实/可读性/风格检查
+4. 执行步骤③：调用 `render-public-site.mjs --check [--repo <name>]` 验证渲染无漂移
+5. 执行步骤④：运行 `release-skill docs refresh --unit <id> --write --confirm-refresh <digest> --ack-local-document-write`
+6. 执行步骤⑤：运行 `release-skill prepare --offline --workflow docs --target-version <ver>`
+7. 执行步骤⑥：人工审阅后运行 `release-skill approve --plan <path> --actor <name>`
+8. 执行步骤⑦：运行 `release-skill publish --plan <path> --approval <path>`
+9. 执行步骤⑧：运行 `release-skill verify --plan <path> --run <path>`
+
+## 确定性脚本调用
+
+```bash
+# Step 1: Diff classification (from release-skill route)
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route --root <path> --json
+
+# Step 2: Style-guard three gates (check-style.mjs takes file paths only)
+node "${WORKBUDDY_ROOT}/adapters/workbuddy/skills/skill-family-docs-style-guard/scripts/check-style.mjs" \
+  <doc-path-1> <doc-path-2>
+
+# Step 3: Render site check (drift + leak scan against committed baseline)
+node "${DOC_RENDER_ROOT}/packages/skill-family-doc-render/scripts/render-public-site.mjs" --check [--repo <repo-name>] # source-only
+
+# Step 4: Docs refresh with rehearsal
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" docs refresh --unit <id> --json
+# Then confirm and write:
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" docs refresh --unit <id> \
+  --write --confirm-refresh <refreshDigest> --ack-local-document-write --json
+
+# Step 5: Lightweight prepare --workflow docs
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" prepare --offline \
+  --workflow docs --target-version <version> --json
+
+# Step 6: Approval
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" approve \
+  --plan <path> --actor <person-name>
+
+# Step 7: Publish
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" publish \
+  --plan <path> --approval <path>
+
+# Step 8: Verify (consumer-verify preserved)
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" verify \
+  --plan <path> --run <path> --json
+```
+
+## 故障路由
+
+| 场景 | 状态 | 处理 |
+|------|------|------|
+| 非纯文档变更（mixed=true） | full-happy-end | 路由到 `release-skill ship` 完整工作流 |
+| style-guard 检查失败 | exit 1（check-style.mjs） | 修正文档问题后重试 step② |
+| check-style.mjs 运行错误 | exit 2 | 检查参数（只接受文件路径）与文件存在性 |
+| render-site 漂移 | RENDER_SITE_DRIFT | 重新渲染并提交基线后重试 step③ |
+| prepare 检测到未刷新文档 | PREPARE_STALE_DOCS | 重新执行 step④ → 提交 → 重新 prepare |
+| 非 VERIFIED 终态 | NEEDS_INPUT / BLOCKED | 根据错误码诊断具体问题 |
+
+## 与其他工作流的关系
+
+- **config-only**: 仅配置变更时使用 `release-config`
+- **marketplace-only**: 仅 marketplace 变更时使用独立工作流
+- **full-happy-end**: 混合变更（code+docs）时降级到此完整路径
+
+## 关联技能
+
+- `release-skill route`: 快速入门决策路由（§4.3）
+- `release-assess`: 项目发布就绪度评估
+- `release-prepare`: 冻结发布计划（`--workflow docs` 裁剪代码类门禁）
+- `release-publish`: 发布 GitHub/npm 制品
+- `release-verify`: 消费者验证和远程状态重检
+- `skill-family-docs-style-guard`（skill-family-docs adapter）: `check-style.mjs` 文档质量三道门
+- `render-public-site`（skill-family-doc-render）: 站点渲染漂移与泄漏扫描

package/skills-src/release-help/SKILL.md

@@ -78,6 +78,45 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" docs refresh --unit <id> \
 | 请求生产发布 | 已有公开版本先调用 `release-prepare --online --production` 观察 bound 基线；人工审阅后再路由 `release-publish` |
 | RELEASE_DOCS_INVALID | 配置或说明源语义非法（重复键、alias、未知字段、版本漂移等）；修正配置或说明源后重新演练 |
 | RELEASE_DOCS_TRANSLATION_MISSING | 配置语种缺失或多余；补齐说明源语种，与 `releaseDocuments.locales` 完全一致，不得回退 |
+
+## Routing Suggestions (§4.3 Quickstart Routing)
+
+对于不清楚如何开始的用户，推荐使用 `release-skill route` 命令进行自动化工作流选择：
+
+```bash
+# 快速分类变更并推荐工作流
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route --root <path> --json
+
+# JSON 输出包含 classification 和 recommendation 字段
+{
+  "classification": {
+    "code": [],
+    "docs": ["README.md"],
+    "config": [],
+    "marketplace": [],
+    "mixed": false
+  },
+  "recommendation": {
+    "workflowKind": "docs-only",
+    "reason": "Pure documentation changes detected...",
+    "firstCommand": "release-docs"
+  }
+}
+```
+
+**可用工作流**:
+- `docs-only`: 纯文档变更（跳过代码类门限）
+- `config-only`: 纯配置变更（schema 验证 + 决策分支）
+- `marketplace-only`: 纯 marketplace 索引变更（条目更新 + snapshot 同步）
+- `full-happy-end`: 混合变更或无法确定（fail-closed 到最安全路径）
+- `reconcile`: 存在 PARTIAL 运行时需先恢复
+- `help`: 无变更且未指定目标版本
+
+参考文档：
+- [`release-docs`](../release-docs/SKILL.md) - 文档工作流详解
+- [`release-config`](../release-config/SKILL.md) - 配置工作流详解
+- [`release-marketplace`](../release-marketplace/SKILL.md) - Marketplace 工作流详解
+
 | RELEASE_DOCS_CONFLICT | 目标含非受管同版本条目、受管标记损坏或人工冲突；人工修复目标并保留人工修改后重新演练 |
 | RELEASE_DOCS_REFRESH_STALE | 确认绑定后候选已变化；重新演练取得新 `refreshDigest` 再确认写入 |
 | RELEASE_DOCS_STALE | prepare 检测到文档未刷新；按 `docs refresh` → 审阅 → 提交 → 重新 prepare 恢复 |