Superpowers Skill - 讓 Claude Code 和 Codex 按工程流程做開發

Superpowers Skill 唔係普通提示詞，而係一套「流程約束」。佢嘅目的係令 AI coding agent 唔再亂嚟：每次做複雜任務前，先跟住預設嘅步驟行——例如 先澄清需求、制定可驗證計劃、測試先行、系統性調試、完成前驗證。呢啲步驟唔係靠用家每次提醒，而係沉澱喺 Skill 文件入面，agent 會自動 load 相應嘅 workflow。

Superpowers 將開發任務拆成多個獨立 Skill，每個負責一個環節，例如 brainstorming（需求唔清時用）、writing-plans（將方案變做可執行步驟）、test-driven-development（新功能用 TDD）、systematic-debugging（修 bug 要追根因）、verification-before-completion（完成前一定要驗證）。呢啲 Skill 可以組合用，覆蓋由需求討論到 final 收尾嘅完整鏈路。

冇 Skill 嗰陣，agent 好多時會直接「估」答案：修 bug 靠經驗猜 patch，新功能直接寫 code 然後先發現理解錯。用咗 Superpowers 之後，agent 會自動行一套 系統化流程：先問清楚、再計劃、再測試、再驗證。呢種轉變唔會令代碼一定啱，但會大幅減少「流程型錯誤」——即係 冇問清楚就做、冇計劃就大改、冇測試就話搞掂、冇揾根因就修補、冇 review 就 merge。

喺 Claude Code 入面，可以經官方插件市場安裝 Superpowers：輸入 <code>/plugin install superpowers@claude-plugins-official</code>。如果要用 Superpowers 自家 marketplace，就先註冊再安裝。裝好之後，agent 會自動根據任務類型觸發對應 Skill——例如你話「幫我修 bug」，佢就會加載 systematic-debugging，先列根因假設，先唔改 code。重點係：Skill 檢查要發生喺行動之前，即係 agent 唔應該先讀文件先改 code，而係先判斷有冇適用 Skill。

Codex 嘅安裝類似，入 Codex CLI 打 <code>/plugins</code> 搜尋 superpowers 然後安裝；或者喺 Codex App 側邊欄 Plugins 嘅 Coding 分類揾到 Superpowers。用法都係一樣：裝完插件後，讓 Superpowers 嘅 Skills 參與當前會話。例如你可以打「使用 Superpowers 嘅 writing-plans，先幫我寫一份重構計劃，等我確認先再實現」。咁樣可以減少 agent 誤判任務類型 嘅機會。

假設我要喺 Web 項目加「用戶導出賬單」功能。冇 Superpowers 嗰陣 agent 可能直接生成接口、按鈕同下載邏輯。有咗 Superpowers，合理流程係：第一步：Brainstorming——先問清楚導出格式、數據範圍、權限、同步定異步、大數據量處理、失敗訊息。呢步唔係拖慢進度，而係避免返工。第二步：Writing Plans——將方案拆成有文件邊界同驗證方式嘅任務，例如「喺 billing service 加 exportInvoiceCsv，驗證：單元測試覆蓋空數據、正常數據、越權訪問」。第三步：TDD——先寫失敗測試鎖住行為，再用最小實現通過測試。第四步：Code Review——重點檢查計劃符合度、越權風險、大數據量問題、錯誤狀態覆蓋、有冇改動唔相關文件。第五步：Verification——最後一步唔可以剩係「測試通過」，要真正行開發伺服器或用瀏覽器走關鍵路徑。

import { describe, expect, it } from "vitest";
import { exportInvoiceCsv } from "./billing-export";

describe("exportInvoiceCsv", () => {
 it("exports invoices as csv rows", () => {
 const csv = exportInvoiceCsv([
 { id: "inv_001", amount: 1999, currency: "USD" },
 { id: "inv_002", amount: 2999, currency: "USD" },
 ]);
 // 先用測試固定輸出格式，避免實現時隨意漂移
 expect(csv).toContain("id,amount,currency");
 expect(csv).toContain("inv_001,1999,USD");
 expect(csv).toContain("inv_002,2999,USD");
 });
});

另外要搞清楚 Skill、Memory 同 Plan 嘅分別：Skill 規定「點做」某類任務，跨會話複用；Memory 記錄用戶偏好同項目背景，跨會話持久；Plan 係當前任務嘅執行步驟，有效期得今次任務。三者夾埋先令 agent 行為又穩定又貼合項目。常見誤區包括：「有 Skill 就唔洗寫清楚需求」、「Skill 越多越好」、「裝咗插件 agent 就自動跟流程」。正確做法係喺關鍵任務開頭明確要求用邊個 Skill，例如「請用 systematic-debugging，先列根因假設，逐項驗證，先唔好改 code」。