Superpowersクイックスタート：インストール、ワークフロー、および試行
1つのコマンドで導入可能な、強制実行されるSDDスキル。
Superpowers は、完全な仕様駆動型メソドロジーをインストール可能な Claude Skills にパッケージ化しています。これにより、ブレインストーミング、プランニング、サブエージェントによる実装、厳格な TDD（テスト駆動開発）を強制し、その構造を使用者に委ねるのではなく、システム側で管理します。
多くの Claude Code の SDD（仕様駆動開発）設定は同じように失敗します。誰かが一度 specify-plan-implement スキルを書き、一週間ほど真面目に使ってから、締め切りに近づいた途端に、構造化されていないプロンプト入力へと静かに流れていくのです。手作りのスキルだけでは、そのような行動変化を根本から止めることはできません。Superpowers は、その規律問題に対する直接的な回答です。Jesse Vincent 氏と Prime Radiant のチームが開発したこのスキルパッケージは、ブレインストーミング、プランニング、サブエージェントによるレビュー、そしてリダース（赤-緑-リファクタ）TDD を、任意の提案ではなく、エージェントが各タスク前に必ず確認する必須のステップとして位置づけています。
脚注で済ませるのではなく、注目に値する点はインストールの手順です。Superpowers は Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot CLI、Grok Build CLI、Kimi Code、OpenCode、Pi、Devin CLI、Factory Droid、および Hermes Agent 向けのプラグインマニフェストを提供しています。そのため、単一のリポジトリの .claude/skills/ フォルダに閉じこもるのではなく、同じメソドロジーが複数のハネス（実行環境）をまたいで追随します。本ガイドでは、その実体、使用するエージェントへのインストールと確認方法、最初のエンドツーエンド実行の様子、そして他の仕様駆動開発ツールとの関係性について説明します。
Superpowers とは？
Superpowers は自身を「コーディングエージェントのための完全なソフトウェア開発メソドロジーであり、組み替え可能なスキルのセットと、エージェントがそれらを使用することを確実にするための初期指示に基づいて構築されています」と説明しています。この最後の部分が重要なのです。スキルコレクションは数多く存在しますが、这里的（ここでは）差別化要素は、エージェントがタスクを開始する前に関連するスキルを確認することを強制するブートストラップ指示です。これにより、スラッシュコマンドを覚える必要がなく、ワークフローが自動的に起動します。
その哲学は、プロジェクト自身のドキュメントにも明確に示されています。
- テスト駆動開発 (TDD) – 常に先にテストを書く
- 体系的であること (Systematic over ad-hoc) – 推測よりもプロセスを重視
- 複雑性の低減 (Complexity reduction) – シンプルさこそが第一の目標
- 証拠による主張 (Evidence over claims) – 成功を宣言する前に検証する
実際には、この哲学は、相互にバトンタッチするスキルの一連の流れとして現れます。開発者向け Claude Skills と SKILL.md を読まれた方であれば、その仕組みに親しみをおぼえるでしょう。Superpowers は、まさにその種の SKILL.md ディレクトリからなる、大規模かつ意見のある（opinionated）セットであり、自分で作成するのではなく、インストール可能なプラグインとして配布されています。
##コーディングエージェント全体への Superpowers インストール
インストールはハネスごとに異なり、プロジェクト側も、使用する各エージェントに対して個別にインストールするよう明示しています。グローバルな一括インストールは存在しません。
Claude Code
Superpowers は、Claude Code 向けの 2 つのマーケットプレイスを通じて配布されています。
# 公式の Anthropic プラグインマーケットプレイス
/plugin install superpowers@claude-plugins-official
または、関連するプラグインもいくつか掲載されている専用の Superpowers マーケットプレイスを通じて：
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
Cursor
/add-plugin superpowers
また、Cursor のプラグインマーケットプレイス UI で「superpowers」と検索することもできます。
その他のエージェント
| エージェント | インストールコマンド |
|---|---|
| Codex App | プラグインサイドバー -> Coding セクション -> Superpowers をインストール |
| Codex CLI | /plugins、superpowers を検索、Install Plugin を選択 |
| Antigravity | agy plugin install https://github.com/obra/superpowers |
| Devin CLI | devin plugins install obra/superpowers |
| Factory Droid | droid plugin marketplace add https://github.com/obra/superpowers 続いて droid plugin install superpowers@superpowers |
| Gemini CLI | gemini extensions install https://github.com/obra/superpowers |
| GitHub Copilot CLI | copilot plugin marketplace add obra/superpowers-marketplace 続いて copilot plugin install superpowers@superpowers-marketplace |
| Grok Build CLI | grok plugin install superpowers@xai-official --trust |
| Kimi Code | /plugins install https://github.com/obra/superpowers |
| OpenCode | リポジトリから .opencode/INSTALL.md を取得してそれに従う（他の場所で使用済みでも別途インストールが必要） |
| Pi | pi install git:github.com/obra/superpowers |
| Hermes Agent | hermes plugins install obra/superpowers --enable |
実際のタスクを実行する前に、いくつかのインストール詳細に注意が必要です。
- Antigravity は、プラグインのセッション開始フックを自動的に実行するため、最初のメッセージから Superpowers が有効になります。同じコマンドで再インストールすることで更新されます。
- Pi は、小さな拡張機能を通じてスキルを読み込み、セッション開始時とコンテキスト圧縮後に
using-superpowersブートストラップを注入します。Pi はネイティブのスキルサポートを備えているため、Pi の互換性のあるSkillツールは必要ありません。 - Hermes Agent にはポストコンパクション（圧縮後）フックがありません。最初のターンを超えて圧縮される非常に長いセッションでは、ブートストラップが失われる可能性があります。スキルがトリガーされなくなった場合は、新しいセッションを開始してください。
- OpenCode は、すでに使用している他のどのハネスからのインストールパスとも完全に区別されます。同じマシンであっても同様です。
インストールの確認
インストール後、サイレントな成功メッセージを信じるのではなく、直接エージェントに問い合わせてください。
利用可能なスキルは？
Superpowers が正しくインストールされていれば、エージェントは結果として brainstorming、writing-plans、test-driven-development、subagent-driven-development などのスキルを列挙するはずです。これは、トリガーされない Claude Skills のデバッグ において推奨されるのと同じ探索チェックです。スキルが存在するにもかかわらずアクティブにならない場合、原因はモデルではなく、ルーティング用の説明（description）であることがほとんどです。
Superpowers ワークフロー：ブレインストーミングから出荷コードまで
Superpowers は「基本ワークフロー」として 7 つのスキルを文書化しており、それぞれが特定の時点で活性化し、次のステップへバトンタッチします。
または executing-plans}
⬇
- brainstorming は、コードが書かれる前に活性化します。質問を通じて曖昧なアイデアを洗練させ、代替案を探索し、一つの長いドキュメントではなく、レビューしやすい短かいブロックとしてデザインを提示します。その後、結果を設計成果物として保存します。
- using-git-worktrees は、デザインが承認されると活性化します。新しいブランチ上で分離されたワークスペースを作成し、プロジェクトセットアップを実行し、実装を開始する前にクリーンなテストベースラインを確認します。
- writing-plans は、承認されたデザインを、各タスクあたり 2〜5 分程度の作業量（Superpowers の目標）に分割します。正確なファイルパス、関連する場所での完全なコード、そして明確な検証手順を含めます。
- subagent-driven-development（高速反復）または executing-plans（人間のチェックポイントを持つバッチ実行）は、タスクごとに新しいサブエージェントを派遣します。2 段階のレビューを行い、まず仕様の準拠を確認し、次にコード品質を確認します。
- test-driven-development は、厳格なリダース（赤-緑-リファクタ）を強制します。失敗するテストを書き、失敗を確認し、合格するための最小限のコードを書き、合格を確認し、コミットします。失敗するテストが存在する前に書かれたコードは保持されず、削除されます。
- requesting-code-review は、タスクの間で活性化します。プランに対する差分（diff）をレビューし、重大度別に問題を報告します。重大な問題は、次のタスクへの進捗をブロックします。
- finishing-a-development-branch は、すべてのタスクが完了すると活性化します。テストが合格することを確認した後、オプション（マージ、PR の作成、ブランチの保持、破棄）を提示し、ワークスペースをクリーンアップします。
これは、要件からコードへの仕様駆動開発ワークフロー に記載されているツール非依存の 5 フェーズのループと密接に関連しています。specify（仕様化）が brainstorming になり、plan（計画）が writing-plans になり、tasks と implement（実装）が subagent-driven-development に統合され、validate（検証）は TDD とコードレビューに分かれます。違いは「強制」にあります。Superpowers は、各フェーズを呼び出すことを使用者に頼るのではなく、エージェントがこれらのスキルを自動的に確認するように構築されています。
試してみる：最初のタスクの実践例
最初のランで、Superpowers を最も重要な機能に向けないでください。現実的だが範囲が絞られているもの（小さなエンドポイント、焦点の当てられたバグ修正、単一のモジュールのリファクタリングなど）を選び、すでにテストスイートを持つプロジェクトでセッションを開始してください。TDD の強制が最も顕著に現れるのはそこです。
パブリック API エンドポイントにレート制限を追加したいです。
Superpowers がインストールされていれば、セッションはコードではなく、ブレインストーミングの質問から始まることを期待してください。どのエンドポイントか、制限は何件か、ユーザー別かキー別か、制限に達した場合はどうなるべきか、といった質問です。この摩擦は意図的なものです。これは、要件からコードへの仕様駆動開発ワークフロー で説明されている非目標（non-goals）の規律と同じものですが、覚えておくことではなく、スキルによって強制されています。ブロックごとにデザインを承認すると、ファイル変更の前に、番号付きの小さなタスクが並んだプランが表示されることを期待してください。その後、各タスクごとに 1 つのサブエージェントが派遣され、各チェックポイントでレビューできる diff が提供されます。
最初のランで注意すべき 2 つのこと：
- TDD が実際に強制されていることを確認する。 エージェントに 1 つのタスクを実装させ、実装の前に失敗するテストが表示されるか確認してください。コードが先に到着した場合、そのステップでスキルがトリガーされなかったことを意味し、インストールセクションからの探索チェックを再実行する価値があります。
- タスクの粒度に注意する。 2〜5 分というタスクサイズ設定は、一部のコードベースに対しては過度に厳しすぎます。プロジェクトに対してタスクが不要に細分化されていると感じる場合、事後に対処するのではなく、writing-plans のレビューチェックポイント中に指摘する価値があります。
中身：スキルライブラリ
7 つのワークフロースキルの他にも、Superpowers は分野別にグループ化されたサポートスキルを備えています。
| カテゴリ | スキル |
|---|---|
| テスティング | test-driven-development（テストのアンチパターン参考資料を含む） |
| デバッグ | systematic-debugging（4 フェーズの根本原因プロセス、root-cause-tracing、defense-in-depth、condition-based-waiting を含む）、verification-before-completion |
| コラボレーション | brainstorming、writing-plans、executing-plans、dispatching-parallel-agents、requesting-code-review、receiving-code-review、using-git-worktrees、finishing-a-development-branch、subagent-driven-development |
| メタ | writing-skills（テストメソドロジーを用いて新しいスキルを作成）、using-superpowers（ブートストラップと紹介） |
dispatching-parallel-agents は個別に注目に値します。これは並列サブエージェントワークフローをカバーしており、Claude Code サブエージェント と同じ領域です。中間出力でメインセッションを埋め尽くすのではなく、分離されたコンテキスト、独立したレビュー、そしてメインセッションへの要約報告を行います。
Superpowers が適している場合（と適さない場合）
適している場合：
- 仕様駆動開発 vs バイブコーディング における Claude Code スキルアプローチは好きだが、レビューゲートを強制するものがないため、構造化されていないプロンプト入力に後戻りしてしまう。
- 複数のコーディングエージェントを横断して作業しており、Claude Code 限定のスキルではなく、自分についてくる単一のメソドロジーを求めている。
- 強制ロジックを自分で書くことなく、厳格な TDD 強制を求めている。
- アーキテクチャの漂流や制約の忘却が実際のリスクとなるマルチセッション機能 – 仕様駆動開発 vs バイブコーディング に記述されているまさにその失敗モード。
適さない場合：
- 簡単なスクリプト、使い捨てのプロトタイプ、一回限りのオートメーション – ブレインストーミングとプランニングのオーバーヘッドは実在しており、50 行の変更に対して支払う価値はありません。
- 既存の、調整済みのプロジェクト固有の SDD スキルを持つチーム。Superpowers は、そのカスタマイズ性を強制された、意見のある儀式と引き換えにします。すでに機能しているものを保ち、個々のスキルのアイデアだけを借りることを好むかもしれません。
- 確立されたチームプロセス（変更する準備ができていないもの）と、厳格な 2〜5 分のタスク粒度や必須の TDD が競合する環境。
他の SDD ツールとの Superpowers の違い
Superpowers は、通常の意味で GitHub Spec Kit や AWS Kiro の競合ではありません – それはスタンドアロン CLI や IDE としてではなく、Claude Code / クロスエージェント スキルレイヤーで動作します。Spec Kit は移植可能なマークダウン成果物とエージェントの独立性を提供し、Kiro はガイド付き統合 IDE エクスペリエンスを提供し、手作りの Claude Code スキルは最大の柔軟性とゼロの強制を提供します。Superpowers は最後の 2 つの間に位置します。DIY Claude Code ワークフローと同じスキルベースのメカニズムですが、リポジトリローカルのスキルが提供しない、強制されるような感じの enforcement（強制）と、クロスエージェントのプラグイン配布を備えています。
Spec Kit、Kiro、Claude Code スキル、OpenSpec、BMAD-METHOD、Tessl における移植性、セットアップの摩擦、レビューゲート、およびロックインの完全な分解 – Superpowers が比較表と意思決定フレームワークの中でどこに位置するかを含む – については、GitHub Spec Kit vs Kiro vs Claude Code SDD ワークフロー をご覧ください。強制された儀式を減らし、既存のコードベース（brownfield codebase）での反復のための自由度を増やしたい場合、OpenSpec クイックスタート が、変更中心の軽量な代替手段をカバーしています。
トラブルシューティングと知っておくべきこと
更新は主に自動ですが、エージェント依存です。 インストールが最新に保たれるかはハネスに依存します – Antigravity は再インストール時にセッション開始フックを再実行し、npm または Git ベースのインストールには明示的な更新コマンドが必要で、マーケットプレイスベースのインストールは通常、ホストエージェント独自のプラグイン更新フローに従います。
テレメトリはデフォルトでオンですが、無効化は簡単です。 brainstorming スキルの任意の視覚的コンパニオンは、Prime Radiant のウェブサイトからロゴを読み込みます。これには Superpowers のバージョンは含まれますが、プロジェクト、プロンプト、クリックデータは含まれません。SUPERPOWERS_DISABLE_TELEMETRY を真（true）の値に設定することで、これを無効にできます。Superpowers はまた、Claude Code 自身の DISABLE_TELEMETRY および CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC のオプトアウトも尊重します。
貢献には dev ブランチが必要です。 スキルを変更または追加したい場合、リポジトリをフォークし、dev に切り替え、変更を作成・テストするための writing-skills スキルに従ってください。新しいスキルの貢献は、すべてのサポート対象エージェントで同じように動作しなければならず、一般的には受け入れられません。
スキルがトリガーされない場合、他の Claude Skill の問題と同様に扱ってください。 探索を確認するために「利用可能なスキルは？」と問いかけ、現在使用している特定のエージェント（同じマシン上の別物ではない）に対してインストールしたことを確認してください。そして、ブートストラップがサイレントに脱落した場合、長いセッションの圧縮後は Hermes セッションは新規開始を必要とすることを覚えておいてください。
結論
Superpowers は、あなたの SDD の意図と、セッションで実際に起きることの間のギャップが、解決しようとしている問題である場合に、インストールする価値があります。これは新しい specify-plan-implement アイディアを導入するものではありません – そのループはすでに 仕様駆動開発とは？仕様を真実の源として で十分にカバーされています – 既存のアイディアをスキップしにくくし、リポジトリローカルのスキルが到達できる範囲を超える多くのエージェントでそれを可能にします。まず、毎日使用する 1 つのハネスにインストールし、小さな範囲の絞ったタスクをブレインストーミングから完了までの完全なサイクルを通じて実行し、その後、強制された儀式が実際のワークロードでその価値を発揮するかどうかを判断してください。
関連リンク
- Superpowers リポジトリ – ソース、スキル、およびすべてのサポート対象エージェント向けのプラグインマニフェスト
- Superpowers マーケットプレイス – Superpowers と関連プラグインの Claude Code マーケットプレイス
- GitHub Spec Kit vs Kiro vs Claude Code SDD ワークフロー – 完全なツール比較と意思決定フレームワーク
- 開発者向け Claude Skills と SKILL.md – Superpowers が基盤とする基礎となるスキルメカニクス
- Claude Code サブエージェント：セットアップ、設定、使用タイミング – 分離コンテキストによるレビュー、subagent-driven-development の背後にあるメカニズム
- 要件からコードへの仕様駆動開発ワークフロー – Superpowers が自動化するツール非依存の 5 フェーズのプロセス
- 仕様駆動開発とは？仕様を真実の源として – SDD のコアコンセプトと用語
- Ollama、llama.cpp、価格設定向けの Claude Code インストールと設定 – Superpowers を追加する前に、Claude Code 自体をインストール
