Superpowers

Composable skills for coding agents. v5.1.0 extends the same disciplined workflow to Claude Code, Cursor, Codex, Factory Droid, OpenCode, Gemini CLI, and GitHub Copilot CLI.

1 — 概要
何か

Superpowers は、コーディングエージェント向けのソフトウェア開発ワークフロー一式。組み合わせ可能な「スキル」と、エージェントがそれらを確実に使うための初期指示で構成され、コードを書く前に仕様を引き出し、設計を承認してからプランに落とし、TDD とレビューを通してマージ判断まで進める。

5.1.0最新確認版
8対応ハーネス
14コアスキル
0 depsbrainstorm server

エージェントは「何か作る」と検知すると、いきなりコードを書かずに「何をしたいか」を問いかける。仕様を固めて短いチャンクで確認し、承認後に実装プランを作る。「go」と言えば subagent-driven-development または executing-plans に進み、タスク単位で検証しながら作業する。

2 — 最新アップデート
v5.1.0 の主な変更
領域更新意味
v5.1.0using-git-worktrees / finishing-a-development-branch を書き直し既存 worktree 内なら作成をスキップ。作成前にユーザー同意を取り、ハーネス固有の worktree ツールを優先。クリーンアップは .worktrees/ 配下のみ。
reviewsuperpowers:code-reviewer 名前付きエージェントを削除し、requesting-code-review を自己完結化ペルソナとチェックリストを code-reviewer.md に集約し、Task (general-purpose) で直接ディスパッチ。
sddsubagent-driven-development の「3 タスクごとに停止」を廃止タスク単位または自然な区切りでレビューし、計画に沿って連続実行しやすくした。
commandsレガシー slash コマンド /brainstorm、/execute-plan、/write-plan を削除対応スキル（superpowers:brainstorming など）を直接呼び出す前提へ。
contribCLAUDE.md / AGENTS.md に AI エージェント向け貢献ガイドを追加PR テンプレート確認、重複検索、実在する問題の検証、完全 diff の人間承認を必須化。
installFactory Droid のインストール手順を README に追加8 ハーネス目として marketplace 登録と plugin install を明記。
3 — 基本ワークフロー
7 ステップ

エージェントはタスクの前に必ず関連スキルを確認する。推奨ではなく必須のワークフローとして組み込まれる。

順スキル役割
1brainstormingコードを書く前に発動。曖昧なアイデアを問いで整理し、設計をセクションごとに示して承認を得る。仕様は inline self-review でプレースホルダ、矛盾、曖昧さを点検。
2using-git-worktrees設計承認後に発動。分離したワークスペースで新ブランチを作成し、セットアップとクリーンなテストベースを確認。
3writing-plans承認された設計に基づき、2〜5 分で完了するタスクに分解。各タスクにファイルパス・完全なコード・検証手順を記載し、プラン自体も自己点検。
4subagent-driven-development / executing-plans実行方式を選ぶ。推奨は fresh subagent per task でタスク間を連続実行（v5.1.0 で 3 タスクごとの強制停止を廃止）。代替は同一セッションでのバッチ実行＋人間チェックポイント。
5test-driven-development実装中に発動。RED-GREEN-REFACTOR を強制。失敗テストを書き、落ちることを確認し、最小コードで通す。テストより前に書いたコードは削除。
6requesting-code-reviewタスク間で発動。code-reviewer.md テンプレートで Task (general-purpose) をディスパッチし、プランとの整合性を深刻度別に報告。クリティカルな問題は進行をブロック。
7finishing-a-development-branchタスク完了時に発動。テスト確認後、マージ / PR / 維持 / 破棄の選択肢を提示し、ワークツリーを整理。
4 — スキルライブラリ
カテゴリ別一覧
カテゴリスキル概要
Testingtest-driven-developmentRED-GREEN-REFACTOR サイクル（アンチパターン参照付き）
Debuggingsystematic-debugging4 段階の根因追跡（root-cause-tracing、defense-in-depth、condition-based-waiting）
Debuggingverification-before-completion修正が本当に効いているか確認してから完了とする
Collaborationbrainstorming問いによる設計の洗練
Collaborationwriting-plans詳細な実装プラン
Collaborationexecuting-plansチェックポイント付きバッチ実行
Collaborationdispatching-parallel-agents並列サブエージェントワークフロー
Collaborationrequesting-code-reviewレビュー前チェックリスト
Collaborationreceiving-code-reviewフィードバックへの対応
Collaborationusing-git-worktrees分離ブランチでの並行開発
Collaborationfinishing-a-development-branchマージ / PR 判断ワークフロー
Collaborationsubagent-driven-development二段階レビュー（spec → code quality）付きの連続イテレーション
Metawriting-skillsベストプラクティスに沿った新規スキル作成（テスト手法含む）
Metausing-superpowersスキルシステムの導入
5 — インストール
プラットフォーム別

v5.1.0 時点では、Claude Code、Cursor、OpenAI Codex CLI/App、Factory Droid、OpenCode、GitHub Copilot CLI、Gemini CLI に導線がある。ハーネスごとに別途インストールが必要。各環境で導入後、新セッションで「この機能を計画して」などスキルが発動しそうな依頼をすると、エージェントが該当スキルを読み込む。

Claude Code公式プラグイン市場、または Superpowers Marketplace から導入。
Cursorプラグイン市場で superpowers を検索。Windows では SessionStart hook が run-hook.cmd 経由。
CodexCLI は /plugins から、App は sidebar の Plugins から導入。
Factory Droidmarketplace 登録と plugin install で導入（v5.1.0 で README に手順追加）。
OpenCodebootstrap 内容をセッション中キャッシュ。詳細は .opencode/INSTALL.md。
Copilot CLIMarketplace 登録と install コマンドで導入。SessionStart で bootstrap を注入。
Gemini CLIextension と GEMINI.md で tool mapping。Task は @agent-name にマップ。

Claude Code（公式マーケットプレース）

/plugin install superpowers@claude-plugins-official

Claude Code（コミュニティマーケットプレース）

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

Cursor

Agent チャットでプラグイン市場から /add-plugin superpowers または「superpowers」で検索。

OpenAI Codex CLI

/plugins
superpowers
# Select: Install Plugin

OpenAI Codex App

Codex app の sidebar で Plugins を開き、Coding セクションにある Superpowers の + をクリックして案内に従う。

Factory Droid

droid plugin marketplace add https://github.com/obra/superpowers
droid plugin install superpowers@superpowers

OpenCode

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

詳細: docs/README.opencode.md

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   # 更新時
確認: 新規セッションで「この機能を計画して」や「このバグを調査して」などスキルが発動しそうな依頼をすると、エージェントが該当スキルを自動で読み込む。
6 — 貢献時の注意
AI agent 向けの安全柵

Superpowers 本体への PR は厳しく審査される。直近 100 件の closed PR を監査したところ、却下率は約 94%。スキル本文は「文章」ではなく、エージェントの行動を変える実行可能なプロンプト資産として扱われる。

PR 前の必須チェック（v5.1.0）: PR テンプレート全項目を具体的内容で埋める。open/closed 両方で重複 PR を検索する。実在する問題か検証する。core に属する変更か判断する。モデル・ハーネス・プラグインを開示する。完全 diff を人間パートナーに見せて明示承認を得る。ターゲットブランチは dev（main ではない）。
避ける変更理由
ドメイン特化・プロジェクト特化のスキルcore は汎用スキルの場所。特定領域向けは standalone plugin が適切。
評価なしのスキル文面リライトRed Flags などの語彙は挙動調整済み。改善には before/after eval が必要。
架空の問題や理論上の修正実際のセッション、エラー、ユーザー体験に基づかない PR は却下されやすい。
複数の無関係な修正を束ねる1 PR 1 problem。まとめた変更はレビュー不能になりやすい。
第三者依存の追加新ハーネス対応を除き zero-dependency 方針。外部ツール依存は別プラグインへ。
新ハーネス PR にセッション transcript なし「Let's make a react todo list」で brainstorming が自動発火する end-to-end 証拠が必要。
7 — 哲学
設計思想
  • Test-Driven Development — 常にテストを先に書く
  • Systematic over ad-hoc — 当て推量よりプロセス
  • Complexity reduction — シンプルさを最優先
  • Evidence over claims — 主張の前に検証してから「完了」とする
公式・関連