AIDive

影片資料包

Claude Code 的 Superpowers：判定表、來源、檢查清單與延伸閱讀指南

閱讀約 9 分鐘

TL;DR

  • Superpowers 是一套流程，不是工具箱：十四個 markdown 技能，把每個功能都擋在一場腦力激盪、一份書面計畫，以及一串各自接受審查的全新子代理之後。
  • 如果你的 Claude Code 工作階段是在做要花上好幾小時的功能，就裝。如果你主要是寫用完即丟的腳本和兩行修正，就跳過：入口檢查會在每個任務上執行，而且關不掉。
  • 省 token 的說法是真的，但它只來自一個技能的一個段落：Model Selection。協調者會指派能勝任該角色的最便宜模型，所以昂貴的模型只會碰架構和最後的分支審查。
  • 這個儲存庫很健康：280,597 顆星、25,138 個 fork、main 上 681 個 commit、2026-08-12 發布的 v6.3.0，建立於 2025-10-09。
  • 引出這支影片的抱怨，也就是使用量統計只有 1 到 3%，並不是 bug：它代表這些技能從來沒有在你的工作上被觸發，所以你付了關卡的成本，卻什麼都沒拿到。
  • 折衷做法就是在提示裡加一句話：叫代理在小修正上跳過流程，並先只讓 brainstorming 跑幾天，再決定要不要採用其餘部分。

資料來源怎麼說

儲存庫的數字是在 2026-09-02 讀取的：280,597 顆星、25,138 個 fork、main 分支上 681 個 commit，main 上最後一個 commit 的日期是 2026-08-12（v6.3.0），另外在 2026-08-31 有一次推送到非 main 的分支 s1。當天 Issues 分頁顯示 125 個未結 issue；API 給的 350 這個數字把 225 個未結 pull request 也算進去了，所以和其他外掛比較時，請引用分頁上的數字，不要引用 API 的數字 s6。這個專案建立於 2025-10-09，內含十四個技能 s2。作者的發表文章用一句話說明了這個賭注：程式代理缺的不是能力，而是紀律，而這份紀律可以用任何人都能讀、能 fork、能編輯的純 markdown 檔案來散布 s5。這個外掛已上架官方 marketplace，所以安裝只要一個指令，更新也跟著 marketplace 走 s4。

入口是一個由 session-start hook 最先載入的技能。它告訴代理：只要對某個技能是否適用有一絲懷疑，就必須在回答或寫程式之前先載入並檢查。這條規則同時是好處和固定成本的來源 s14。

Brainstorming 以一道 HARD-GATE 開場：在你確認一個明確的意圖之前，不寫程式、不建骨架、不使用任何實作技能。接著它把請求分到三條路徑之一：spike，產出是答案而不是程式碼時；bounded，在儲存庫現有流程內的小改動；architectural，任何會重組專案的改動。代理會宣告它的分類，讓你可以反駁，而且這個棘輪只往一個方向轉：任務中途發現隱藏的複雜度，路徑只會往上調，不會往下調 s9。

撰寫計畫的技能要求，計畫要寫給一位勝任、但對你的程式碼庫毫無背景的開發者，用檔案自己的話說，是品味堪憂的開發者。工作被切成一個個任務，每一步只花兩到五分鐘：寫出會失敗的測試、執行並確認它失敗、寫最少的程式碼、再跑一次測試、commit。每個任務都列出要建立或修改的確切檔案，細到行號，計畫開頭則是一段必填的標頭 s10。

執行由子代理驅動開發技能負責：每個任務一個全新的子代理，每個任務之後做一次審查，最後做一次整個分支的審查。主工作階段停止寫程式，改為派工。每個子代理只拿到自己任務的上下文，絕不會拿到你的工作階段歷史，這讓你自己的視窗保持空出來做協調。子代理實作、測試、commit 並自我審查之後，協調者會跑兩段式審查，先看規格符合度，再看程式碼品質，而且每個任務都保留一個審查者席位。檔案規定每個任務的迴圈最多五輪 s11。工作本身的隔離則交給 worktree 技能處理，所以計畫絕不會在你目前的 checkout 上執行 s13。

Model Selection 段落以一條規則開頭：用能勝任該角色的最弱模型。規格清楚、只動一兩個檔案的機械性任務交給小模型；當計畫裡已經包含要寫的程式碼時，實作就只是抄寫加測試，所以最便宜的等級就夠了。跨多個檔案的協調和除錯交給標準模型。架構和最後的分支審查則要求可用的最強模型。實務上有兩個細節很重要：派工時一律明確指定模型，並且在選模型之前，讓協調者先評估每個任務的難度 s12。這就是讓昂貴模型在每月二十美元的 Pro 方案上也負擔得起的機制：它只處理值得它處理的決策。

文件上的收穫是流程的副產品。規格和計畫不是會消失的聊天訊息，而是存進儲存庫、隨工作一起 commit 的 markdown 檔案，所以日後的審查者讀得到一個改動為什麼被做，而不只是改了什麼 s3。

成本是儲存庫不會宣傳的那一塊。引出這支影片的討論串回報使用量統計只有 1 到 3%，並問除了不用之外還有什麼缺點 s7。檔案裡的答案是：brainstorming 會依任務大小調整儀式的份量，但從不跳過人工確認 s9。即使只是兩行修正，你還是得回答框定問題、核准一份兩句話的設計，並等完整個週期跑完。派工簡報、每個任務兩次審查，以及追蹤帳本，都是每次都要付的 token，在最小的任務上最明顯。使用量統計偏低，代表技能和你的工作對不上，這才是該讀的真正訊號。

依使用情境的判定

你的 Claude Code 使用方式 要裝嗎？ 原因
要花數小時、涉及多個檔案、需要開分支的功能 要 框定可以避免做錯東西，短任務讓代理遠離上下文飽和，模型選擇讓額度用得更久，文件則自然從流程裡長出來
混合：有些日子做功能，多數日子做修正 要，並加上跳過規則 功能保留關卡，並在提示裡叫代理在小修正上跳過流程
用完即丟的腳本、設定檔錯字、兩行修正 不要 關卡的固定成本會花在根本不需要它的任務上
好奇，但還沒準備好採用整套方法 只用 brainstorming 它帶來大部分的收穫；其他技能之後可以自然接上

週一要做的事

  • 從官方 marketplace 安裝，然後打開外掛快取：把十四個 SKILL.md 檔案讀過一遍，它們很短，而且它們就是整個產品。
  • 讓一個真正的功能完整走過關卡：brainstorming、計畫、子代理派工、分支審查。用這個來評斷流程，不要用修正來評斷。
  • 一週後檢查你的使用量統計。如果低於幾個百分點，代表技能和你的工作對不上：不是你的任務太小，就是你需要把請求改寫成功能的形式。
  • 在專案指示裡加一條跳過規則：單一檔案、只改幾行的修正，直接改，不要 brainstorming。
  • 即使你不用這個外掛，也把 Model Selection 階梯複製到你自己的子代理提示裡：每次派工都明確指定模型。
  • 把外掛寫出的規格和計畫 commit 起來，不要刪掉；它們就是你的設計紀錄。
  • 在拿這個專案和其他外掛比較之前，請在 Issues 分頁數未結 issue 的數量，不要用 API 的數字。

延伸閱讀

  • 在讀技能檔案之前，先讀發表文章了解設計意圖：它說明了為什麼紀律是以 markdown 而不是程式碼的形式散布 s5。
  • README 的 philosophy 段落是這套方法的簡短版，也是檢查它是否符合你既有工作方式的地方 s3。
  • 技能庫段落列出十四個技能，各附一行用途；比瀏覽目錄更快 s16。
  • 子代理技能規定每個任務最多五輪，這是一個值得抄進你手寫的任何協調流程的硬性停止條件 s11。
  • 有一個討論串在問這類外掛在更強的模型下是否還能存活；能存活的是框定關卡和被 commit 的計畫，會被模型吸收掉的是那些機制 s19。
  • 有人回報每週使用額度被協調儀式燒光，這是在小型工作上採用它之前該讀的反例 s20。
  • 與另一套競爭指令集的比較展現了取捨：少而嚴格的技能，對上龐大的規則目錄 s18。
  • 未結 issue 清單是了解目前其他使用者遇到什麼問題最快的方式 s6。

來源

FAQ

Superpowers 是省 token 還是燒 token？

兩者都是。在功能開發上，模型選擇會把機械性任務送給小模型，把昂貴模型留給架構和分支審查，所以額度能用更久。在小修正上，簡報、每個任務兩次審查和帳本都是純粹的額外負擔。

使用量統計 1 到 3% 代表什麼？

技能只有在情境符合時才會觸發。數字偏低代表你的任務不屬於這個外掛所謂的功能，所以你付了入口檢查的成本，卻從來沒走到有回報的那一段。

我可以只保留一部分嗎？

可以。只用 brainstorming 就能拿到大部分收穫，而 Model Selection 階梯在任何手寫的子代理提示裡都能運作。叫代理在小修正上跳過流程，你就能保有掌控。