這是一份給 Claude Code 用的 CLAUDE.md 指引,針對 LLM 寫程式時常見的毛病:默默做錯假設、把程式寫得過度複雜、順手改到不相關的程式。內容整理成四條原則:先想再寫、簡單優先、只做必要改動、以目標驅動執行。除了 CLAUDE.md,倉庫也提供 Claude Code plugin 與 Cursor 規則檔兩種套用方式。
obra/superpowers
專案簡介
以上內容由 AI 根據官方 README 整理,未經實測;指令以官方文件為準。
原始描述
An agentic skills framework & software development methodology that works.
AI 規格
主要功能
- brainstorming skill 在動手前先問清需求,並把理解回放給你確認
- writing-plans 把工作拆成 2 至 5 分鐘、含檔案路徑與驗證步驟的小任務
- subagent-driven-development 每個任務派一個新 subagent,做完就審查
- test-driven-development 強制 RED-GREEN-REFACTOR,先寫失敗測試再寫程式
- using-git-worktrees 在新分支建立隔離工作區並確認測試基準乾淨
- diagnosing-superpowers 讀 session transcript 找出 skill 行為異常的原因
安裝方式
Claude Code:從 Anthropic 官方市集安裝外掛
/plugin install superpowers@claude-plugins-officialClaude Code:註冊 Superpowers 市集
/plugin marketplace add obra/superpowers-marketplaceClaude Code:從 Superpowers 市集安裝外掛
/plugin install superpowers@superpowers-marketplaceAntigravity:從本倉庫安裝外掛
agy plugin install https://github.com/obra/superpowersCodex CLI:開啟外掛搜尋介面,搜尋 superpowers 後選 Install Plugin
/pluginsCursor:在 Agent chat 中從市集安裝
/add-plugin superpowersDevin CLI:從本倉庫安裝外掛
devin plugins install obra/superpowersFactory Droid:註冊市集
droid plugin marketplace add https://github.com/obra/superpowers
設定教學
安裝依 harness 而異,每個 harness 要分別安裝一次。多數是透過各自的 plugin 或 extension 指令從市集或本倉庫安裝,不需要手動填設定檔或 API 金鑰。
主要設定檔
.claude-plugin/plugin.json— Claude Code 外掛的 manifest,定義外掛名稱與版本.codex-plugin/plugin.json— Codex 外掛的 manifest,由 sync 腳本產生.cursor-plugin/plugin.json— Cursor 外掛的 manifest.hermes-plugin/plugin.yaml— Hermes Agent 外掛的設定檔.pi/extensions/superpowers.ts— Pi 的 extension,在 session 啟動時注入 using-superpowers bootstrap.opencode/plugins/superpowers.js— OpenCode 的外掛入口,載入 skills 與 bootstraphooks/hooks.json— SessionStart hook 設定,讓 agent 開場就載入 skillsgemini-extension.json— Gemini CLI 擴充套件的 manifest
部署方式
Claude Code(官方市集)
從 Anthropic 官方市集安裝外掛
/plugin install superpowers@claude-plugins-official
Claude Code(Superpowers 市集)
註冊 Superpowers 市集
/plugin marketplace add obra/superpowers-marketplace從該市集安裝外掛
/plugin install superpowers@superpowers-marketplace
Gemini CLI
以 extension 形式安裝
gemini extensions install https://github.com/obra/superpowers
設定內容整理自 repository 內的設定檔與文件,未經實測;變數名稱與指令以官方檔案為準。
適合用途
- 想讓 coding agent 先談清楚需求再動手的開發者
- 在 Claude Code 或 Cursor 上想強制跑 TDD 流程的團隊
- 需要把工作拆成可審查小任務、交給 subagent 執行的專案
- 要排查某個 session 裡 agent 行為異常的維護者
常見問題
同時用 Claude Code 和 Cursor,需要各裝一次嗎
可以。同一個 agent 裝了多個 harness 時,README 要求每個 harness 各自安裝 Superpowers,不會共用同一份安裝。
之後要怎麼更新
用 harness 對應的更新指令,例如 gemini extensions update superpowers、devin plugins update superpowers、qwen extensions update superpowers、muse plugins update superpowers。Antigravity 則是用原本的安裝指令重裝一次。
怎麼確認 skills 有沒有正常觸發
skills 是自動觸發的,不用下特殊指令。README 建議開一個新 session 送出 Let's make a react todo list,若安裝正常,brainstorming 會在寫任何程式碼之前先被觸發。
某個 session 的 skill 行為不對,要怎麼查
請 agent 執行 diagnosing-superpowers skill,它會讀取 session transcript、附上逐行證據說明發生什麼事,也能打包一份去識別化的 bundle 供回報問題。要檢查先前的 session 就指定 session id。
Hermes 用久了 skills 突然不觸發怎麼辦
Hermes 沒有 post-compaction hook,session 壓縮過第一輪之後 bootstrap 會消失,skills 可能就不再觸發,這時開新 session 即可。安裝後也要重啟既有的 Hermes session。