verification-before-completion 是什麼、怎麼用：Superpowers「先拿證據再說完成」的 Skill

本文根據 obra/superpowers 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 23.3 萬次；所在倉庫 obra/superpowers 在 GitHub 約 29.7 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

「已修復，所有測試通過。」——然後你一跑，紅了一片。智能體並不總是在撒謊，它常常是根據「我改了代碼，所以應該好了」推斷出來的。verification-before-completion 只管一件事：不許推斷。description：即將聲稱工作已完成、已修復或已通過時，在提交或創建 PR 之前使用；要求運行驗證命令並確認輸出之後才能做任何成功聲明，永遠是證據先於斷言。

「鐵律」是：如果你沒有在這條消息裏運行過驗證命令，就不能說它通過。配套的「關卡函數」規定了開口之前的步驟：確定哪條命令能證明這個說法 → 完整運行它 → 讀全部輸出和退出碼 → 輸出確實支持結論才可以陳述，並且要附上證據。

說明裏有一張對照表，把常見說法、需要的證據和「不算數的東西」並排列出，例如：說「測試通過」需要測試命令輸出零失敗，上一次運行的結果或「應該能過」不算；說「構建成功」需要構建命令退出碼為 0，代碼檢查通過不算；說「bug 修好了」需要重新測試原始症狀，「代碼改了」不算。還列了一批危險信號詞——「應該」「大概」「看起來」——出現就該停下來去驗證。

怎麼安裝

verification-before-completion 是 Superpowers 插件裏的一個技能，不單獨發佈：作者的設計是整套一起安裝，由會話開始時注入的引導指令決定各技能何時觸發。Claude Code 裏輸入（命令來自倉庫 README）：

text
/plugin install superpowers@claude-plugins-official

Codex 在 /plugins 裏搜尋 superpowers 安裝；Gemini CLI 用 gemini extensions install https://github.com/obra/superpowers。裝好後在命令選單裏以 /superpowers:verification-before-completion 的形式出現，也會按場景自動觸發。

倉庫整體介紹和其他安裝方式，詳見本站《Superpowers 是什麼、怎麼安裝和使用：Claude Code / Codex 最熱門的 Skills 開發流程框架》。

怎麼用

• 平時無需調用，它會在智能體準備彙報完成時自動生效；你會注意到它的總結裏附帶了實際的命令輸出。
• 懷疑它沒驗證時：「按 verification-before-completion，重新跑一遍並貼出結果」。
• 也適用於子智能體的彙報：主會話不能只憑「子智能體說做完了」就轉述成功。

這個技能只有一份很短的 SKILL.md。

適合誰 / 侷限

幾乎適合所有讓智能體改代碼的人，是整套 Superpowers 裏最容易單獨見效的一個。前提是項目裏存在可運行的驗證手段（測試、構建、檢查腳本）；沒有的話它只能如實說「無法驗證」。它保證的是「說的和跑的一致」，不保證測試本身覆蓋了該測的東西。

注意事項

• 許可：MIT。
• 會重複運行命令：驗證命令耗時很長的項目，可以告訴它哪條是最小充分驗證。
• 不執行額外腳本，也不聯網。