BlueprintOS Verification-Before-Completion(桥接到 superpowers)
Contract
- Inputs: completion claim, verification commands, implementation/documentation outputs
- Outputs: verification report using IDENTIFY/RUN/READ/VERIFY/THEN
- Gates: full verification command succeeds and output supports the claim
- Required disciplines:
stage-gate - Next: commit, fix loop, or
/handoff
本仓库不维护此 skill 的内容。完整纪律请读:
<SUPERPOWERS_SKILL_ROOT>/verification-before-completion/SKILL.md
何时调
- 每个子任务结束时(在 commit 之前)
- 整个开发冲刺结束时(在 HANDOVER 之前)
衔接点
- 产出:验证报告(IDENTIFY → RUN → READ → VERIFY → THEN 5 步门控)
- 下一步:commit(通过)或修复(失败)
- 门控:
disciplines/stage-gate第 3 层(失败必须重新跑)
5 步门控
参考完整纪律:
- IDENTIFY — 什么命令能证明这个声明?
- RUN — 执行完整的验证命令
- READ — 读完整输出,检查退出码
- VERIFY — 输出是否确认了声明?
- THEN — 才能做出声明
铁律:跳过任何一步 = 撒谎,不是验证。
降级方案(superpowers 未装时)
如果 <SUPERPOWERS_SKILL_ROOT>/verification-before-completion/ 不存在,严格按以下 5 步门控(铁律,不允许跳):
1. IDENTIFY — 什么命令能证明这个声明?
- 把"已完成 / 通过 / 成功"翻译成可执行的命令
- 例如:"已修复 ASN 收货 bug" →
mvn test -Dtest=AsnReceiveServiceTest - ❌ 没有命令 = 你不知道自己在声称什么
2. RUN — 执行完整命令
- 命令必须完整执行(不能只看 stdout 头几行就停)
- 包含退出码 / 错误输出
- 用
; echo "exit=$?"拿退出码
3. READ — 读完整输出
- 读全部输出,不只是你期望的那部分
- 数失败数 / 数 PASS 数 / 检查退出码
- ❌ 看一半就跳 = 漏掉隐藏失败
4. VERIFY — 输出是否真的支持声明?
- 把命令输出对照你的声明
- 输出支持 → 进 THEN
- 输出反对你的声明 → 立刻如实汇报(不允许"应该可以了")
- ❌ "看起来是对的" 一律不算
5. THEN — 才能做出声明
- 经过前 4 步后才能写"完成 / 通过 / 成功"
- 必须附证据:命令 + 退出码 + 关键输出片段
- ❌ 没跑就声明 = 撒谎
最小纪律摘要
- IDENTIFY 写不出命令 = 这个声明不成立
- RUN 不完整 = 假装在验
- READ 跳着看 = 漏失败
- VERIFY 不严 = 给自己找借口
- THEN 没附证据 = 不可信
安装提示
npx skills@latest add obra/superpowers-verification-before-completion