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

1つのコマンドでインストール可能な、強制SDDスキル。

目次

Superpowers は、仕様駆動開発の完全な方法をインストール可能な Claude Skills にパッケージ化しており、ブレインストーミング、計画立案、サブエージェントによる実装、厳格なTDD（テスト駆動開発）を強制します。これらの構造をユーザー自身に委ねることはありません。

多くの Claude Code の SDD（Spec-Driven Development：仕様駆動開発）セットアップは、同じように失敗します。ある人が堅牢な specify-plan-implement スキルを一度作成し、一週間真剣に使った後で、締め切りが近づいた最初の時点で、構造化されていないプロンプティングに静かに戻ってしまうのです。手作りスキルには、そのような逸脱を実際に防ぐ何かが存在しません。Superpowers は、この規律の問題に対する直接的な答えです – Jesse Vincent 氏と Prime Radiant のチームによって構築されたスキルパッケージで、ブレインストーミング、計画立案、サブエージェントレビュー、赤-緑-リファクタリングのTDDを、圧力下でスキップできる任意の提案ではなく、エージェントがすべてのタスクの前に確認すべき必須ステップとして扱います。

Superpowers スキルフレームワークがコーディングエージェント全体にインストールされた様子

脚注ではなく、独自の検証に値するものにするのがインストールストーリーです。Superpowers は、Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot CLI、Grok Build CLI、Kimi Code、OpenCode、Pi、Devin CLI、Factory Droid、Hermes Agent 向けのプラグインマニフェストを同梱しており、1つのリポジトリの .claude/skills/ フォルダに留まることなく、同じ方法論がハーネスを横断してあなたに従います。このガイドでは、それが実際になのか、使用しているエージェントでインストールと検証を行う方法、最初のエンドツーエンドの実行がどのように見えるか、そして他の仕様駆動開発ツールに隣接してどこに位置するかを扱います。

Superpowers とは？

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

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

  • テスト駆動開発（TDD） – 常にまずテストを書く
  • 系統的アプローチをアドホックなアプローチよりも優先 – 推測ではなくプロセス
  • 複雑性の削減 – 単純さを主な目標とする
  • 主張ではなく証拠 – 成功を宣言する前に検証する

実践において、この哲学は互いへ引き継ぐ一連のスキルとして現れます。開発者向け 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 は、同じマシンであっても、すでに使用している他のハーネスとは完全に別個のインストールパスとして扱います。

インストールの検証

インストールが完了したら、無音の成功メッセージを信用するのではなく、エージェントに直接問いかけます：

利用可能なスキルは何ですか？

Superpowers が正しくインストールされている場合、エージェントは brainstorming、writing-plans、test-driven-development、subagent-driven-development などのスキルを一覧表示すべきです。これは、トリガーされない Claude Skills のデバッグ におすすめの同じような発見チェックです – スキルが存在するが有効化されない場合、問題がモデルではなくルーティング説明であることがほぼ常に原因です。

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

Superpowers は7つのスキルを「基本的なワークフロー」として文書化しており、それぞれが特定の時点で有効化され、次のものへ引き継ぎます：

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

⬇

flowchart LR E[test-driven-development] --> F[requesting-code-review] --> G[finishing-a-development-branch]
  1. brainstorming はコードが書かれる前に有効化されます。質問を通じて曖昧なアイデアを洗練させ、代替案を探索し、1つの長いドキュメントではなく、短いレビュー可能なチャンクで設計を提示します – その後、結果を設計成果物として保存します。
  2. using-git-worktrees は設計に承認した際に有効化されます。新しいブランチ上で分離されたワークスペースを作成し、プロジェクトセットアップを実行し、実装開始前にクリーンなテストベースラインを検証します。
  3. writing-plans は承認された設計を小分けのタスクに分解します – Superpowers は1タスクあたり2分から5分の作業を目標とします – 正確なファイルパス、関連する箇所での完全なコード、明示的な検証ステップを伴います。
  4. subagent-driven-development（高速反復）または executing-plans（人間によるチェックポイントを伴うバッチ実行）は、タスクごとに新しいサブエージェントをディスパッチし、2段階のレビューを行います：まず仕様コンプライアンス、次にコード品質。
  5. test-driven-development は厳格な赤-緑-リファクタリングを強制します – 失敗するテストを書き、その失敗を観察し、パスするための最小限のコードを書き、そのパスを観察し、コミットします。失敗するテストが存在する前に書かれたコードは、保持されるのではなく削除されます。
  6. requesting-code-review はタスク間に有効化され、計画に対する差分をレビューし、重大度別に問題を報告します。深刻な問題は次のタスクへの進歩をブロックします。
  7. finishing-a-development-branch はすべてのタスクが完了した時点で有効化されます。テストがパスすることを確認し、その後、選択肢を提示します – マージ、PRの作成、ブランチの保持、または破棄 – かつワークスペースをクリーンアップします。

これは、要件からコードまでの仕様駆動開発ワークフロー にあるツール中立の5フェーズループに密接にマップされます：specify（仕様化）が brainstorming になり、plan（計画）が writing-plans になり、tasks（タスク）と implement（実装）が subagent-driven-development に収まり、validate（検証）が TDD とコードレビューに分割されます。違いは強制力です – Superpowers は、あなたが各フェーズを呼び出すことに頼るのではなく、エージェントがこれらのスキルを自動的に確認するように構築されています。

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

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

公開APIエンドポイントにレートリミティングを追加したいと思います。

Superpowers がインストールされている場合、セッションはコードではなくブレインストーミングの質問から始まることを期待してください：どのエンドポイントか、制限は何、ユーザーごとかキーごとか、制限に達したときに何が起きるべきか。その摩擦は意図的なものです – それは、要件からコードまでの仕様駆動開発ワークフロー で取り上げられている、非ゴールの規律と同じですが、あなたが覚えるのではなく、スキルによって強制されます。チャンク単位で設計に承認すると、ファイルの変更の前に番号付きの小タスクの計画を期待し、その後、各チェックポイントでレビューする差分を伴い、タスクごとに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 雰囲気コーディング の Claude Code スキルアプローチをすでに気に入っているが、レビューゲートを強制するものが何もないため、構造化されていないプロンプティングに滑り戻り続ける場合。
  • 複数のコーディングエージェントを横断して作業し、Claude Code 専用のスキルではなく、あなたに従う単一の方法論を求めている場合。
  • 強制ロジックを自身で書くことなく、厳格な TDD の強制を求めている場合。
  • アーキテクチャの逸脱や忘れられた制約が実際のリスクとなるマルチセッションの機能 – 仕様駆動開発 vs 雰囲気コーディング で述べられているまさにその失敗モードの場合。

適合しない場合：

  • クイックスクリプト、使い捨てのプロトタイプ、単発の自動化 – ブレインストーミングと計画のオーバーヘッドは実在しており、50行の変更に対してそれを書く価値はありません。
  • 既存の、調整の整ったプロジェクト固有の SDD スキルを持つチーム。Superpowers は、そのカスタマイゼーションを強制された、意見の強いセレモニーとのトレードオフとします。すでに機能しているものを保ち、個々のスキルアイデアだけを借りることを好むかもしれません。
  • 厳格な2分から5分のタスク粒度設定や必須の TDD が、変更する準備ができていない確立されたチームプロセスと競合する環境。

Superpowers が他の SDD ツールと異なる点

Superpowers は、通常の意味で GitHub Spec Kit や AWS Kiro の競合相手ではありません – それはスタンドアロンCLIやIDEではなく、Claude Code / クロスエージェントスキルレイヤーで動作します。Spec Kit は移植可能なマークダウン成果物とエージェントの独立性を提供します。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 ワークフロー をご覧ください。強制セレモニーを少なく、ブラウングリーンコードベースで反復する自由度を多く求める場合、OpenSpec クイックスタート は、より軽量な、変更中心の代替手段を扱っています。そして、あなたが欠かしている役割が Superpowers が担わないもの – プロダクトレビュー、ブラウザQA、セキュリティ監査、リリースエンジニアリング – である場合、gstack はそれらを仮想エンジニアリングチームとしてパッケージ化しており、Superpowers と組み合わせることができます。その際、Superpowers は実装フェーズ内の規律を供給します。

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

更新はほぼ自動的ですが、エージェントによって異なります。 インストールがどれだけ最新を維持できるかはハーネスに依存します – Antigravity は再インストール時にセッション開始フックを再実行し、npm または Git ベースのインストールは明示的な更新コマンドを必要とし、マーケットプレイスベースのインストールは通常、ホストエージェント自身のプラグイン更新フローに従います。

テレメトリはデフォルトで有効ですが、無効化は容易です。 brainstorming スキルのオプションのビジュアルコンパニオンは、ウェブサイトから Prime Radiant のロゴを読み込みます。これには Superpowers のバージョンが含まれますが、プロジェクト、プロンプト、クリックデータは含まれません。SUPERPOWERS_DISABLE_TELEMETRY を任意の真の値に設定してオフにします。Superpowers はまた、Claude Code 独自の DISABLE_TELEMETRY と CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC のオプトアウトも尊重します。

貢献には dev ブランチが必要です。 スキルを変更または追加する場合、リポジトリをフォークし、dev に切り替え、writing-skills スキルに従って変更の作成とテストを行います – 新しいスキル貢献は一般的に受け入れられていません。すべてのスキルがサポートされているすべてのエージェントで同様に機能する必要があるためです。

スキルがトリガーされない場合、他の Claude Skill の問題と同様に扱ってください。 発見を確認するために「利用可能なスキルは何ですか？」と問い、現在使用している特定のエージェント（同じマシン上の別物ではなく）に対してインストールしたことを確認し、ブートストラップが静かにドロップした場合、Hermes セッションは長セッション圧縮後に新しい開始を必要とすることを思い出してください。

結論

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

便利なリンク

購読する

システム、インフラ、AIエンジニアリングの新記事をお届けします。