Superpowers 実践ガイド
Superpowers（v5.0.7）の14スキルを活用した標準開発パイプライン。ブレスト、計画、実装、レビューの全フローを解説。
Superpowers とは
Superpowers は obra が開発した Claude Code 向けのスキルプラグインだ。Claude Code 本体の機能を変えるのではなく、その上に構造化されたワークフローを追加する。
| 項目 | 内容 |
|---|---|
| バージョン | v5.0.7 |
| ライセンス | MIT |
| リポジトリ | obra/superpowers |
| スキル数 | 14 |
| エージェント数 | 1（code-reviewer） |
| コマンド数 | 3（すべて deprecated。スキル直接呼び出し推奨） |
Superpowers の中心思想は「ブレインストーミング → Git Worktree 準備 → 計画策定 → 実装 → TDD → コードレビュー → ブランチ完了」という7ステップのパイプラインだ。各ステップに専用スキルが対応しており、場当たり的な実装を防いで再現性の高い開発フローを実現する。
中核思想: using-superpowers の1%ルール
Superpowers の規律強制の源泉は using-superpowers スキルにある。このスキルはすべての会話の冒頭で読み込まれ、各スキルの description には MUST use、before any、always などの命令形トリガーが埋め込まれている。
Claude はこの仕組みにより「1%でも適用可能性があればスキルを呼ぶ」よう指示される。ユーザーが明示的にスキル名を言わなくても、文脈から適切なスキルが自動発火する設計だ。言い換えると、スキルは「ツール」ではなく「強制されるワークフロー規律」として機能する。
始め方
インストール
Claude Code（公式マーケットプレース）
/plugin install superpowers@claude-plugins-official
Claude Code（obra マーケットプレース経由）
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
Cursor / Codex / Gemini CLI / GitHub Copilot CLI など他のプラットフォームではそれぞれ別の手順が必要です。詳細は obra/superpowers リポジトリ の README を参照してください。
最初のステップ
インストール直後は using-superpowers スキルから読み始めるとよい。スキルシステム全体の動作原理とスキル一覧が確認できる。
using-superpowers スキルを読んでください
または Skill ツールで明示呼び出し:
superpowers:using-superpowers
標準開発パイプライン（7ステップ）
Superpowers の公式ワークフローは7つのステップで構成される。要件定義からブランチ完了まで一貫したフローで進められる。
Step 1: ブレインストーミング（brainstorming スキル）
実装に入る前に要件、ユーザーの意図、設計上のトレードオフを洗い出す。「何を作るか」が曖昧なまま手を動かすと、後で大幅な手戻りが発生する。このスキルはその手戻りを防ぐ。
起動方法:
「〜を作りたい」「〜をブレストしたい」「〜の設計を検討したい」のような発話で brainstorming スキルが自動発火する。または Skill ツールで明示呼び出し:
superpowers:brainstorming
セッション例:
ユーザー認証フローのリデザインをブレインストーミングしたい
Superpowers はユーザーストーリー、制約、代替案、リスクを体系的に引き出す問いかけを行う。設計ドキュメントを保存して次のステップへ渡す。
Step 2: Git Worktree の準備（using-git-worktrees スキル）
設計承認後、隔離された作業ブランチを新規に作成する。プロジェクトのセットアップを実行し、クリーンなテストベースラインを確認してから実装に入る。
起動方法:
「worktree を作りたい」「隔離ブランチで作業したい」のような発話で自動発火する。または:
superpowers:using-git-worktrees
このステップにより、メインブランチを汚さずに実験的な実装が可能になる。
Step 3: 計画策定（writing-plans スキル）
ブレインストーミングで確定した要件をもとに、レビューチェックポイント付きのステップバイステップ実装計画を作成する。各タスクは2〜5分で完了できる粒度に分解され、ファイルパス、完全なコード、検証ステップを含む。
起動方法:
「計画を作りたい」「実装プランを立てたい」のような発話で自動発火する。または:
superpowers:writing-plans
生成される計画には以下が含まれる:
- 実装ステップのリスト（依存関係付き）
- 各ステップの完了基準
- レビューが必要なポイントの明示
ポイント: 計画はファイルに保存するよう促される。プロジェクト内の任意のディレクトリ（例: plans/）に保存しておくと、後から executing-plans スキルで参照できる。
Step 4: 実装（subagent-driven-development または executing-plans スキル）
保存した計画を読み込み、ステップを順に実行する。この2つのスキルは択一関係にあり、プロジェクトの進行スタイルに応じて使い分ける。
subagent-driven-development（迅速反復向き）
タスクごとに新しいサブエージェントを起動し、2段階レビュー（仕様準拠確認 → コード品質確認）を実施する。独立タスクを高速で並列処理したい場合に適している。
superpowers:subagent-driven-development
executing-plans（慎重進行向き）
タスクをバッチで実行し、各チェックポイントで人間の確認を挟む。変更の影響が大きい場合や、段階的に確認しながら進めたい場合に適している。
superpowers:executing-plans
並列実行の例（subagent-driven-development の場合）:
計画: ユーザー認証 API の実装
├─ Wave 1（並列）
│ ├─ Agent A: POST /auth/login エンドポイント
│ └─ Agent B: POST /auth/refresh エンドポイント
└─ Wave 2（直列）
└─ Agent C: 統合テスト
subagent-driven-development スキルはファイル境界を明示し、同一ファイルへの競合書き込みを防ぐ役割も担う。
Step 5: TDD（test-driven-development スキル）
実装フェーズ全体を通じて、TDD の規律（RED → GREEN → REFACTOR）を強制する。テストなしで書かれたコードは削除するよう指示される。
起動方法:
「TDD で進めたい」「テストを先に書く」のような発話で自動発火する。または:
superpowers:test-driven-development
サイクル:
- 失敗するテストを書く（RED）
- テストが失敗することを確認する
- 最小限のコードを書いてテストを通す（GREEN）
- テストが通ることを確認してコミット
- リファクタリング（REFACTOR）
Step 6: コードレビュー（requesting-code-review / receiving-code-review スキル + code-reviewer エージェント）
タスク間のレビューフェーズ。requesting-code-review スキルが構造化されたレビュー依頼を生成し、code-reviewer エージェントがレビューを実施する。Critical な問題はブロッキング扱いとなり、進行を止めて修正を要求する。フィードバック受け取り側は receiving-code-review スキルで対応優先度を整理する。
レビュー依頼の起動:
「コードレビューをお願いしたい」のような発話で自動発火する。または:
superpowers:requesting-code-review
code-reviewer エージェントは以下を評価する:
- ロジックの正確性
- エッジケースの処理
- セキュリティ上の問題
- パフォーマンスへの影響
Step 7: ブランチ完了（finishing-a-development-branch スキル）
すべてのタスクが完了したら、ブランチのクローズ処理を行う。テストの確認後、マージ/PR作成/保持/破棄の選択肢が提示され、worktree のクリーンアップまで一貫して管理される。
起動方法:
「ブランチを完了したい」「finish branch」のような発話で自動発火する。または:
superpowers:finishing-a-development-branch
スキル一覧（14種）
| スキル | 説明 | 起動方法 |
|---|---|---|
using-superpowers | スキルシステムの基盤、全スキルの索引 | 会話冒頭で自動読み込み |
brainstorming | 要件探索とデザイン検討 | 「ブレストしたい」等の発話で自動発火 |
writing-plans | 実装計画の策定 | 「計画を作りたい」等の発話で自動発火 |
executing-plans | 計画の実行（慎重進行向き） | 「計画を実行したい」等の発話で自動発火 |
subagent-driven-development | 新規サブエージェントによる並列実行（迅速反復向き） | 「サブエージェントで実行したい」等の発話 |
using-git-worktrees | Git worktree による隔離開発 | 「worktree を作りたい」等の発話で自動発火 |
test-driven-development | TDD ワークフロー（Red→Green→Refactor） | 「TDD で進めたい」等の発話で自動発火 |
systematic-debugging | 体系的デバッグ（仮説→検証のサイクル） | 「デバッグしたい」「エラーが出た」等の発話 |
verification-before-completion | 完了前の証拠ベース検証 | 「完了」「done」「finished」等の発話で自動発火 |
requesting-code-review | レビュー依頼の構造化 | 「コードレビューをお願いしたい」等の発話 |
receiving-code-review | レビューフィードバックの対応整理 | レビュー受領後に自動発火 |
writing-skills | カスタムスキルの作成 | 「スキルを書きたい」等の発話で自動発火 |
finishing-a-development-branch | ブランチ完了処理（PR 作成まで） | 「ブランチを完了したい」等の発話で自動発火 |
dispatching-parallel-agents | 独立タスクへの並列エージェント発行 | subagent-driven-development から参照 |
Deprecated コマンドについて
Superpowers が提供するスラッシュコマンドは以下の3つだが、いずれも deprecated であり、次のメジャーバージョンで削除予定だ。現在は各コマンドの中身はスキルへの移行を促すだけになっている。新規利用はスキルの直接呼び出しを推奨する。
| コマンド | 対応スキル | 状態 |
|---|---|---|
/brainstorm | brainstorming | deprecated |
/write-plan | writing-plans | deprecated |
/execute-plan | executing-plans | deprecated |
スキルを呼び出すには、対応するキーワードを含む自然な発話で自動発火させるか、Claude Code の Skill ツールで superpowers:brainstorming 等を明示呼び出しするのが正しい方法だ。
他ツールとの連携
Claude Code + Superpowers
Claude Code（CC）単体では実装できるが、フローの構造化は開発者に委ねられている。Superpowers（SP）はその構造を提供する。CCの基本機能（Edit、Bash、Glob など）はそのまま使いながら、ブレスト→計画→実装→検証というフローが自然に機能する。
Claude Code（ツール実行基盤）
└─ Superpowers（ワークフロー構造を追加）
Superpowers + oh-my-claudecode（OMC）
OMC の自律実行モード（autopilot、ralph）と SP の計画スキルを組み合わせると、長時間の自律開発セッションを構造的に管理できる。
実践的な使い方:
writing-plansスキルで実装計画を生成し、plans/ディレクトリに保存autopilotモードで計画ファイルを渡して自律実行- セッション終了前に
verification-before-completionが自動検証
Superpowers + ECC（Expert Claude Code）
ECC が提供する言語別・ドメイン別のレビューエージェントと、SP の TDD ワークフローを組み合わせられる。
TDD フロー（SP）
├─ test-driven-development スキル → テスト先行実装
└─ requesting-code-review スキル → ECC のレビューエージェントに依頼
└─ ECC: TypeScript レビューアー、セキュリティレビューアーなど
よくある使い方のパターン
パターン 1: 新機能の実装（フル7ステップ）
1. 「〜をブレインストーミングしたい」→ brainstorming スキルが自動発火
2. 「worktree を作って」→ using-git-worktrees スキルが自動発火
3. 「実装計画を作って」→ writing-plans スキルが自動発火（plans/feature-x.md に保存）
4. 「サブエージェントで実行して」→ subagent-driven-development スキルが自動発火
5. （TDD は実装中に自動強制）
6. 「コードレビューをお願いしたい」→ requesting-code-review スキルが自動発火
7. 「ブランチを完了したい」→ finishing-a-development-branch スキルが自動発火
パターン 2: バグ修正（デバッグフォーカス）
1. 「このエラーをデバッグしたい」→ systematic-debugging スキルが自動発火
2. 仮説の列挙 → 最小再現ケースの作成 → 検証
3. 「修正が完了しました」→ verification-before-completion が自動発火して回帰確認
パターン 3: 並列実装（大規模 API 実装など）
1. 「実装計画を作って」→ writing-plans スキルでエンドポイントごとのタスクに分解
2. 「サブエージェントで実行して」→ subagent-driven-development スキル
→ Wave 1: 独立エンドポイントを並列実装
→ Wave 2: 統合テスト
まとめ
Superpowers は「考える前に手を動かす」という開発習慣を「考えてから動く」フローに変えるプラグインだ。14スキルはすべて独立して使えるが、7ステップのパイプラインとして順番に使うと最大の効果が得られる。
まずは brainstorming スキルから試してみることを勧める（「〜をブレストしたい」と話しかけるだけで自動発火する）。実装前に要件を整理する習慣がつくだけで、手戻りの量が大幅に減る。
次に読むべきガイド: チーム開発で Claude Code を活用する では、複数人での運用とスキル共有の方法を学べる。
リファレンス
- CLAUDE.md 完全ガイド - プロジェクト文脈の設定
- Hooks で作業を自動化する - フックによる自動化
- MCP サーバーで機能を拡張する - 外部ツール連携
- obra/superpowers リポジトリ - ソースコードと最新情報
次のステップ
高度に進む
上級者向け学習パス: ハーネスエンジニアリングと運用最適化Claude Code の活用を極限まで高める方向けのガイド。ハーネス最適化、プラグイン開発、マルチモデルオーケストレーション、組織展開まで。
関連コンテンツ
フェーズ4: 実装
計画に基づいてコードを記述するフェーズ。TDD、サブエージェント駆動開発、並列実行などの手法を活用し、品質と効率を両立させる手法を解説。
フェーズ6: 検証
実装されたコードが正しく動作することを証明するフェーズ。単体テスト、統合テスト、E2Eテストを体系的に実行し、品質を数値化して保証する手法を解説。
Superpowers スキルカタログ
Superpowers（v5.0.7）のコアスキルカタログ。設計、計画、テスト、デバッグ、レビューの自律的ワークフローを解説。
エコシステム連携ワークフロー実例集
Claude Code・Superpowers・OMC・ECCの4ツールを組み合わせた実践的な開発ワークフロー事例。