Superpowers Skill vs. Claude Code Plan Mode:完整比較研究

2026-02-08
claude-codesuperpowersplan-modedeveloper-toolsworkflow

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(腦力激盪)

2. writing-plans(撰寫計畫)

3. subagent-driven-development(子代理驅動開發)

4. test-driven-development(測試驅動開發)

5. systematic-debugging(系統化除錯)

6. verification-before-completion(完成前驗證)

7. using-superpowers(系統入口)

安裝與使用

# 安裝
/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 只能使用唯讀工具:

允許的工具(唯讀):

禁止的工具(修改型):

啟用方式

# 方式 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 文件運作的:

  1. Phase 1 - 初步理解:探索程式碼,提出釐清問題
  2. Phase 2 - 設計:規劃實作方式
  3. Phase 3 - 審查:驗證方向正確
  4. Phase 4 - 最終計畫:寫出簡潔、可執行的計畫

計畫寫入檔案後,Claude 調用 ExitPlanMode 工具,等待使用者批准後,才會讀取計畫檔案並開始執行。

特色功能


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 ModeSuperpowers
工具權限控制✅ 核心功能❌ 不處理
開發方法論❌ 不處理✅ 核心功能
流程紀律輕量(唯讀限制)重量(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 reviewSuperpowers
獨立開發者、快速迭代Plan Mode(較輕量)
團隊項目、需要可審查的流程Superpowers(流程可追蹤)
學習軟體工程最佳實踐Superpowers(內建方法論教學)
偏好自由度、不喜歡被強制Plan Mode(限制少)

6. 技術實作細節

Superpowers 實作方式

Plan Mode 實作方式


7. 參考資料

官方文檔

Superpowers

Plan Mode 分析

社群討論


報告產出日期:2026-02-08 研究方法:本地檔案分析 + 網路文獻調查