Superpowers 完工前自检验证

Superpowers 完工前自检验证：obra/superpowers 方法论: verification-before-completi，适用于工程实践、代码质量与开发流程优化。

Skill Documentation

Superpowers 完工前自检验证

摘要

Superpowers 完工前自检验证：obra/superpowers 方法论: verification-before-completi，适用于工程实践、代码质量与开发流程优化。

> 来源: obra/superpowers (236k stars) — Production-grade skill library

> 原文件: skills/verification-before-completion/SKILL.md

> 模型推荐: claude-opus-4-7 (代码工程方法论)

这个 skill 是干嘛的

这是 obra (Jesse Vincent) 在 236k stars 的 superpowers 仓库里沉淀下来的"工程方法论"skill。每一个对应一个开发动作(写代码 / 调试 / 评审 / 子智能体 / Git worktree),不是单一工具,而是一套完整的"该怎么干活"的行为规范。

michael 强调"skill 要有相应的指导功能,指导用户使用",所以这个 skill 的 SKILL.md 不仅有方法论原文,还附带下面两节帮 Agent 和用户对接。

---

🤖 Agent 使用说明

1. 先在脑子里按这个 skill 的检查清单(Checklist)跑一遍当前动作

2. 如果清单里有"先做 X 才能做 Y"的红线 → 必须先完成 X

3. 跑完清单后才动手写代码 / 调工具

4. 完工前跑 `verification-before-completion` 那套自检

5. 写代码前跑 `test-driven-development` — 测试先行

👤 用户需要做什么?

1. 告诉 Agent 你要做什么(一句话即可)

2. 如果 Agent 反问"要不要 TDD / 评审 / 子智能体",按你这边情况答"是"或"否"

3. 如果 Agent 主动调用 `dispatching-parallel-agents`,确认子任务边界是否合理

4. 完工后让 Agent 用 `verification-before-completion` 跑一遍自检

5. 不需要手工干预 — Agent 会自动按方法论走

---

原 skill 内容(obra/superpowers/verification-before-completion/SKILL.md)

LS0tCm5hbWU6IHZlcmlmaWNhdGlvbi1iZWZvcmUtY29tcGxldGlvbgpkZXNj

cmlwdGlvbjogVXNlIHdoZW4gYWJvdXQgdG8gY2xhaW0gd29yayBpcyBjb21w

bGV0ZSwgZml4ZWQsIG9yIHBhc3NpbmcsIGJlZm9yZSBjb21taXR0aW5nIG9y

IGNyZWF0aW5nIFBScyAtIHJlcXVpcmVzIHJ1bm5pbmcgdmVyaWZpY2F0aW9u

IGNvbW1hbmRzIGFuZCBjb25maXJtaW5nIG91dHB1dCBiZWZvcmUgbWFraW5n

IGFueSBzdWNjZXNzIGNsYWltczsgZXZpZGVuY2UgYmVmb3JlIGFzc2VydGlv

bnMgYWx3YXlzCi0tLQoKIyBWZXJpZmljYXRpb24gQmVmb3JlIENvbXBsZXRp

b24KCiMjIE92ZXJ2aWV3CgoqKkNvcmUgcHJpbmNpcGxlOioqIEV2aWRlbmNl

IGJlZm9yZSBjbGFpbXMsIGFsd2F5cy4KCioqVmlvbGF0aW5nIHRoZSBsZXR0

ZXIgb2YgdGhpcyBydWxlIGlzIHZpb2xhdGluZyB0aGUgc3Bpcml0IG9mIHRo

aXMgcnVsZS4qKgoKIyMgVGhlIElyb24gTGF3CgpgYGAKTk8gQ09NUExFVElP

TiBDTEFJTVMgV0lUSE9VVCBGUkVTSCBWRVJJRklDQVRJT04gRVZJREVOQ0UK

YGBgCgpJZiB5b3UgaGF2ZW4ndCBydW4gdGhlIHZlcmlmaWNhdGlvbiBjb21t

YW5kIGluIHRoaXMgbWVzc2FnZSwgeW91IGNhbm5vdCBjbGFpbSBpdCBwYXNz

ZXMuCgojIyBUaGUgR2F0ZSBGdW5jdGlvbgoKYGBgCkJFRk9SRSBjbGFpbWlu

ZyBhbnkgc3RhdHVzIG9yIGV4cHJlc3Npbmcgc2F0aXNmYWN0aW9uOgoKMS4g

SURFTlRJRlk6IFdoYXQgY29tbWFuZCBwcm92ZXMgdGhpcyBjbGFpbT8KMi4g

UlVOOiBFeGVjdXRlIHRoZSBGVUxMIGNvbW1hbmQgKGZyZXNoLCBjb21wbGV0

ZSkKMy4gUkVBRDogRnVsbCBvdXRwdXQsIGNoZWNrIGV4aXQgY29kZSwgY291

bnQgZmFpbHVyZXMKNC4gVkVSSUZZOiBEb2VzIG91dHB1dCBjb25maXJtIHRo

ZSBjbGFpbT8KICAgLSBJZiBOTzogU3RhdGUgYWN0dWFsIHN0YXR1cyB3aXRo

IGV2aWRlbmNlCiAgIC0gSWYgWUVTOiBTdGF0ZSBjbGFpbSBXSVRIIGV2aWRl

bmNlCjUuIE9OTFkgVEhFTjogTWFrZSB0aGUgY2xhaW0KClNraXAgYW55IHN0

ZXAgPSBseWluZywgbm90IHZlcmlmeWluZwpgYGAKCiMjIENvbW1vbiBGYWls

dXJlcwoKfCBDbGFpbSB8IFJlcXVpcmVzIHwgTm90IFN1ZmZpY2llbnQgfAp8

LS0tLS0tLXwtLS0tLS0tLS0tfC0tLS0tLS0tLS0tLS0tLS18CnwgVGVzdHMg

cGFzcyB8IFRlc3QgY29tbWFuZCBvdXRwdXQ6IDAgZmFpbHVyZXMgfCBQcmV2

aW91cyBydW4sICJzaG91bGQgcGFzcyIgfAp8IExpbnRlciBjbGVhbiB8IExp

bnRlciBvdXRwdXQ6IDAgZXJyb3JzIHwgUGFydGlhbCBjaGVjaywgZXh0cmFw

b2xhdGlvbiB8CnwgQnVpbGQgc3VjY2VlZHMgfCBCdWlsZCBjb21tYW5kOiBl

eGl0IDAgfCBMaW50ZXIgcGFzc2luZywgbG9ncyBsb29rIGdvb2QgfAp8IEJ1

ZyBmaXhlZCB8IFRlc3Qgb3JpZ2luYWwgc3ltcHRvbTogcGFzc2VzIHwgQ29k

ZSBjaGFuZ2VkLCBhc3N1bWVkIGZpeGVkIHwKfCBSZWdyZXNzaW9uIHRlc3Qg

d29ya3MgfCBSZWQtZ3JlZW4gY3ljbGUgdmVyaWZpZWQgfCBUZXN0IHBhc3Nl

cyBvbmNlIHwKfCBBZ2VudCBjb21wbGV0ZWQgfCBWQ1MgZGlmZiBzaG93cyBj

aGFuZ2VzIHwgQWdlbnQgcmVwb3J0cyAic3VjY2VzcyIgfAp8IFJlcXVpcmVt

ZW50cyBtZXQgfCBMaW5lLWJ5LWxpbmUgY2hlY2tsaXN0IHwgVGVzdHMgcGFz

c2luZyB8CgojIyBSZWQgRmxhZ3MgLSBTVE9QCgotIFVzaW5nICJzaG91bGQi

LCAicHJvYmFibHkiLCAic2VlbXMgdG8iCi0gRXhwcmVzc2luZyBzYXRpc2Zh

Y3Rpb24gYmVmb3JlIHZlcmlmaWNhdGlvbiAoIkdyZWF0ISIsICJQZXJmZWN0

ISIsICJEb25lISIsIGV0Yy4pCi0gQWJvdXQgdG8gY29tbWl0L3B1c2gvUFIg

d2l0aG91dCB2ZXJpZmljYXRpb24KLSBUcnVzdGluZyBhZ2VudCBzdWNjZXNz

IHJlcG9ydHMKLSBSZWx5aW5nIG9uIHBhcnRpYWwgdmVyaWZpY2F0aW9uCi0g

VGhpbmtpbmcgImp1c3QgdGhpcyBvbmNlIgotIFRpcmVkIGFuZCB3YW50aW5n

IHdvcmsgb3ZlcgotICoqQU5ZIHdvcmRpbmcgaW1wbHlpbmcgc3VjY2VzcyB3

aXRob3V0IGhhdmluZyBydW4gdmVyaWZpY2F0aW9uKioKCiMjIFJhdGlvbmFs

aXphdGlvbiBQcmV2ZW50aW9uCgp8IEV4Y3VzZSB8IFJlYWxpdHkgfAp8LS0t

LS0tLS18LS0tLS0tLS0tfAp8ICJTaG91bGQgd29yayBub3ciIHwgUlVOIHRo

ZSB2ZXJpZmljYXRpb24gfAp8ICJJJ20gY29uZmlkZW50IiB8IENvbmZpZGVu

Y2Ug4omgIGV2aWRlbmNlIHwKfCAiSnVzdCB0aGlzIG9uY2UiIHwgTm8gZXhj

ZXB0aW9ucyB8CnwgIkxpbnRlciBwYXNzZWQiIHwgTGludGVyIOKJoCBjb21w

aWxlciB8CnwgIkFnZW50IHNhaWQgc3VjY2VzcyIgfCBWZXJpZnkgaW5kZXBl

bmRlbnRseSB8CnwgIkknbSB0aXJlZCIgfCBFeGhhdXN0aW9uIOKJoCBleGN1

c2UgfAp8ICJQYXJ0aWFsIGNoZWNrIGlzIGVub3VnaCIgfCBQYXJ0aWFsIHBy

b3ZlcyBub3RoaW5nIHwKfCAiRGlmZmVyZW50IHdvcmRzIHNvIHJ1bGUgZG9l

c24ndCBhcHBseSIgfCBTcGlyaXQgb3ZlciBsZXR0ZXIgfAoKIyMgS2V5IFBh

dHRlcm5zCgoqKlRlc3RzOioqCmBgYArinIUgW1J1biB0ZXN0IGNvbW1hbmRd

IFtTZWU6IDM0LzM0IHBhc3NdICJBbGwgdGVzdHMgcGFzcyIK4p2MICJTaG91

bGQgcGFzcyBub3ciIC8gIkxvb2tzIGNvcnJlY3QiCmBgYAoKKipSZWdyZXNz

aW9uIHRlc3RzIChUREQgUmVkLUdyZWVuKToqKgpgYGAK4pyFIFdyaXRlIOKG

kiBSdW4gKHBhc3MpIOKGkiBSZXZlcnQgZml4IOKGkiBSdW4gKE1VU1QgRkFJ

TCkg4oaSIFJlc3RvcmUg4oaSIFJ1biAocGFzcykK4p2MICJJJ3ZlIHdyaXR0

ZW4gYSByZWdyZXNzaW9uIHRlc3QiICh3aXRob3V0IHJlZC1ncmVlbiB2ZXJp

ZmljYXRpb24pCmBgYAoKKipCdWlsZDoqKgpgYGAK4pyFIFtSdW4gYnVpbGRd

IFtTZWU6IGV4aXQgMF0gIkJ1aWxkIHBhc3NlcyIK4p2MICJMaW50ZXIgcGFz

c2VkIiAobGludGVyIGRvZXNuJ3QgY2hlY2sgY29tcGlsYXRpb24pCmBgYAoK

KipSZXF1aXJlbWVudHM6KioKYGBgCuKchSBSZS1yZWFkIHBsYW4g4oaSIENy

ZWF0ZSBjaGVja2xpc3Qg4oaSIFZlcmlmeSBlYWNoIOKGkiBSZXBvcnQgZ2Fw

cyBvciBjb21wbGV0aW9uCuKdjCAiVGVzdHMgcGFzcywgcGhhc2UgY29tcGxl

dGUiCmBgYAoKKipBZ2VudCBkZWxlZ2F0aW9uOioqCmBgYArinIUgQWdlbnQg

cmVwb3J0cyBzdWNjZXNzIOKGkiBDaGVjayBWQ1MgZGlmZiDihpIgVmVyaWZ5

IGNoYW5nZXMg4oaSIFJlcG9ydCBhY3R1YWwgc3RhdGUK4p2MIFRydXN0IGFn

ZW50IHJlcG9ydApgYGAKCiMjIFdoZW4gVG8gQXBwbHkKCioqQUxXQVlTIGJl

Zm9yZToqKgotIEFOWSB2YXJpYXRpb24gb2Ygc3VjY2Vzcy9jb21wbGV0aW9u

IGNsYWltcwotIEFOWSBleHByZXNzaW9uIG9mIHNhdGlzZmFjdGlvbgotIEFO

WSBwb3NpdGl2ZSBzdGF0ZW1lbnQgYWJvdXQgd29yayBzdGF0ZQotIENvbW1p

dHRpbmcsIFBSIGNyZWF0aW9uLCB0YXNrIGNvbXBsZXRpb24KLSBNb3Zpbmcg

dG8gbmV4dCB0YXNrCi0gRGVsZWdhdGluZyB0byBhZ2VudHMKCioqUnVsZSBh

cHBsaWVzIHRvOioqCi0gRXhhY3QgcGhyYXNlcwotIFBhcmFwaHJhc2VzIGFu

ZCBzeW5vbnltcwotIEltcGxpY2F0aW9ucyBvZiBzdWNjZXNzCi0gQU5ZIGNv

bW11bmljYXRpb24gc3VnZ2VzdGluZyBjb21wbGV0aW9uL2NvcnJlY3RuZXNz

Cg==

常见问题（FAQ）

使用「Superpowers 完工」这个 skill 能解决什么问题?

本 skill 专注于Superpowers 完工，obra/superpowers 方法论: verification-before-completion。它将相关流程标准化，帮助用户更快拿到可靠结果，减少重复手工操作。

什么情况下适合使用「Superpowers 完工」?

当你需要在Superpowers 完工前自检验证相关工作中获得稳定、可复用的产出时最适合——无论是单次任务还是纳入日常工作流，都能直接调用。

使用「Superpowers 完工」前需要准备什么?

需要一个具体的项目或任务上下文，最好带有代码仓库或需求文档。