superpowers — AIコーディングエージェントに仕様策定やTDDを促す開発フレームワーク
obra/superpowers
★ 319,401 ・ Shell ・ MIT
概要
superpowers は、AIコーディングエージェントを対象としたソフトウェア開発方法論およびエージェント向けスキルフレームワークです。リポジトリの説明では「動作するエージェント向けスキルフレームワークおよびソフトウェア開発方法論(An agentic skills framework & software development methodology that works.)」と定義されています。
通常のAIコーディングツールでは、プロンプトを入力するとすぐにコードの記述が始まってしまい、設計の齟齬や不要な実装、テストの欠落が発生しがちです。superpowers を導入すると、エージェントはすぐにコードを書くのを止め、まずユーザーに対話を通じて「本当に作ろうとしているものは何か」をヒアリングします。その後、仕様書の作成、テスト駆動開発(TDD)に基づいた実装計画の立案、サブエージェントを用いた個別タスクの進行とセルフレビューまでを一貫して自動制御します。
Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot CLIなど、多岐にわたるAI開発環境(ハーネス)を利用しており、エージェントの暴走を防ぎながら堅実な開発プロセスを踏ませたいエンジニアに向いています。
主な特徴
- 即座の実装を防ぐブレインストーミング機能: 開発作業を検知すると、エージェントはいきなりコードを書かず、質問を通じて要件や意図を引き出します。まとまった仕様は読みやすい単位でユーザーに提示されます。
- TDD・YAGNI・DRYを徹底した計画立案: 設計の合意後、前提知識が乏しい開発者でも迷わず実装できるレベルの明確な計画書を作成します。テスト駆動開発(Red/Green TDD)やYAGNI、DRY原則を強く意識したステップが組み立てられます。
- サブエージェント主導の開発(subagent-driven-development): 計画立案後に実行を指示すると、サブエージェントが各工学タスクを分担して進めます。エージェント自身が作業内容の検証とレビューを挟みながら、計画から逸脱することなく自律的に作業を継続します。
- Git Worktreeによる環境分離: ワークフローの一環として、設計承認後に新しいブランチ上のGit Worktreeを作成し、作業環境を分離した状態でタスクを遂行します。
- 多彩なAIハーネスへの横断対応: 特定のツールに依存せず、主要なCLIやエディタ向けAIツールに対して個別のプラグインや拡張機能として導入できる仕組みが整っています。
使い方
superpowers の導入方法は、利用している環境(ハーネス)によって異なります。複数の環境で使う場合は、それぞれの環境で個別にインストールを行う必要があります。
Claude Code での利用
公式マーケットプレイスから直接インストールできます。
/plugin install superpowers@claude-plugins-official
また、リポジトリが用意している専用マーケットプレイスを登録して導入することも可能です。
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
Cursor での利用
Cursor Agentのチャット内で以下のコマンドを実行するか、マーケットプレイスで「superpowers」を検索して追加します。
/add-plugin superpowers
Codex(OpenAI)での利用
Codex Appを利用している場合は、サイドバーの「Plugins」からCodingセクションにある Superpowers を追加します。
Codex CLIの場合は、プラグイン検索画面から導入します。
/plugins
# 検索で superpowers と入力してインストール
GitHub Copilot CLI での利用
マーケットプレイスを登録してからプラグインをインストールします。
copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace
Gemini CLI での利用
拡張機能として直接GitHubリポジトリを指定してインストールします。
gemini extensions install https://github.com/obra/superpowers
更新する際は以下のコマンドを実行します。
gemini extensions update superpowers
Devin CLI での利用
Devin CLI環境では、以下のコマンドで導入および更新が行えます。
# インストール
devin plugins install obra/superpowers
# アップデート
devin plugins update superpowers
その他の対応環境
READMEにはこのほかにも、Antigravity、Factory Droid、Grok Build CLI、Kimi Code、OpenCode、Pi、Qwen Code、Hermes Agent、Muse などのツールへの導入手順が記載されています。導入後はスキルが自動的にロードされるため、特別なコマンドを都度打つことなく「ReactのToDoアプリを作りたい」といった通常の依頼を行うだけでワークフローが起動します。
技術的なポイント
- コンポーザブルなスキル設計: 各種機能は独立したスキルとしてモジュール化されており、エージェントセッションの開始時に初期指示(ブートストラップ)が読み込まれることで、状況に応じて必要なスキルが連鎖的に呼び出されます。
- セッション開始フックとブートストラップの注入: たとえばMuseではネイティブの
SessionStartフックを使い、Piでは起動時およびコンパクション(会話圧縮)後にusing-superpowersを自動注入する仕組みを採用しています。これにより、ユーザーが意識して呼び出さなくてもエージェントが規律を守る構造になっています。 - シェル主体の構成: リポジトリの主要言語はShellとなっており、外部プラグインの追加コマンドやバージョン管理用スクリプト(
scripts/bump-version.shなど)を含む軽量な構造で各クライアントと連携しています。
注意点
- ライセンス: 本プロジェクトは MIT ライセンスのオープンソースソフトウェアとして公開されています。
- 長時間のセッションにおけるコンテキスト圧縮: クライアントの実装仕様によっては注意が必要です。例えば README の記述によると、Hermes Agent ではコンパクション後のフックが存在しないため、長時間のやり取りで初期ターンが圧縮されるとブートストラップ情報が失われるケースが指摘されています(その場合は新規セッションの開始が推奨されています)。
- ハーネスごとの設定要件: ツールごとにプラグイン承認(Approve)が必要であったり、インストール後にセッションの再起動が必要な場合があるため、利用する環境ごとの指示を確認してください。
- エンタープライズサポート: 企業利用等で有償サポートや追加ツール、支出管理が必要な場合は商用窓口(Prime Radiant)への連絡案内が記載されています。
まとめ
superpowers は、AIコーディングエージェントに設計ヒアリング、Git Worktreeでの環境分離、TDD、サブエージェントによる検証といった開発のベストプラクティスを強制させるスキルフレームワークです。多数のCLIやエディタ環境に対応しており、エージェントによるコード生成の品質と計画性を高めたい場合に有用な選択肢となります。





