Files

Timmy 3da3ebf672 新增 Superpowers、Claude HUD、Karpathy Skills 安裝筆記

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-19 10:04:31 +08:00

3.6 KiB

Raw Blame History

Superpowers 安裝與使用筆記

基本資訊

專案: https://github.com/obra/superpowers
作者: Jesse Vincent（obra）/ Prime Radiant
授權: MIT
類型: Claude Code / Cursor / Gemini CLI / GitHub Copilot CLI 外掛
用途: 為編碼代理（coding agent）提供結構化開發方法論的可組合 skills
官方社群: Discord、GitHub Issues、primeradiant.com/superpowers
安裝日期: 2026-04-19

是什麼

Superpowers 是一套專為 AI 編碼代理設計的軟體開發方法論框架。它不讓代理直接寫程式，而是透過一組可組合（composable）的 skills，引導代理依序走完設計、規劃、實作、測試、審查等階段，內建品質檢查點。

核心理念：

系統化優先於臨時應變（Systematic over ad-hoc）
以測試驅動開發（TDD）為基礎
降低複雜度，追求簡單
用證據驗證，而非假設

安裝

Claude Code（官方 Marketplace，推薦）

在 Claude Code 對話中執行：

/plugin install superpowers@claude-plugins-official

本機 claude-plugins-official marketplace 已位於： ~/.claude/plugins/marketplaces/claude-plugins-official/

Claude Code（Superpowers 自家 Marketplace）

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Cursor

/add-plugin superpowers

GitHub Copilot CLI

copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace

Gemini CLI

gemini extensions install https://github.com/obra/superpowers
gemini extensions update superpowers          # 更新

核心工作流程（七個階段）

Brainstorming（腦力激盪） — 透過發問釐清需求與目標
Git Worktrees — 建立隔離的開發分支
Planning（規劃） — 將工作切成 2–5 分鐘、junior 開發者可執行的小任務
Implementation（實作） — 以 subagent 執行，搭配兩階段 review
Testing（測試） — 強制 red-green-refactor TDD 循環
Code Review — 對照規格驗證實作
Completion（收尾） — 合併或歸檔

Skills 清單

測試與品質

TDD（RED-GREEN-REFACTOR）
系統化除錯（4 階段根因分析）
完成前驗證（verification before completion）

規劃與協作

Brainstorming 與設計精煉
撰寫詳細實作計畫
依計畫執行並設檢查點
Subagent 驅動開發 + 兩階段審查
Code review 請求／回覆流程
Git worktree 管理
開發分支收尾

使用方式

安裝完成後，在 Claude Code 中 skills 會依對話情境自動啟用。也可以用 / 查看並手動觸發特定 skill。

進入典型開發任務時，Superpowers 會先要求對話釐清需求、產出 design doc，再分解任務、建立 worktree，接著才真正開始寫 code。

常用檢查指令

# 檢查 marketplace
ls ~/.claude/plugins/marketplaces/

# 看哪些 marketplace 已加入
cat ~/.claude/plugins/known_marketplaces.json

# 看 superpowers 是否在 marketplace 清單
grep -l "superpowers" ~/.claude/plugins/marketplaces/claude-plugins-official/.claude-plugin/marketplace.json

備註

Superpowers 的設計偏好「先對齊再寫 code」，如果你要的是快速一次性 hack，它可能會顯得繁瑣；適用於需要品質與可維護性的正式任務。
方法論強調由人類確認設計稿再進入實作，互動次數會比裸 agent 多。

3.6 KiB Raw Blame History Unescape Escape