Superpowers Skill vs. Claude Code Plan Mode:完整比較研究
1. 執行摘要
Superpowers 是由 Jesse Vincent (obra) 開發的第三方 Claude Code plugin,提供一整套「軟體開發工作流技能(skills)」,涵蓋從腦力激盪、計畫撰寫、TDD、除錯、到 code review 的完整開發生命週期。它透過強制性的流程紀律(如:寫 code 前必須先寫 failing test)來確保程式碼品質。
Plan Mode 是 Claude Code CLI 的內建功能,透過限制 Claude 為「唯讀研究模式」來分離「分析規劃」與「程式碼執行」兩個階段。它是一個輕量級的操作模式切換,讓開發者在 Claude 動手改 code 之前,先看到完整的計畫並確認方向。
關鍵差異:Superpowers 是一套「開發方法論」,Plan Mode 是一個「操作模式」。兩者解決不同層次的問題,不僅可以疊加使用,而且互補效果顯著。
2. 功能對照表
| 維度 | Superpowers (v4.1.1) | Plan Mode (內建) |
|---|---|---|
| 本質 | 第三方 plugin(技能系統) | 內建操作模式 |
| 作者 | Jesse Vincent (obra) | Anthropic 官方 |
| 安裝方式 | /plugin marketplace add + /plugin install | 內建,無需安裝 |
| 啟用方式 | 自動觸發(skill 偵測到適用場景) | Shift+Tab ×2 / --permission-mode plan / 設定檔 |
| 核心目標 | 完整開發工作流管理 | 分離研究規劃與執行 |
| 範圍 | 14 個技能覆蓋整個 SDLC | 單一操作模式 |
| 工具限制 | 不限制工具,靠流程紀律控制 | 限制寫入工具(Edit, Write, Bash, NotebookEdit) |
| 計畫格式 | 結構化 markdown,含完整程式碼、檔案路徑、測試命令 | 自由格式 markdown (plan.md) |
| 計畫粒度 | 每步驟 2-5 分鐘,bite-sized tasks | 由使用者/Claude 自行決定 |
| TDD 強制 | 是(Iron Law:No production code without failing test) | 否 |
| Code Review | 內建兩階段 review(spec compliance + code quality) | 無 |
| Subagent 支援 | 專門的 subagent-driven-development 流程 | 可搭配 Task tool 使用 |
| Git 整合 | 內建 worktree 管理、分支完成流程 | 無特定 Git 流程 |
| 除錯流程 | 四階段系統化除錯(Phase 1-4) | 無特定除錯方法 |
| 驗證機制 | verification-before-completion(Iron Law:無驗證不得宣稱完成) | 使用者手動確認 plan |
| 學習曲線 | 中-高(需理解整套工作流) | 低(模式切換即可) |
| 效能影響 | 較多 token 消耗(多重 review + subagent) | 較少 token(唯讀操作速度快) |
| 適用規模 | 中大型功能開發 | 任何規模,特別適合探索與規劃 |
3. 詳細功能分析
3.1 Superpowers Skill 系統
架構概覽
Superpowers 由 14 個相互連結的 skills 組成,形成一條完整的開發流水線:
brainstorming → using-git-worktrees → writing-plans → subagent-driven-development / executing-plans
↕ ↓
設計文件 test-driven-development
↓
requesting-code-review
↓
finishing-a-development-branch
核心技能詳解
1. brainstorming(腦力激盪)
- 觸發時機:任何創意工作開始前
- 工作方式:一次一個問題,偏好選擇題,200-300 字分段呈現設計
- 輸出:
docs/plans/YYYY-MM-DD-<topic>-design.md
2. writing-plans(撰寫計畫)
- 假設執行者「零上下文、品味堪憂」
- 每步驟 2-5 分鐘,含完整程式碼、精確檔案路徑、預期輸出
- 嚴格遵循 DRY、YAGNI、TDD 原則
3. subagent-driven-development(子代理驅動開發)
- 每個 task 派遣全新 subagent(避免 context 污染)
- 兩階段 review:先 spec compliance,再 code quality
- 支援 subagent 提問機制
4. test-driven-development(測試驅動開發)
- Iron Law:「沒有 failing test 就不能寫 production code」
- 寫了 code 才寫 test?刪掉重來
- 強制 Red-Green-Refactor 循環
5. systematic-debugging(系統化除錯)
- 四階段:Root Cause → Pattern Analysis → Hypothesis Testing → Implementation
- 嘗試 3 次修復失敗 → 質疑架構(不是繼續 patch)
6. verification-before-completion(完成前驗證)
- Iron Law:「沒有新鮮的驗證證據就不能宣稱完成」
- 禁止使用 "should", "probably", "seems to"
7. using-superpowers(系統入口)
- 強制在每次對話開始時檢查適用 skills
- 「即使只有 1% 的可能性適用,也必須調用」
安裝與使用
# 安裝
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
# 驗證
/help # 應看到 /superpowers:brainstorm 等指令
# 使用 — 自動觸發,無需手動啟用
# 或手動調用:
/superpowers:brainstorm
/superpowers:write-plan
/superpowers:execute-plan
3.2 Claude Code Plan Mode
運作機制
Plan Mode 本質上是一個「工具權限切換」,透過 system prompt 注入指令,限制 Claude 只能使用唯讀工具:
允許的工具(唯讀):
- Read(讀取檔案)
- Glob(檔案搜尋)
- Grep(內容搜尋)
- WebFetch / WebSearch(網路搜尋)
- Task(研究型 subagent)
- TodoWrite(任務追蹤)
- AskUserQuestion(向使用者提問)
禁止的工具(修改型):
- Edit / Write(檔案編輯)
- Bash(命令執行)
- NotebookEdit(Notebook 編輯)
- 任何會修改狀態的 MCP 工具
啟用方式
# 方式 1:Session 內切換
# Shift+Tab → Auto-Accept Mode
# Shift+Tab → Plan Mode(顯示 ⏸ plan mode on)
# 方式 2:啟動時指定
claude --permission-mode plan
# 方式 3:Headless 模式
claude --permission-mode plan -p "分析認證系統並建議改進方案"
# 方式 4:設為預設
# .claude/settings.json
{
"permissions": {
"defaultMode": "plan"
}
}
工作流程
根據 Armin Ronacher 的分析,Plan Mode 實際上是圍繞一個 markdown 文件運作的:
- Phase 1 - 初步理解:探索程式碼,提出釐清問題
- Phase 2 - 設計:規劃實作方式
- Phase 3 - 審查:驗證方向正確
- Phase 4 - 最終計畫:寫出簡潔、可執行的計畫
計畫寫入檔案後,Claude 調用 ExitPlanMode 工具,等待使用者批准後,才會讀取計畫檔案並開始執行。
特色功能
- Ctrl+G:在預設編輯器中打開計畫文件,直接編輯後讓 Claude 繼續
- Opus Plan Mode:用 Opus 做規劃,用 Sonnet 做執行(透過
/model選項 4) - Plan 儲存位置:可在 settings.json 配置
plansDirectory
4. 使用建議
什麼時候用 Plan Mode?
| 場景 | 適合度 | 原因 |
|---|---|---|
| 探索陌生 codebase | ★★★★★ | 唯讀模式安全,快速分析 |
| 規劃複雜重構 | ★★★★★ | 先看清全貌再動手 |
| 快速分析/評估 | ★★★★★ | 速度快、token 消耗低 |
| 需要向他人展示計畫 | ★★★★☆ | 產出結構化的 plan.md |
| 小範圍修改 | ★★☆☆☆ | 殺雞用牛刀 |
| 需要嚴格 TDD | ★☆☆☆☆ | 不包含 TDD 流程 |
什麼時候用 Superpowers?
| 場景 | 適合度 | 原因 |
|---|---|---|
| 開發新功能(中大型) | ★★★★★ | 完整工作流覆蓋 |
| 需要 TDD 紀律 | ★★★★★ | 強制 Red-Green-Refactor |
| 團隊協作/PR 準備 | ★★★★★ | 內建 code review 流程 |
| 複雜除錯 | ★★★★★ | 四階段系統化方法 |
| 快速探索/分析 | ★★☆☆☆ | 太重量級 |
| 簡單 bug 修復 | ★★★☆☆ | 仍有效但可能過度 |
決策流程
需要做什麼?
├── 純探索/分析 → Plan Mode
├── 小修改(< 30 分鐘)→ Plan Mode 規劃 → 直接執行
├── 中型功能(1-4 小時)→ Superpowers(brainstorm → plan → execute)
├── 大型功能(> 4 小時)→ Superpowers + Plan Mode 疊加
└── 除錯 → Superpowers (systematic-debugging)
5. 疊加性分析
可以同時使用嗎?
可以,而且建議疊加使用。 兩者運作在不同層次:
| 層次 | Plan Mode | Superpowers |
|---|---|---|
| 工具權限控制 | ✅ 核心功能 | ❌ 不處理 |
| 開發方法論 | ❌ 不處理 | ✅ 核心功能 |
| 流程紀律 | 輕量(唯讀限制) | 重量(TDD、Review、驗證) |
推薦疊加方式
策略 A:Plan Mode 作為 Superpowers 的「安全帶」
1. 啟動 Plan Mode
2. Superpowers brainstorming 在 Plan Mode 下運行(本來就是唯讀操作)
3. 設計完成後,退出 Plan Mode
4. 進入 writing-plans(此時需要寫入檔案)
5. Plan 完成後,可再次進入 Plan Mode review
6. 確認後退出 Plan Mode,進入 executing-plans
優勢:Plan Mode 的工具限制提供了額外的安全網,防止 brainstorming 階段意外修改檔案。
策略 B:Plan Mode 處理「規劃」,Superpowers 處理「執行」
1. Plan Mode: 探索 codebase、分析架構、產出初步計畫
2. 退出 Plan Mode
3. Superpowers brainstorming: 將 Plan Mode 的分析結果精煉為設計文件
4. Superpowers writing-plans: 產出詳細實作計畫
5. Superpowers executing/subagent-driven: 執行計畫
優勢:利用 Plan Mode 的速度與低成本進行前期探索,再用 Superpowers 的嚴謹流程執行。
策略 C:按任務複雜度選擇
簡單任務(< 15 分鐘):只用 Plan Mode 快速規劃 → 直接執行
中等任務(15-60 分鐘):Plan Mode 探索 → Superpowers writing-plans → 手動執行
複雜任務(> 60 分鐘):Plan Mode 探索 → Superpowers 全流程
疊加的風險
| 風險 | 說明 | 緩解方式 |
|---|---|---|
| Token 成本增加 | 兩套流程都消耗 token | 按需使用,簡單任務不疊加 |
| 流程過度 | 小任務被迫走完整流程 | Superpowers 的 skill 可以選擇性使用 |
| 模式切換混亂 | Plan Mode 限制可能干擾 Superpowers 需要的寫入操作 | 在需要寫入前退出 Plan Mode |
| 方法論衝突 | Superpowers 的 brainstorming 可能與 Plan Mode 的四階段流程重疊 | 選擇一個主導流程 |
如果只能擇一?
| 你的需求 | 選擇 |
|---|---|
| 快速探索、規劃、安全操作 | Plan Mode |
| 嚴謹的開發品質、TDD、code review | Superpowers |
| 獨立開發者、快速迭代 | Plan Mode(較輕量) |
| 團隊項目、需要可審查的流程 | Superpowers(流程可追蹤) |
| 學習軟體工程最佳實踐 | Superpowers(內建方法論教學) |
| 偏好自由度、不喜歡被強制 | Plan Mode(限制少) |
6. 技術實作細節
Superpowers 實作方式
- Plugin 格式:Claude Code Plugin Marketplace 標準格式
- 檔案結構:
skills/<skill-name>/SKILL.md+ 輔助文件 - 觸發機制:透過
using-superpowersskill 注入 system prompt,強制 Claude 在每次對話檢查適用 skills - 版本管理:透過 marketplace 更新(
/plugin update superpowers) - 目前版本:4.1.1
- 授權:MIT License
- Repository:https://github.com/obra/superpowers
Plan Mode 實作方式
- 類型:Claude Code 內建的 permission mode
- 機制:修改 tool availability(禁止寫入工具)+ system prompt 注入
- Plan 儲存:寫入
~/.claude/plans/或自定義目錄 - 進出控制:
EnterPlanMode/ExitPlanMode工具調用 - UI 指示:終端底部顯示
⏸ plan mode on
7. 參考資料
官方文檔
Superpowers
- Superpowers GitHub Repository
- Superpowers Marketplace
- Jesse Vincent's Blog: Superpowers for Claude Code
- 本地技能檔案:
~/.claude/plugins/cache/superpowers-marketplace/superpowers/4.1.1/
Plan Mode 分析
- Armin Ronacher: What Actually Is Claude Code's Plan Mode?
- Claude Code Best Practices: The Plan Mode
- ClaudeLog: Plan Mode Comprehensive Guide
- Claude Code Planning Mode: Shift+Tab Twice
社群討論
- Mastering Claude Code Plan Mode (Substack)
- Shift+Tab: How Claude Code's Planning Mode Can Prevent Tech Debt (Medium)
報告產出日期:2026-02-08 研究方法:本地檔案分析 + 網路文獻調查