Superpowers使用教程
整理版優先睇
Superpowers 係一套令 AI 編碼 Agent 更有紀律嘅開發框架，透過可組合嘅 Skills 強制 Agent 跟足最佳實踐，唔會亂咁生成代碼。
呢篇文章由 Jesse Vincent（GitHub ID: obra，Keyboardio 創始人）同 Prime Radiant 團隊開源嘅 Superpowers 框架出發，介紹點樣令 AI 編程 Agent 由「快」變到「穩」。作者發現現有 AI 編碼工具最大問題係亂咁出 code，所以設計咗一套 Agentic Skills Framework，用 14 個 Skills 覆蓋需求梳理、架構設計、TDD、代碼審查等環節。
整體結論係：Superpowers 嘅核心唔係比 AI 更多能力，而係畀佢紀律。透過漸進式披露同人機協作，確保人類喺決策同審核位保持控制權，同時令 AI 執行有規範。文章仲用一個命令行 TODO 應用做完整演示，由 Brainstorming 到驗收成功，展示點樣一步步完成開發。
- Superpowers 係一套 Skills 框架，唔係單一工具，透過 14 個可組合 Skills 強制 AI 跟足軟件開發方法論。
- 核心設計原則包括：方法論優先、漸進式披露、人機協作、可組合性。
- 工作流程分七個階段：Brainstorming → Git Worktree → Writing Plans → Subagent Development → TDD → Code Review → Finish Branch。
- 每個任務會拆成 2-5 分鐘微任務，並用獨立子 Agent 執行，加上兩階段審查（規格+質量）。
- 最終目標係先理解再編碼，減少返工，保證代碼質量，同時保留人類控制權。
內容結構
1. Brainstorming（頭腦風暴） ↓ 通過問答澄清需求 ↓ 分塊展示設計方案並等待確認 ↓ 人工確認最終設計2. Git Worktree（環境隔離） ↓ 創建獨立的 Git 工作樹3. Writing Plans（任務拆解） ↓ 將任務拆分為 2–5 分鐘的小步驟4. Subagent Development（子智能體開發） ↓ 每個任務啓動獨立子智能體 ↓ 兩階段審查：規範合規 + 代碼質量5. TDD（測試驅動開發） ↓ 按 RED–GREEN–REFACTOR 循環實現6. Code Review（代碼審查） ↓ 對實現進行最終質量檢查7. Finish Branch（完成）Superpowers 係咩？點解值得關注
Superpowers 係由 Jesse Vincent 同 Prime Radiant 團隊開源嘅 Agentic Skills Framework，專為 AI 編程 Agent 設計。佢唔係另一個代碼生成工具，而係一套完整軟件開發工作流系統，透過 可組合嘅 Skills 強制 Agent 跟足最佳實踐。
核心設計理念係：方法論優先於工具、漸進式披露、人機協作同可組合性。AI 負責執行，人類負責決策同審核。
14 個內置 Skill 一覽
Superpowers 提供 14 個 Skills，分四類：核心工作流、開發實踐、協作同元技能。以下係完整清單：
- 核心工作流：brainstorming（蘇格拉底式設計精煉）、writing-plans（每個任務 2-5 分鐘）、subagent-driven-development（獨立子 Agent + 兩階段審查）、executing-plans（批量執行 + 人工檢查點）、finishing-a-development-branch（合併/PR 決策）
- 開發實踐：test-driven-development（RED-GREEN-REFACTOR 循環）、systematic-debugging（四階段根因分析）、verification-before-completion（確保問題被修復）、using-git-worktrees（並行開發分支隔離）
- 協作：dispatching-parallel-agents（併發子 Agent）、requesting-code-review（提交前審查清單）、receiving-code-review（響應審查反饋）
- 元技能：using-superpowers（技能系統入門）、writing-skills（創建新 Skill 的最佳實踐）
完整工作流程：由構思到完成
Superpowers 嘅工作流程分七個階段，每個階段由對應 Skill 驅動。首先係 Brainstorming：Agent 會透過蘇格拉底式提問幫你釐清需求，例如「支援邊啲認證方式？」「Token 用邊種格式？」，最後輸出詳細設計文檔。
設計確認後，進入 Git Worktree 階段：用 git worktree add ../login-worktree -b feature/auth 隔離開發環境，唔使切換分支。跟住 Writing Plans 將任務拆成 2-5 分鐘微任務，每個任務都有明確驗證步驟。
- 1 創建 User 模型同數據庫遷移（2 分鐘）：定義 email, password_hash, created_at，建立 migration，驗證表結構
- 2 任務拆解原則：粒度 2-5 分鐘，每個任務包含驗證步驟，盡量減少依賴
去到 Execution 階段，Superpowers 會用 subagent-driven-development 為每個任務開全新子 Agent：實現者按 TDD 完成 → 規格審查 → 質量審查。之後行 Code Review 同 Finish Branch，最後合併或開 PR。
安裝、快速開始同總結
安裝 Superpowers 好簡單：用 Claude Code 嘅插件市場加，指令係 /plugin marketplace add obra/superpowers-marketplace，之後 /plugin install superpowers@superpowers-marketplace。
- 1 安裝插件後啟動 Claude Code，描述你嘅需求
- 2 回答 AI 嘅澄清問題，確認規格說明
- 3 確認執行，跟住佢會自動行曬成個流程
總結來講，Superpowers 嘅核心價值係：先理解再編碼、漸進式披露避免信息過載、子代理驅動支援長時間工作、TDD 優先保證質量、人機協作保持控制權。呢個框架代表咗 AI 編程助手嘅下一個進化階段：唔係快，而係有紀律。
Superpowers使用教學
等 AI 編程 Agent 有「超能力」
引言 — Superpowers 係啲咩，點解值得關注
Superpowers 係由 Jesse Vincent（GitHub ID: obra，Keyboardio 創辦人）同 Prime Radiant 團隊開源嘅一個 Agentic Skills Framework（代理技能框架）。佢唔係又一個代碼生成工具，而係一套完整嘅軟件開發工作流程系統，通過可組合嘅「技能」（Skills）強制 AI 編碼 Agent 跟從嚴格、可靠嘅軟件開發方法論。
Superpowers 係啲咩
Superpowers 為 AI 編程智能體（例如 Claude Code、Cursor、Codex、OpenCode）提供咗一套完整嘅軟件開發工作流程。佢唔係單一技能，而係由 14 個可組合 Skills 組成嘅系統化工作流程，覆蓋需求梳理、架構設計、測試驅動開發、代碼審查同分支管理等開發環節。
佢嘅核心思路，係通過一組可組合嘅 Skills 和初始指令，令 AI 智能體喺寫代碼嗰陣自動跟隨最佳實踐，而唔係隨意生成代碼。
核心設計理念
Superpowers 嘅設計基於幾個核心原則：
方法論優先過工具：唔係畀 AI 更多能力，而係畀佢紀律 漸進式披露（Progressive Disclosure）：分階段展示資訊，避免資訊過載 人機協作：AI 負責執行，人類負責決策同審核 可組合性：Skills 可以好似 LEGO 積木咁自由組合
14 個內置 Skill 一覽
| 類別 | Skill 名稱 | 功能 |
|---|---|---|
| 核心工作流程 | brainstorming | 蘇格拉底式設計精煉，喺寫代碼前先理清需求 |
| 核心工作流程 | writing-plans | 創建詳細執行計劃，每個任務 2-5 分鐘 |
| 核心工作流程 | subagent-driven-development | 每個任務分配獨立子 Agent + 兩階段審查 |
| 核心工作流程 | executing-plans | 批量執行，有人工檢查點 |
| 核心工作流程 | finishing-a-development-branch | 合併/PR 決策工作流程 |
| 開發實踐 | test-driven-development | 嚴格嘅 RED-GREEN-REFACTOR 循環 |
| 開發實踐 | systematic-debugging | 四階段根因分析流程 |
| 開發實踐 | verification-before-completion | 確保問題真正被修復 |
| 開發實踐 | using-git-worktrees | 並行開發分支隔離 |
| 協作 | dispatching-parallel-agents | 併發子 Agent 工作流程 |
| 協作 | requesting-code-review | 提交前審查清單 |
| 協作 | receiving-code-review | 回應審查反饋 |
| 元技能 | using-superpowers | 技能系統入門 |
| 元技能 | writing-skills | 創建新 Skill 嘅最佳實踐 |
完整流程
1. Brainstorming（頭腦風暴）
↓ 通過問答澄清需求
↓ 分塊展示設計方案並等待確認
↓ 人工確認最終設計
2. Git Worktree（環境隔離）
↓ 創建獨立的 Git 工作樹
3. Writing Plans（任務拆解）
↓ 將任務拆分為 2–5 分鐘的小步驟
4. Subagent Development（子智能體開發）
↓ 每個任務啓動獨立子智能體
↓ 兩階段審查：規範合規 + 代碼質量
5. TDD（測試驅動開發）
↓ 按 RED–GREEN–REFACTOR 循環實現
6. Code Review（代碼審查）
↓ 對實現進行最終質量檢查
7. Finish Branch（完成）
關鍵階段深度解析
階段1：腦力激盪（Brainstorming）
呢個係 Superpowers 工作流程嘅第一步，佢要求先完成設計，先至進入執行階段。
當你同 Agent 講幫我完成一個功能嗰陣，Superpowers 唔會叫佢直接寫代碼，而係會激活Brainstorming Skill 技能，Agent 通過蘇格拉底式提問嚟精煉你嘅需求。
對於頭腦風暴階段，當然也可以手動觸發該技能；
/superpowers:brainstorming 幫我實現某某個功能；
AI: "這個登錄功能需要支持哪些認證方式？"
User: "用戶名密碼+手機號驗證碼"
AI: "Token使用什麼方式？"
結束對話後，會輸出一個詳細的設計文檔
階段2：Git WorkTree（環境隔離）
喺呢個階段，Superpowers 用 git worktree 嚟隔離開發環境，而唔係靠傳統嘅切換分支嚟操作
# Worktree 方式
git worktree add ../login-worktree -b feature/auth
cd ../login-worktree
階段3：任務拆解寫計劃（Writing Plans）
設計通過之後，writing-plans Skill 激活。佢會將工作拆分做 2-5 分鐘嘅微任務，每個任務包含：
# Task 1: 創建 User 模型和數據庫遷移 (2 分鐘)
- 定義 User 模型（email, password_hash, created_at）
- 創建數據庫遷移文件
- 運行遷移並驗證表結構
驗證步驟：
- [ ] 數據庫中存在 users 表
- [ ] 表包含所有必需字段
任務拆解嘅基本原則：
任務粒度控制在 2–5 分鐘，更大嘅任務需要繼續拆 每個任務都包含明確嘅驗證步驟（可測試） 儘量減少任務之間嘅依賴關係，方便並行執行
階段4：執行（Execution）
呢個係 Superpowers 最創新嘅部分。進入呢個階段之後，會確定係咪用subagent-driven-development Skill 為每個任務分配一個全新嘅子 Agent：
分派實現者子 Agent（全新上下文，無污染） 實現者按照 TDD 流程完成任務 分派規格審查子 Agent — 確認代碼符合計劃規格 分派質量審查子 Agent — 檢查代碼質量 標記任務完成 進入下一個任務
完整工作流程演示
場景：開發一個命令行 TODO 應用
等我哋透過一個實際案例，展示 Superpowers 嘅完整工作流程。
第一步：需求輸入
/superpowers:brainstorm 我想做一個命令行 TODO 應用，支持添加、完成、刪除任務
第二步：編寫執行計劃
Superpowers：
當第一步需求被批准後，然後則開始拆解任務並生成實現計劃
## 實施計劃
### 任務 1：項目初始化
- 創建項目目錄
- 初始化 Git 倉庫
- 創建基礎結構
### 任務 2：數據模型
- 定義 Task 類
- 實現 JSON 序列化
### 任務 3：存儲層
- 實現 TodoStore 類
- 文件讀寫操作
### 任務 4：CLI 界面
- 使用 argparse
- 實現子命令
第三步：執行計劃
Superpowers（啓動子代理執行各任務）：
[子代理 1] 執行任務 1：項目初始化
✅ 完成：創建了 cli_todo/ 目錄結構
[子代理 2] 執行任務 2：數據模型
✅ 完成：實現了 Task 類
第五步：驗收成功
項目完成總結：
你的應用已經完成開發
當前狀態：
所有任務均完成；
代碼已提交到git
文檔已完成
安裝同快速開始
安裝方式
Claude Code：
# 一、插件加入市場
/plugin marketplace add obra/superpowers-marketplace
# 二、安裝插件
/plugin install superpowers@superpowers-marketplace
快速開始
安裝 Superpowers 插件 啟動 Claude Code 描述你嘅需求 回答 AI 嘅澄清問題 確認規格說明 確認執行
總結
Superpowers 代表咗 AI 編程助手嘅下一個進化階段：唔係令 AI 更快咁寫代碼，而係令佢更加有紀律咁開發軟件。
核心價值：
理解完先編碼，減少返工 漸進式披露，避免資訊過載 子代理驅動，支持長時間工作 TDD 優先，保證代碼質素 人機協作，保持人類控制權
Superpowers使用教程
讓 AI 編程 Agent 擁有"超能力"
引言 — Superpowers 是什麼，為什麼值得關注
Superpowers 是由 Jesse Vincent（GitHub ID: obra，Keyboardio 創始人）和 Prime Radiant 團隊開源的一個 Agentic Skills Framework（代理技能框架）。它不是又一個代碼生成工具，而是一套完整的軟件開發工作流系統，通過可組合的"技能"（Skills）強制 AI 編碼 Agent 遵循嚴格、可靠的軟件開發方法論。
什麼是Superpowers
Superpowers 為 AI 編程智能體（如 Claude Code、Cursor、Codex、OpenCode）提供了一套完整的軟件開發工作流程。它不是單一技能，而是由 14 個可組合 Skills 組成的系統化工作流，覆蓋需求梳理、架構設計、測試驅動開發、代碼審查和分支管理等開發環節。
它的核心思路，是通過一組可組合的 Skills 和初始指令，讓 AI 智能體在編寫代碼時自動遵循最佳實踐，而不是隨意生成代碼。
核心設計理念
Superpowers 的設計基於幾個核心原則：
方法論優先於工具：不是給 AI 更多能力，而是給它紀律 漸進式披露（Progressive Disclosure）：分階段展示信息，避免信息過載 人機協作：AI 負責執行，人類負責決策和審核 可組合性：Skills 可以像樂高積木一樣自由組合
14 個內置 Skill 一覽
| 類別 | Skill 名稱 | 功能 |
|---|---|---|
| 核心工作流 | brainstorming | 蘇格拉底式設計精煉，在寫代碼前先理清需求 |
| 核心工作流 | writing-plans | 創建詳細實施計劃，每個任務 2-5 分鐘 |
| 核心工作流 | subagent-driven-development | 每個任務分配獨立子 Agent + 兩階段審查 |
| 核心工作流 | executing-plans | 批量執行，帶人工檢查點 |
| 核心工作流 | finishing-a-development-branch | 合併/PR 決策工作流 |
| 開發實踐 | test-driven-development | 嚴格的 RED-GREEN-REFACTOR 循環 |
| 開發實踐 | systematic-debugging | 四階段根因分析流程 |
| 開發實踐 | verification-before-completion | 確保問題真正被修復 |
| 開發實踐 | using-git-worktrees | 並行開發分支隔離 |
| 協作 | dispatching-parallel-agents | 併發子 Agent 工作流 |
| 協作 | requesting-code-review | 提交前審查清單 |
| 協作 | receiving-code-review | 響應審查反饋 |
| 元技能 | using-superpowers | 技能系統入門 |
| 元技能 | writing-skills | 創建新 Skill 的最佳實踐 |
完整流程
1. Brainstorming（頭腦風暴）
↓ 通過問答澄清需求
↓ 分塊展示設計方案並等待確認
↓ 人工確認最終設計
2. Git Worktree（環境隔離）
↓ 創建獨立的 Git 工作樹
3. Writing Plans（任務拆解）
↓ 將任務拆分為 2–5 分鐘的小步驟
4. Subagent Development（子智能體開發）
↓ 每個任務啓動獨立子智能體
↓ 兩階段審查：規範合規 + 代碼質量
5. TDD（測試驅動開發）
↓ 按 RED–GREEN–REFACTOR 循環實現
6. Code Review（代碼審查）
↓ 對實現進行最終質量檢查
7. Finish Branch（完成）
關鍵階段深度解析
階段1：頭腦風暴（Brainstorming）
這是Superpowers工作流中的第一步，它要求先完成設計，在進入實施階段。
當你告訴Agent幫我完成一個功能時，superpower不會讓它直接寫代碼，會激活Brainstorming skill技能，Agent通過蘇格拉底式提問來精煉你的需求。
對於頭腦風暴階段，當然也可以手動觸發該技能；
/superpowers:brainstorming 幫我實現某某個功能；
AI: "這個登錄功能需要支持哪些認證方式？"
User: "用戶名密碼+手機號驗證碼"
AI: "Token使用什麼方式？"
結束對話後，會輸出一個詳細的設計文檔
階段2：Git WorkTree（環境隔離）
在這個階段，superpower使用git worktree來隔離開發環境，而不是依賴傳統的切換分支進行操作
# Worktree 方式
git worktree add ../login-worktree -b feature/auth
cd ../login-worktree
階段3：任務拆解寫計劃（Writing Plans）
設計通過後，writing-plans Skill 激活。它會將工作拆分為 2-5 分鐘的微任務，每個任務包含：
# Task 1: 創建 User 模型和數據庫遷移 (2 分鐘)
- 定義 User 模型（email, password_hash, created_at）
- 創建數據庫遷移文件
- 運行遷移並驗證表結構
驗證步驟：
- [ ] 數據庫中存在 users 表
- [ ] 表包含所有必需字段
任務拆解的基本原則：
任務粒度控制在 2–5 分鐘，更大的任務需要繼續拆分 每個任務都包含明確的驗證步驟（可測試） 儘量減少任務之間的依賴關係，便於並行執行
階段4：執行（Execution）
這是 Superpowers 最具創新性的部分。進入當前階段後，確實是否使用subagent-driven-development Skill 為每個任務分配一個全新的子 Agent：
分派實現者子 Agent（全新上下文，無污染） 實現者按照 TDD 流程完成任務 分派規格審查子 Agent — 確認代碼符合計劃規格 分派質量審查子 Agent — 檢查代碼質量 標記任務完成 進入下一個任務
完整工作流演示
場景：開發一個命令行 TODO 應用
讓我們通過一個實際案例，展示 Superpowers 的完整工作流程。
第一步：需求輸入
/superpowers:brainstorm 我想做一個命令行 TODO 應用，支持添加、完成、刪除任務
第二步：編寫實現計劃
Superpowers：
當第一步需求被批准後，然後則開始拆解任務並生成實現計劃
## 實施計劃
### 任務 1：項目初始化
- 創建項目目錄
- 初始化 Git 倉庫
- 創建基礎結構
### 任務 2：數據模型
- 定義 Task 類
- 實現 JSON 序列化
### 任務 3：存儲層
- 實現 TodoStore 類
- 文件讀寫操作
### 任務 4：CLI 界面
- 使用 argparse
- 實現子命令
第三步：執行計劃
Superpowers（啓動子代理執行各任務）：
[子代理 1] 執行任務 1：項目初始化
✅ 完成：創建了 cli_todo/ 目錄結構
[子代理 2] 執行任務 2：數據模型
✅ 完成：實現了 Task 類
第五步：驗收成功
項目完成總結：
你的應用已經完成開發
當前狀態：
所有任務均完成；
代碼已提交到git
文檔已完成
安裝與快速開始
安裝方式
Claude Code：
# 一、插件加入市場
/plugin marketplace add obra/superpowers-marketplace
# 二、安裝插件
/plugin install superpowers@superpowers-marketplace
快速開始
安裝 Superpowers 插件 啓動 Claude Code 描述你的需求 回答 AI 的澄清問題 確認規格說明 確認執行
總結
Superpowers 代表了 AI 編程助手的下一個進化階段：不是讓 AI 更快地寫代碼，而是讓它更有紀律地開發軟件。
核心價值：
先理解再編碼，減少返工 漸進式披露，避免信息過載 子代理驅動，支持長時間工作 TDD 優先，保證代碼質量 人機協作，保持人類控制權