Superpowers クイックスタート：インストール、ワークフロー、および試行

1コマンドでインストールできる、強制SDDスキル。

Superpowers は、完全な仕様駆動型メソッドをインストール可能な Claude Skills にパッケージ化し、ブレインストーミング、計画立案、サブエージェントによる実装、厳格な TDD（テスト駆動開発）を強制します。これにより、これらの構造をユーザー自身が判断する必要がなくなります。

ほとんどの Claude Code SDD（仕様駆動開発）セットアップは、同じ方法で失敗します。誰かが一度しっかりした specify-plan-implement スキルを作成し、1週間ほど真面目に使用した後、締め切りが近づくと途端に構造化されていないプロンプト入力に戻ってしまうのです。手作りのスキルには、これを防ぐ仕組みが何もありません。Superpowers は、この規律の問題に対する直接的な回答です。Jesse Vincent 氏と Prime Radiant チームが構築したこのスキルパッケージは、ブレインストーミング、計画立案、サブエージェントによるレビュー、そしてレッド・グリーン・リファクタリングの TDD を、エージェントが各タスクの前に確認すべき必須ステップとして位置づけ、圧力下でスキップできる任意の提案とはしていません。

Superpowers skills framework installed across coding agents

フットノートではなく、専用の紹介記事に値する理由は、インストール方法にあります。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 とは何か？

Superpowers は自身を、「あなたのコーディングエージェントのための完全なソフトウェア開発メソッドであり、構成可能なスキルのセットと、エージェントがそれらを使用することを確実にする初期指示の上に構築されている」と説明しています。この最後の部分こそが重要です。スキルコレクションは数多く存在しますが、ここでの差別化要素は、エージェントがタスクを開始する前に関連するスキルを確認することを強制するブートストラップ指示です。これにより、ワークフローはスラッシュコマンドを覚えている必要なく自動的にアクティブになります。

その哲学は、プロジェクト独自のドキュメントに明確に述べられています。

テスト駆動開発（TDD） – 常に最初にテストを書く
体系的であること vs 臨機応変であること – 推測ではなくプロセスを重視する
複雑さの削減 – シンプルさを第一の目標とする
主張ではなく証拠 – 成功を宣言する前に検証する

実際には、この哲学は、互いに引き継ぎを行う一連のスキルとして現れます。開発者向け Claude Skills と SKILL.md を読んだことがあるなら、その仕組みは馴染みがあるでしょう。Superpowers は、まさにその種の SKILL.md ディレクトリの、大規模で意見の強いセットであり、自分で作成するものではなく、インストール可能なプラグインとして配布されています。

コーディングエージェント全体での 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	Plugins サイドバー -> 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 は、すでに使用している他のハーネスからのインストールパスとは完全に独立したものと扱います。同じマシンであっても同様です。

インストールの検証

インストール後、沈黙の成功メッセージを信じるのではなく、エージェントに直接質問してください。

What skills are available?

Superpowers が正しくインストールされていれば、エージェントは結果の中に brainstorming、writing-plans、test-driven-development、subagent-driven-development などのスキルをリスト表示するはずです。これは、トリガーされない Claude Skills のデバッグに対して推奨される同じ発見チェックです。スキルが存在するのにアクティブにならない場合、問題のほとんどはモデルではなく、ルーティング説明（description）です。

Superpowers ワークフロー：ブレインストーミングから出荷コードまで

Superpowers は「基本的なワークフロー」として7つのスキルを文書化しており、それぞれが特定の時点でアクティブになり、次のスキルに引き継ぎます。

flowchart LR A[brainstorming] --> B[using-git-worktrees] --> C[writing-plans] --> D{subagent-driven-development
or executing-plans}

⬇

flowchart LR E[test-driven-development] --> F[requesting-code-review] --> G[finishing-a-development-branch]

brainstorming は、コードが書かれる前にアクティブになります。質問を通じて粗略なアイデアを磨き上げ、代替案を探り、1つの長いドキュメントではなく、レビュー可能な短いチャンクで設計を提示します。その後、結果を設計成果物として保存します。
using-git-worktrees は、設計を承認した時点でアクティブになります。新しいブランチ上で隔離されたワークスペースを作成し、プロジェクトのセットアップを実行し、実装を開始する前にクリーンなテストベースラインを検証します。
writing-plans は、承認された設計を一口大のタスクに分割します。Superpowers はタスクごとに2〜5分間の作業を目標とし、正確なファイルパス、関連する箇所の完全なコード、そして明確な検証手順を含めます。
subagent-driven-development（高速反復）または executing-plans（人間によるチェックポイント付きのバッチ実行）は、タスクごとに新しいサブエージェントをディスパッチし、2段階のレビューを行います。まず仕様適合性、次にコード品質です。
test-driven-development は、厳格なレッド・グリーン・リファクタリングを強制します。失敗するテストを書き、それが失敗することを確認し、パスするための最小限のコードを書き、それがパスすることを確認し、コミットします。失敗するテストが存在する前に書かれたコードは、保持されるのではなく削除されます。
requesting-code-review は、タスクの間にアクティブになり、計画に対する差分をレビューし、重大度別に問題を報告します。重大な問題がある場合、次のタスクへの進行がブロックされます。
finishing-a-development-branch は、すべてのタスクが完了した時点でアクティブになります。テストがパスすることを確認した後、選択肢を提示します（マージ、PR を開く、ブランチを保持、破棄）。そしてワークスペースをクリーンアップします。

これは、要件からコードへの仕様駆動開発ワークフローに記載されているツール非依存の5フェーズループと密接に関連しています。specify は brainstorming に、plan は writing-plans に、tasks と implement は subagent-driven-development に集約され、validate は TDD とコードレビューに分割されます。違いは強制力にあります。Superpowers は、エージェントがこれらのスキルを自動的に確認するように構築されており、各フェーズを呼び出すことをユーザーに頼るものではありません。

試してみる：最初のタスクのウォークスルー

最初のランで、Superpowers を最も重要な機能に向けないでください。現実的だが範囲の限られたものを選びましょう。小さなエンドポイント、焦点を絞ったバグ修正、単一モジュールのリファクタリングなどです。TDD の強制が最も顕著に現れるため、すでにテストスイートを持つプロジェクトでセッションを開始してください。

I want to add rate limiting to our public API endpoints.

Superpowers をインストールすると、セッションはコードではなく、ブレインストーミングの質問から始まることが予想されます。どのエンドポイントか、制限は何にするか、ユーザー単位かキー単位か、制限に達したときに何が起きるべきかなどです。この摩擦は意図的なものです。これは、要件からコードへの仕様駆動開発ワークフローで説明されているのと同じ非目標（non-goals）の規律であり、ユーザーが覚えていることを頼るのではなく、スキルによって強制されています。設計をチャンクごとに承認すると、ファイル変更の前に、番号付きの小さなタスクを含む計画が提示され、その後、タスクごとに1つのサブエージェントがディスパッチされ、各チェックポイントで差分をレビューする流れが予想されます。

最初のランで注目すべき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 Vibe Coding における Claude Code スキルアプローチが好きですが、レビューゲートを強制するものがないため、構造化されていないプロンプト入力に戻ってしまいます。
複数のコーディングエージェントで作業しており、Claude Code 専用のスキルではなく、自分とともに移動する1つのメソッドが欲しいです。
強制ロジックを自分で書くことなく、厳格な TDD 強制が欲しいです。
アーキテクチャのドリフトや制約の忘却が実際のリスクとなる、マルチセッションの機能開発。これは仕様駆動開発 vs Vibe Coding で説明されているまさにその失敗パターンです。

適さない場合：

クイックスクリプト、使い捨てのプロトタイプ、一回限りの自動化。ブレインストーミングと計画のオーバーヘッドは実在し、50行の変更に対して支払う価値はありません。
既存の、良く調整されたプロジェクト固有の SDD スキルを持つチーム。Superpowers は、そのカスタマイズを強制された、意見の強い儀式と交換します。すでに機能しているものを保持し、個人のスキルアイデアだけを借用する方が好ましいかもしれません。
厳格な2〜5分のタスク粒度または必須 TDD が、変更する準備ができていない確立されたチームプロセスと競合する環境。

他の SDD ツールとの Superpowers の違い

Superpowers は、通常の意味で GitHub Spec Kit や AWS Kiro の競合ではありません。それは単一の CLI や IDE ではなく、Claude Code / クロスエージェントのスキルレイヤーで動作します。Spec Kit は移植可能な Markdown 成果物とエージェントの独立性を提供し、Kiro はガイド付きで統合された IDE エクスペリエンスを提供します。手作りの Claude Code スキルは、ゼロの強制力と引き換えに最大の柔軟性を提供します。Superpowers は、後者の2つの間に位置しています。DIY の Claude Code ワークフローと同じスキルベースのメカニズムを持ちますが、リポジトリローカルのスキルが提供しない、必須のように感じられる強制力とクロスエージェントのプラグイン配布を備えています。

Spec Kit、Kiro、Claude Code スキル、OpenSpec、BMAD-METHOD、Tessl における移植性、セットアップの摩擦、レビューゲート、ロックインに関する完全な分析、および比較表と意思決定フレームワークにおける Superpowers の位置づけについては、GitHub Spec Kit vs Kiro vs Claude Code SDD ワークフローを参照してください。

トラブルシューティングと知っておくべきこと

更新はほとんど自動的ですが、エージェントによって異なります。 インストールが最新に保たれる方法はハーネスに依存します。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 の問題と同様に扱ってください。 発見を確認するために「What skills are available?」と質問し、現在使用している特定のエージェント（同じマシン上の別のエージェントではない）に対してインストールしたことを確認してください。また、ブートストラップがサイレントにドロップした場合、長いセッションの圧縮後に Hermes セッションは新しい開始を必要とすることを覚えておいてください。

結論

Superpowers は、SDD の意図とセッションで実際に起こることの間のギャップが、解決しようとしている問題である場合にインストールする価値があります。それは新しい specify-plan-implement のアイデアを導入するものではありません。そのループはすでに仕様駆動開発とは何か？で十分にカバーされています。既存のアイデアをスキップしにくくし、リポジトリローカルのスキルが届くよりも多くのエージェントでそれを可能にします。まず毎日使用する1つのハーネスにインストールし、小さな範囲の限られたタスクをブレインストーミングから完了までの完全なサイクルで実行し、その強制された儀式が実際のワークロードに見合う価値があるかどうかをそこから判断してください。