@birdie_moblie/open_spec 2.1.7

package/skills/opsx-source-update/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: opsx-source-update
+description: 对未完成 change 做可中止的来源修订，重建 parse/tech/plan。
+---
+
+# opsx-source-update
+
+用于已有 change 补充需求/接口/设计。不要在本流程写应用代码。
+
+## 项目 CLI 预检
+
+定位项目根并校验 CLI 版本。
+
+## 循环
+
+1. 若有 created worker：确认后 `openspec worker cancel`
+2. 读 status / instructions
+3. 读取 nodes/update.md
+4. 停在新的 Gate-A
+
+## 退出条件
+
+新 Gate-A，或用户要求 abort：`openspec sources abort-update --reason "..."`。

package/skills/opsx-source-update/nodes/update.md

@@ -0,0 +1,14 @@
+# Update
+
+```bash
+openspec sources add --change "<name>" --source <capability>=<locator> --view summary --json
+openspec sources collect --change "<name>" --view summary --json
+```
+
+然后按 propose 的 parse → tech → plan 重建产物。已过 Gate-A 且有完成 task 时，plan 验收会写 reconciliation。
+
+Gate-A 批准前可：
+
+```bash
+openspec sources abort-update --change "<name>" --reason "withdrawn" --json
+```

package/skills/opsx-verify/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: opsx-verify
+description: 批准 Gate-B 后执行 QA hook 并生成报告，停在 Gate-C。
+---
+
+# opsx-verify
+
+## 项目 CLI 预检
+
+定位项目根并校验 CLI 版本与 `install-cli.mjs` 一致。
+
+## 循环
+
+1. `openspec instructions opsx-verify --json`
+2. 读取 `nodeFile` 执行
+3. 优先复用变更命令返回的 `next` / `nodeFile`；无此字段或外部状态变化时才重新取 instructions
+
+## 路由表
+
+| next.action | 读取 |
+|---|---|
+| await_gate gate-B | nodes/gate-b.md |
+| create_worker verify | nodes/verify.md |
+| await_gate gate-C | nodes/stop.md |
+| fix_verify | nodes/failed.md |
+| 其他 | nodes/blocked.md |
+
+## 退出条件
+
+停在 Gate-C，或验证失败需修复时改走 `/opsx-fix-verify`。不要归档。
+
+summary 中的 `packetPath` 指向完整 packet；按返回的路径读取，不回显全文。

package/skills/opsx-verify/nodes/blocked.md

@@ -0,0 +1,3 @@
+# 受阻
+
+展示缺失 hook 证据或命令失败，等待用户。

package/skills/opsx-verify/nodes/failed.md

@@ -0,0 +1,3 @@
+# 验证失败
+
+QA 有 blocking 问题。不要继续批准 Gate-C。交给 `/opsx-fix-verify`。

package/skills/opsx-verify/nodes/gate-b.md

@@ -0,0 +1,7 @@
+# Gate-B
+
+`/opsx-verify` 视为批准意图：
+
+```bash
+openspec gate approve gate-B --change "<name>" --comment "approved via /opsx-verify" --json
+```

package/skills/opsx-verify/nodes/stop.md

@@ -0,0 +1,5 @@
+# 停止
+
+已到达 Gate-C。汇报 QA 报告路径，等待 `/opsx-archive` 或 `/opsx-gate-decision`。
+
+先执行 `openspec todo --change "<name>" --json`，按 design / product / 其他分类向用户汇报文件:行:文案。Worker 历史「未能满足/占位」声明单列，说明是否已解决；同时说明未扫描文件。待办本身不阻塞引擎，不代表可绕过 spec 或 required Hook。用户决定剩余事项的处置。

package/skills/opsx-verify/nodes/verify.md

@@ -0,0 +1,10 @@
+# Verify
+
+1. `openspec worker create --change "<name>" --step verify --view summary --json`：packet 的 `verifyHooks` 列出本 run 需要证据的全部 verify hook（command / skill / file / check），逐项处理，不要凭记忆
+2. `openspec verify commands --change "<name>" --json`：引擎执行全部 `command` hook
+3. 对 `skill` hook：宿主支持 subagent 则派发；descriptor 的 `path`（若有）是该 skill 在 marketplace 插件里的 SKILL.md 绝对路径，宿主未注册该 skill 时按路径读取执行。完成后 `openspec verify skill-evidence --change "<name>" --hook <id> --status passed|failed|skipped --notes "<结论与报告路径>" --json`
+4. `file` hook 用 `verify hook-result`、`check` hook 用 `verify check-result` 登记证据；结论必须如实（required 的 failed 会让报告 failed，这是预期路径）
+5. `openspec verify report --change "<name>" --json`
+6. 写 verify result（`{ workerId, stepId: "verify", status: "completed", notes }`，不含 executeHookResults），`openspec worker accept ...`
+
+报告 status=failed 时 accept 后 `next.action` 为 `fix_verify`：停止并交给 `/opsx-fix-verify`。