AIコーディングエージェントに「依頼したらすぐコードを書き始める」問題を感じたことはないだろうか。仕様確認なし、テストなし、計画なしでコードを量産し、結局バグの修正に時間を取られる。Superpowersは、この問題を構造化ワークフローの自動注入で解決するオープンソースのスキルフレームワークだ。
Jesse Vincent氏（Prime Radiant）が開発したこのOSSは、Claude Code、Cursor、Codex、OpenCode、Gemini CLI、GitHub Copilot CLIに対応している。インストールするだけでエージェントの動作が根本から変わり、人間が指示を出さなくてもTDDサイクルとサブエージェント駆動開発を自律的に回すようになる。
💡 ポイント Superpowersは「プロンプトエンジニアリング」ではなく「スキル注入」というアプローチを取る。ユーザーが毎回「TDDで進めて」「テストを先に書いて」と指示する必要はなく、エージェントが自動でこれらの行動規範を選択する。
この記事ではAIエージェントに特化して解説します。AIエージェント全般は AIエージェントフレームワーク比較2026年版 をご覧ください。
Superpowersが解決する課題とアーキテクチャ全体像
通常のAIコーディングエージェントは、依頼を受けた瞬間にコードを書き始める。仕様の確認も、テストの設計も、計画の立案もない。結果として「動くけど意図と違う」コードが量産され、手戻りが発生する。
Superpowersを導入すると、エージェントは以下の7ステップの構造化ワークフローを自動的に実行するようになる。
🎯 7ステップワークフローの全体像
仕様の抽出・設計精練"] --> B["2. using-git-worktrees
隔離環境の構築"] B --> C["3. writing-plans
実装計画の作成"] C --> D["4. subagent-driven-development
サブエージェント駆動実装"] D --> E["5. test-driven-development
RED-GREEN-REFACTOR"] E --> F["6. requesting-code-review
コードレビュー"] F --> G["7. finishing-a-development-branch
完了処理・マージ判断"] G -.->|"次の機能開発"| A
このワークフローはスキルとして実装されており、エージェントがタスク開始時に自動検出して呼び出す。ユーザー側での手動操作は不要だ。各ステップが前提条件を検証してから次に進むため、計画とのズレが発生しにくい。
🎯 従来の課題と解決策の対応関係
| 従来の課題 | Superpowersによる解決策 |
|---|---|
| 仕様が曖昧なまま実装開始 | brainstormingスキルでソクラテス式に質問 |
| テストが後回しまたは省略 | TDDスキルでRED-GREEN-REFACTORを強制 |
| 長時間作業で計画から逸脱 | サブエージェント駆動で各タスクを独立実行 |
| メインブランチを汚す | git worktreeで隔離環境を自動構築 |
| 「動いた」の自己申告で完了 | テスト通過と2段階レビューで客観判定 |
| 不要な「念のため」コード | YAGNI原則を自動適用 |
⚠️ 注意 Superpowersはエージェントの振る舞いを大きく変えるため、初回はテンポが遅く感じる場合がある。ただし、計画立案フェーズに時間を投入することで後段のやり直しが激減し、トータルでは時短になる。
Superpowersは7ステップの構造化ワークフロー（brainstorming→worktree→plans→subagent→TDD→review→finish）を自動注入し、仕様曖昧・テスト省略・計画逸脱などAIエージェントの典型的な弱点を一気に解決する。
プラットフォーム別インストール手順と動作確認
Superpowersは主要なAIコーディングツールすべてに対応している。Claude Codeの基本機能と組み合わせることで、開発ワークフロー全体が構造化される。
🚀 Claude Code（公式マーケットプレイス）
最も簡単な導入方法。コマンド一発で利用開始できる。
/plugin install superpowers@claude-plugins-official
🚀 Claude Code（コミュニティマーケットプレイス）
カスタマイズ版や派生スキルを使いたい場合はコミュニティ版を選ぶ。
# マーケットプレイスを登録
/plugin marketplace add obra/superpowers-marketplace
# プラグインをインストール
/plugin install superpowers@superpowers-marketplace
🚀 Cursor
Cursor Agentチャットから以下のコマンドで導入する。
/add-plugin superpowers
またはCursorのプラグインマーケットプレイスで「superpowers」を検索してインストールする。
🚀 Codex / OpenCode
マニュアル設定が必要だが、エージェント自身にINSTALL.mdをフェッチさせることで自動化できる。
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
OpenCodeの場合は .codex を .opencode に置き換える。
🚀 GitHub Copilot CLI
Copilot CLIにもマーケットプレイス機能があるため、Claude Codeと同じ感覚で導入できる。
copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace
🚀 Gemini CLI
Gemini CLIではextension形式で配布されている。
gemini extensions install https://github.com/obra/superpowers
アップデートは gemini extensions update superpowers で実行する。
🎯 インストール確認チェックリスト
- 新しいセッションを開始した
- 「この機能を計画して」と依頼した
- エージェントが質問を返してきた（brainstormingスキル発動）
- 「このバグをデバッグして」と依頼した
- エージェントが仮説検証ステップを提示した（systematic-debuggingスキル発動）
✅ チェック 上記4項目がすべて確認できればインストール成功。エージェントがいきなりコードを書き始める場合は、セッションが古いか、プラグインが有効化されていない可能性がある。
🚀 プラットフォーム別対応状況
| プラットフォーム | インストールコマンド | マーケットプレイス対応 |
|---|---|---|
| Claude Code（公式） | /plugin install superpowers@claude-plugins-official |
対応 |
| Claude Code（コミュニティ） | /plugin marketplace add → /plugin install |
対応 |
| Cursor | /add-plugin superpowers |
対応 |
| Codex | INSTALL.mdをフェッチ | 手動 |
| OpenCode | INSTALL.mdをフェッチ | 手動 |
| GitHub Copilot CLI | copilot plugin marketplace add |
対応 |
| Gemini CLI | gemini extensions install |
URL指定 |
Claude Code/Cursor/Copilot CLI/Gemini CLIはワンコマンドで導入可能、Codex/OpenCodeはINSTALL.mdフェッチで自動化できる。4項目のチェックリストでインストール成否を必ず確認する。
7ステップ開発ワークフローの詳細解説
ここからが本題。各ステップで何が起きるのかを詳しく見ていく。
🎯 Step 1: brainstorming（仕様の抽出）
エージェントはコードを書く前に、ユーザーへ質問を投げかける。「何を作りたいのか」をソクラテス式に掘り下げ、設計ドキュメントを生成する。ポイントは読み切れる長さのチャンクに分割して提示すること。ユーザーが全体像を把握した上で承認できる。
💡 ポイント brainstormingスキルは「分からないことを分からない」と認める設計になっている。エージェントは推測でコードを書かず、必ずユーザーに確認する。これは「速さ」を犠牲にして「正確さ」を取る思想だ。
🎯 Step 2: using-git-worktrees（隔離環境の構築）
設計承認後、git worktreeで隔離されたブランチを自動作成する。プロジェクトのセットアップを実行し、既存テストがクリーンに通ることを確認してから作業を開始する。メインブランチを汚さずに安全に開発できる。
# worktreeで作成される構造の例
project/
├── main/ # メインブランチ
└── ../project-feature-login/ # Superpowersが作成したworktree
├── (隔離されたコードベース)
└── (テストベースライン確認済み)
🎯 Step 3: writing-plans（実装計画の作成）
READMEの原文がこの計画の特徴を端的に表現している。
“enthusiastic junior engineer with poor taste, no judgement, no project context, and an aversion to testing（趣味が悪く、判断力がなく、プロジェクト文脈を知らず、テストを嫌がる熱意だけのジュニアエンジニア）でも追従できる明確さ”
各タスクは2〜5分で完了する粒度に分解され、以下が明記される。
- 対象ファイルの正確なパス
- 書くべきコードの全体像
- 検証ステップ（テスト実行コマンドなど）
この粒度設計が、後述するサブエージェント駆動開発で各タスクを独立して実行可能にする鍵だ。
🎯 Step 4: subagent-driven-development（サブエージェント駆動）
計画の各タスクに対して個別のサブエージェントを起動する。各サブエージェントはタスクを実装し、2段階レビューを経て品質を担保する。OpenHandsのようなAIエージェントフレームワークと同様にタスク分割と自律実行を重視しているが、Superpowersはエディタ内蔵型である点が異なる。
この仕組みにより、数時間の自律的な連続作業が可能になる。人間の介入なしに計画通りの開発が進む。サブエージェントはフレッシュなコンテキストで起動するため、長時間作業でも文脈の劣化が起きにくい。
🎯 Step 5: test-driven-development（TDD）
RED-GREEN-REFACTORサイクルを強制する。Superpowersの中核となるスキルだ。
- RED — 失敗するテストを書く
- GREEN — テストを通す最小限のコードを書く
- REFACTOR — リファクタリング
- COMMIT — コミット
⚠️ 注意 テストの前にコードを書いた場合、そのコードは削除される。 これがSuperpowers最大の制約であり、最大の強みでもある。YAGNI（You Aren’t Gonna Need It）原則も自動適用され、不要な実装は排除される。
# TDDサイクルのイメージ（エージェントが自動実行）
1. テストファイルを作成 → テスト実行 → RED（失敗確認）
2. 最小限のコードを実装 → テスト実行 → GREEN（成功確認）
3. リファクタリング → テスト実行 → GREEN維持を確認
4. git commit
5. 次のテストへ
🎯 Step 6: requesting-code-review（コードレビュー）
タスク間でレビューを実行する。問題を重大度別に分類し、Critical（重大）はブロッキングで、解決するまで次のタスクに進めない。
| 重大度 | 動作 | 例 |
|---|---|---|
| Critical | ブロッキング、即修正必須 | テスト失敗、セキュリティ欠陥 |
| Major | 強く推奨 | パフォーマンス問題、誤った抽象化 |
| Minor | 任意対応 | コメント不足、命名の改善 |
🎯 Step 7: finishing-a-development-branch（完了処理）
全タスク完了後、以下を実行する。
- 全テストの通過を確認
- 4つの選択肢を提示: マージ / PR作成 / ブランチ維持 / 破棄
- worktreeのクリーンアップ
✅ チェック 完了処理ステップは「人間に最終判断を委ねる」設計になっている。エージェントが勝手にmainにマージすることはなく、必ずユーザーに4択を提示する。安全性を担保する重要な仕組みだ。
7ステップワークフローは「仕様確認→worktree隔離→詳細計画→サブエージェント分担→TDD強制→重大度別レビュー→人間が最終判断」という流れ。テスト先行とYAGNI原則が徹底されるため品質が安定する。
全14スキルの機能と役割一覧
Superpowersには14のスキルが含まれている。各スキルは SKILL.md ファイルとして実装されており、エージェントが状況に応じて適切なスキルを呼び出す。
🎯 スキル全リストと機能
| カテゴリ | スキル名 | 機能の概要 |
|---|---|---|
| テスト | test-driven-development | RED-GREEN-REFACTORサイクル。テストのアンチパターン集付き |
| デバッグ | systematic-debugging | 4フェーズのルートコーズ分析（根本原因追跡、防御的多層保護、条件ベース待機） |
| verification-before-completion | 修正が実際に完了したことの検証 | |
| コラボ | brainstorming | ソクラテス式の設計精練 |
| writing-plans | 詳細な実装計画の作成 | |
| executing-plans | バッチ実行＋チェックポイント | |
| dispatching-parallel-agents | 並行サブエージェントのワークフロー管理 | |
| requesting-code-review | レビュー前のチェックリスト | |
| receiving-code-review | フィードバックへの体系的な対応 | |
| using-git-worktrees | 並行開発ブランチの管理 | |
| finishing-a-development-branch | マージ/PR判断ワークフロー | |
| subagent-driven-development | 2段階レビュー付きの高速イテレーション | |
| メタ | writing-skills | 新しいスキルの作成ガイド（テスト方法論付き） |
| using-superpowers | スキルシステムの入門 |
MCPサーバーの構築ガイドと同様に、Superpowersのスキルも「プロトコルに従って拡張可能」な設計になっている。writing-skills スキルを使えば、独自のワークフローをスキルとして追加できる。
🎯 自作スキルのテンプレート例
---
name: my-custom-skill
description: 独自の開発フローを定義する例
triggers:
- "デプロイ前チェック"
- "リリース準備"
---
## When to use
- 本番リリース直前
- 重大なリファクタリング後
## Steps
1. 全テストを実行して通過確認
2. CHANGELOGを更新
3. バージョン番号をbump
4. リリースタグを作成
💡 ポイント スキルはMarkdownファイル1つで記述できる。複雑な設定ファイルや拡張機構は不要で、エージェントが自然言語の指示として読み込んで実行する。学習コストが極めて低いのが特徴だ。
14スキルはテスト・デバッグ・コラボ・メタの4カテゴリに分類され、writing-skillsスキルを使えば独自スキルも作成可能。Markdown1ファイルで定義できるため拡張ハードルが極めて低い。
通常のAIエージェントとSuperpowers導入後の比較
Superpowersを導入すると、AIコーディングエージェントの動作はどう変わるのか。ForgeCodeのようなAIコーディングツールと併用する場合にも、この構造化ワークフローは有効に機能する。
🎯 動作の違いを項目別に整理
| 比較項目 | 通常のAIエージェント | Superpowers導入後 |
|---|---|---|
| 開発開始 | いきなりコード生成 | 仕様確認→設計レビュー→計画立案 |
| テスト | 後から書く（または書かない） | RED-GREEN-REFACTOR強制 |
| 長時間作業 | 途中で計画からズレる | 計画に沿って数時間自律稼働 |
| コード品質 | 品質にバラつき | 2段階レビューで品質担保 |
| ブランチ管理 | 手動操作が必要 | git worktreeで自動隔離 |
| 不要なコード | 「念のため」で増える | YAGNI原則で自動排除 |
| レビュー | 人間が手動でチェック | Critical/Major/Minorで自動分類 |
| 完了判定 | 「できた」と自己申告 | テスト通過で客観判定 |
🎯 適したユースケースと不向きなケース
| ユースケース | 適性 | 理由 |
|---|---|---|
| 新規機能の実装 | 高 | 仕様抽出から計画まで体系的に進む |
| バグ修正 | 高 | systematic-debuggingで根本原因を追える |
| 大規模リファクタリング | 高 | サブエージェント駆動で並列処理が活きる |
| ワンライナースクリプト | 低 | オーバーヘッドが大きすぎる |
| PoC・実験コード | 中 | TDDが必須でないケースは強制が重い |
| ドキュメント生成 | 低 | スキルが想定する用途と異なる |
⚠️ 注意 Superpowersは「重要なコード」に向いている。捨てるコード（実験、PoC）には向かない。導入時は対象プロジェクトを選別し、本番コードベースから順に適用するのがおすすめだ。
通常エージェントと比較して「仕様確認→TDD→2段階レビュー→客観判定」に置き換わる。新規機能・バグ修正・大規模リファクタで適性が高く、ワンライナーやPoCにはオーバーヘッドが大きい。
設計思想とコントリビューション方法
Superpowersの根底にある4つの原則を理解すると、なぜこの設計になっているのかが見えてくる。
🎯 4つの設計原則
| 原則 | 意味 |
|---|---|
| Test-Driven Development | テストが先、常に。テストなしの実装は許容しない |
| Systematic over ad-hoc | 推測ではなくプロセスで解決する |
| Complexity reduction | シンプルさが最優先。複雑さは技術的負債の源泉 |
| Evidence over claims | 「できた」ではなく「テストが通った」で判断する |
これらの原則は人間のエンジニアにも当てはまる普遍的な価値観だ。Superpowersは「AIに人間並みのプロ意識を強制するフレームワーク」と言える。
🎯 コントリビューション方法
Superpowersはオープンソース（MIT License）で、スキルの追加・改善を受け付けている。
# リポジトリをフォーク後
git clone https://github.com/<your-username>/superpowers.git
cd superpowers
git checkout -b my-new-skill
# writing-skills スキルのガイドに従ってスキルを作成
# skills/writing-skills/SKILL.md を参照
# PRを提出
git push origin my-new-skill
writing-skills スキルがスキル作成のベストプラクティスを定義しているため、初めてのコントリビューターでも構造に沿って開発できる。
🎯 プラグインのアップデート
/plugin update superpowers
新しいスキルが追加された場合、アップデートだけで自動的に利用可能になる。手動でのスキル追加作業は不要だ。
💡 ポイント コントリビューションする際は、まず既存スキルのSKILL.mdを読んで「スキルとしての書き方」のパターンを掴むのが近道。
writing-skillsスキル自身が「スキルの書き方を教えるスキル」というメタ的な構造になっており、これを読めば自作スキルの品質を高められる。
4原則（TDD／Systematic／Complexity reduction／Evidence over claims）は人間にも通じるプロの規範。MIT Licenseで配布されており、writing-skillsを起点に誰でもスキル追加・コントリビュートできる。
導入後に意識したい運用ベストプラクティス
Superpowersを最大限活用するための運用Tipsをまとめる。
🎯 推奨される使い方チェックリスト
- 新規セッションごとにSuperpowersの動作を意識的に確認する
- brainstormingフェーズで質問にしっかり答える（ここを省略すると後段が崩れる）
- 計画レビュー段階で違和感があれば修正を依頼する
- サブエージェントに長時間作業を任せる前に、チェックポイントを設定する
- レビューでCriticalが出たら、他タスクを進めずに先に解決する
- 完了処理時はマージ前に必ずテスト結果を確認する
🎯 よくある運用上の疑問
| 疑問 | 回答 |
|---|---|
| 既存プロジェクトに導入できる？ | できる。ただし既存テストがクリーンに通る状態が前提 |
| スキルの一部だけ使える？ | 可能。エージェントは状況に応じて関連スキルだけ呼ぶ |
| チームで使う場合の注意は？ | worktreeブランチの命名規則を共有しておくと衝突を防げる |
| コストへの影響は？ | レビューやサブエージェントでトークン消費は増える。重要プロジェクト向け |
✅ チェック Superpowersは「プロセスを買う」フレームワーク。トークン消費は増えるが、手戻り削減と品質向上でトータルコストは下がるケースが多い。特にチーム開発・本番コードでは投資対効果が高い。
brainstormingで手を抜かない、Criticalレビューは先に解決、worktree命名規則はチームで共有——この3点を徹底すれば、トークン消費増を上回る手戻り削減効果が得られる。
📌 まとめ
Superpowersは、AIコーディングエージェントに「プロのエンジニアの作法」を注入するスキルフレームワークだ。仕様確認→計画→TDD→サブエージェント駆動→レビュー→完了処理という7ステップの構造化ワークフローを自動的に実行することで、エージェントの行動を根本から変える。
🎯 この記事のキーポイント
- インストールはコマンド一発（Claude Code/Cursor/Copilot CLI/Gemini CLIで対応）
- 14スキルが自動連携し、ユーザーは特別な操作不要
- TDDを強制し、テストの前に書いたコードは削除される
- サブエージェント駆動で数時間の自律開発が可能
- 2段階レビューで仕様準拠とコード品質を両立
- MIT Licenseで自作スキルの追加・配布も自由
💡 ポイント Superpowersの真価は「AIに諦めずに正しく作らせる」点にある。早く動くものを作るのは得意だが、正しく動くものを作るのは苦手——というAIエージェントの弱点を、プロセスの強制で克服する。
🎯 次に試してほしいアクション
- 自分が普段使うAIコーディングツールに合わせてインストール
- 小規模な機能追加でbrainstormingフェーズを体験する
- サブエージェント駆動で1〜2時間の自律作業を試す
- writing-skillsスキルを読んで自作スキルのアイデアを考える
「AIに任せたら品質が下がる」という固定観念は、Superpowersのようなプロセス注入型OSSで覆りつつある。重要なコードベースほど、こうしたフレームワークの恩恵が大きい。まずは公式マーケットプレイスから1コマンドで導入し、エージェントの動きの違いを体感してほしい。
Superpowersは「早く動くもの」から「正しく動くもの」へAIエージェントを引き上げるフレームワーク。1コマンドのインストール、14スキル自動連携、TDD強制、サブエージェント駆動、2段階レビューが主要価値。
参照ソース
- GitHub: obra/superpowers — 公式リポジトリ（MIT License）
- Superpowers for Claude Code（Jesse Vincent氏のブログ） — 作者による設計思想の解説
- Discord コミュニティ — 質問・フィードバック・スキル共有
- Prime Radiant — リリース通知の登録
- Claude Plugin Marketplace（公式） — Claude Code向け公式配布
