release-skill 0.1.1

package/adapters/codex/skills/release-verify/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: release-verify
+description: Post-publish verification including remote state recheck, exact npm installation smoke, and consumer plugin install verification
+---
+
+# release-verify
+
+## 触发
+
+用户请求验证发布结果完整性，或发布流程自动进入 verify 阶段。
+
+## 当前状态
+
+verify 是发布流程的最终验证阶段，是唯一能将状态提升到 `VERIFIED` 的命令。
+它执行远端状态重检、精确 npm 安装烟雾测试和消费者插件安装验证。
+verify 只接受 `PUBLISHED` 状态的源 run；`VERIFIED` 是终态，不会再次派生运行。
+
+## 职责与边界
+
+验证远端所有 action 的实际状态与冻结计划一致。执行精确 `<package>@<version>` npm 安装到隔离目录，验证包名、版本、bin 路径安全和 CLI 烟雾输出。对每个声明的 marketplace distribution 执行全新隔离消费者安装验证。
+
+**阶段通过规则**: 只有 CLI exit code 0 和结构化状态码 `VERIFIED` 才是完整终态。
+
+**源 run 要求**: `--run` 必需；源 run 的所有 checkpoint 必须为 succeeded 或 skipped。
+
+**不确定性停止**: 任何验证失败立即停止，不进行部分降级。
+
+## 正向执行路径
+
+1. 确认有 `--run` 路径（必需），且源 run 状态为 PUBLISHED
+2. 复用 `release-help` 已解析的 `CLI` 数组，运行 `"${CLI[@]}" verify --root <path> --plan <plan-path> --run <run-path> --json`
+3. 检查 exit code 和结构化状态：`VERIFIED`（全部通过）/ 失败（具体错误）
+4. 只有 `VERIFIED` 才是 happy end
+
+## 确定性脚本调用
+
+```bash
+# 从 npm 全局安装
+"${CLI[@]}" verify --root <path> --plan <plan-path> --run <run-path> --json
+
+# 从源码运行
+node "$RELEASE_SKILL_HOME/packages/release-skill/bin/release-skill.mjs" verify --root <path> --plan <plan-path> --run <run-path> --json
+```
+
+## 验证步骤
+
+1. 加载并验证 release plan schema 和 digest
+2. 加载源 run，验证 planDigest 匹配和 checkpoint 完整性
+3. 对每个 plan action 执行 adapter.verify()（远端状态重检）
+4. 对每个 npm distribution 执行隔离安装烟雾测试
+5. 对每个 marketplace distribution 执行全新隔离消费者安装验证
+6. 全部通过 → `VERIFIED`
+
+## 烟雾测试
+
+- 在 `os.tmpdir()` 创建隔离目录
+- 执行 `npm install <package>@<version>` 带安全标志
+- 验证安装的 `package.json` name 和 version 精确匹配
+- 若配置了 `smokeBin`：验证 bin 路径安全（无逃逸、无 symlink），执行并验证输出
+- 若未配置 `smokeBin`：仅安装 + name/version 检查即通过
+
+## 常见错误
+
+| 场景 | 状态 | 处理 |
+|------|------|------|
+| 源 run 非 PUBLISHED | GATE_FAILED | 拒绝执行；VERIFIED 是终态 |
+| 源 run 有 incomplete checkpoint | GATE_FAILED | 拒绝执行 |
+| 远端状态不匹配 | POST_PUBLISH_VERIFY_FAILED | 停止 |
+| npm 安装失败 | POST_PUBLISH_VERIFY_FAILED | 停止 |
+| CLI 烟雾输出不匹配 | POST_PUBLISH_VERIFY_FAILED | 停止 |