Claude Codeでsuperpowersを使う — 計画・TDD・レビューの導入手順
superpowersは、計画・TDD・レビューのスキル群をClaude Codeに足すプラグインです。2通りの導入コマンド、7つの基本スキルが動く順序、スコープの選び方、発火しないときの切り分けをまとめます。
superpowersは、コーディングエージェント向けの開発手法をスキルの集まりとして配布するプラグインです。Claude Codeには /plugin install の1行で入り、設計の聞き取り、実装計画、テスト駆動開発、レビューが「作業の種類に応じて自動で」呼ばれるようになります。
この記事では、導入コマンドと入れたあとの確認、7つの基本スキルが動く順序、スコープの選び方、うまく発火しないときの切り分けを扱います。第三者が作ったプラグインなので、手順はリポジトリのREADMEとClaude Codeのプラグイン文書の両方に合わせています。
superpowersとは何か
superpowersは、リポジトリのREADMEで「コーディングエージェント向けの完全なソフトウェア開発手法」と説明されています。中身は組み合わせ可能なスキルの集まりと、それらを必ず使わせるための初期指示です。
READMEが描く動き方は4段階です。
superpowersが目指す作業の流れ
- 1
目的を聞き返す
何かを作っていると判断した時点で、すぐコードを書かず、本当に何をしたいのかを質問します。
- 2
設計を小分けにして見せる
聞き取った内容から仕様を起こし、読んで判断できる長さの塊で提示します。
- 3
実装計画を作る
設計に承認が出ると、実装計画を作ります。READMEは、判断力もプロジェクトの文脈も持たない新人でも迷わない粒度だと述べ、赤緑のTDD、YAGNI、DRYを重視するとしています。
- 4
サブエージェントで実行する
「go」と伝えると、タスクごとにエージェントを走らせ、成果物を点検しながら進めます。READMEによれば、計画から外れずに数時間自律で動くこともあります。
スキルは自動で発火するため、特別な操作は要らないというのがREADMEの立場です。逆に言えば、スキルの存在を知らないまま使うと、Claudeが急に質問を始めたり、テストを先に書き始めたりして戸惑います。何が起きているかを先に知っておくと、導入後の違和感が減ります。
Claude Codeへの導入手順
READMEは、Claude Codeへの導入経路を2つ示しています。同じ名前のプラグインが別々のマーケットプレイスに載っているので、どちらか一方を選びます。
| 経路 | 事前準備 | 導入コマンド |
|---|---|---|
| Anthropicの公式マーケットプレイス | 事前準備不要 | 導入コマンド/plugin install superpowers@claude-plugins-official |
| superpowers専用のマーケットプレイス | 事前準備/plugin marketplace add obra/superpowers-marketplace | 導入コマンド/plugin install superpowers@superpowers-marketplace |
専用マーケットプレイスは、READMEによるとsuperpowersと関連プラグインを配布しています。まず公式側で試し、関連プラグインも欲しくなったときに専用側を足す、という順が無難です。
公式マーケットプレイスから入れる
Claude Codeを起動して、次のコマンドを実行します。
/plugin install superpowers@claude-plugins-officialセッション内でこのコマンドを実行しても、その場ではインストールされません。プラグインの詳細ペインが開くので、内容を確認してからスコープを選びます。ペインには次の項目が出ることがあります。
- Will install: プラグインが足すコマンド、エージェント、スキル、フック、MCPサーバーとLSPサーバー
- Last updated: 公式マーケットプレイスのプラグインで表示される更新日
- Context cost: 公式マーケットプレイスのプラグインで表示される2種類のトークン見積もり。毎ターン足される量と、スキルやエージェントが読み込まれたときに足される量
Context costは、マーケットプレイス名を付けたコマンドで開いたときか、Marketplacesタブから開いたときに出ます。Discoverタブの一覧から開いた詳細ペインには出ません。スキルを多数持つプラグインなので、入れる前にこの見積もりを見ておく価値があります。
専用マーケットプレイスから入れる
こちらは先にマーケットプレイスを登録します。
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplaceowner/repo の形はGitHubリポジトリを指します。成功すると Successfully added marketplace: <name> と表示され、そのマーケットプレイスのプラグインがDiscoverタブに並びます。
登録と導入を1コマンドにまとめる書き方もあります。この形はClaude Code v2.1.275以降のセッション内で使えます。
/plugin install superpowers --marketplace obra/superpowers-marketplace未登録のマーケットプレイスなら、解決したソースが表示され、追加してよいかを確認されます。シェルから claude plugin install で同じことをするにはv2.1.292以降が必要で、こちらは確認なしでマーケットプレイスを追加します。
claude plugin install superpowers \
--marketplace obra/superpowers-marketplaceスコープを選ぶ
詳細ペインでは3つのスコープから選びます。
| スコープ | 効く範囲 | 記録先 |
|---|---|---|
| ユーザー | 効く範囲このマシンのすべてのプロジェクト | 記録先~/.claude/settings.json の enabledPlugins |
| プロジェクト | 効く範囲リポジトリの全員 | 記録先.claude/settings.json(コミットする) |
| ローカル | 効く範囲自分だけ・このリポジトリだけ | 記録先.claude/settings.local.json |
superpowersは作業の進め方そのものを変えるので、最初はローカルスコープで1つのリポジトリに限って試すと、他の作業への影響を避けられます。気に入ったらユーザースコープへ広げます。
プロジェクトスコープには注意点があります。.claude/settings.json へのエントリをコミットしても、共同作業者のマシンにプラグインがダウンロードされるわけではありません。各自が一度 claude plugin install superpowers@<marketplace> --scope project を実行する必要があります。
入ったかどうかを確かめる
インストールの最後に出る要約の末尾の一文が、そのセッションですぐ使えるかを示します。Plugin is now active. なら再読み込みは不要です。Run /reload-plugins to apply. と出たときは、パネルを閉じる際にClaude Codeが再読み込みを実行します。プロンプトキャッシュを無効にしてしまう場合は警告を出して保留になるので、そのときは /reload-plugins --force で適用します。この場合は1回分のキャッシュなしリクエストが発生します。
動作の確認は、/ を入力してスキル名を探すのが確実です。プラグインのスキルは /<プラグイン名>:<スキル名> の形で並ぶため、superpowersなら /superpowers: で始まる名前が見えるはずです。プラグインのコンポーネントはマニフェストの name を名前空間にして呼ばれる、というのがプラグイン仕様の説明です。スキルの正確な一覧と名前はインストールした版によって変わりうるので、手元の表示を基準にしてください。
7つの基本スキルはどの順で動くか
READMEの「The Basic Workflow」は、開発の流れに沿って7つのスキルを挙げています。
| スキル | 発火するタイミング | やること |
|---|---|---|
| brainstorming | 発火するタイミングコードを書く前 | やること質問で粗い案を詰め、代替案を探り、設計を節ごとに見せて確認し、設計書を保存する |
| using-git-worktrees | 発火するタイミング設計の承認後 | やること新しいブランチに隔離した作業場所を作り、セットアップとテストの基準線を確認する |
| writing-plans | 発火するタイミング承認済みの設計がある間 | やること2〜5分で終わる粒度のタスクに分け、ファイルパス、完全なコード、検証手順を各タスクに書く |
| subagent-driven-developmentまたはexecuting-plans | 発火するタイミング計画ができたとき | やること前者はタスクごとに新しいサブエージェントを出してレビューを挟む(最も入念)。後者は現在のセッションで全タスクを実装し、最後にブランチ全体を1回レビューする(最も安い) |
| test-driven-development | 発火するタイミング実装中 | やること失敗するテストを書き、失敗を見届け、最小のコードで通し、コミットする。テストより先に書いたコードは削除する |
| requesting-code-review | 発火するタイミングタスクの合間 | やること計画に照らしてレビューし、重大度別に報告する。重大な指摘は先に進むことを止める |
| finishing-a-development-branch | 発火するタイミングタスク完了時 | やることテストを確認し、マージ・PR・保留・破棄の選択肢を示し、作業場所を片付ける |
READMEはこれらを「提案ではなく必須のワークフロー」と書いています。エージェントはどの作業の前にも、関連するスキルがないかを確認します。
実装方式の選択は費用に直結します。READMEの説明では、サブエージェント方式が最も入念で、インライン方式が最も安価です。長時間走らせる前に、どちらで進めるかを自分で指定できます。たとえば計画ができた段階で、次のように伝えます。
この計画はexecuting-plansで進めてください。
最後にブランチ全体のレビューを1回だけ行ってください。これは指示の一例です。どの文言でどちらのスキルが選ばれるかはREADMEに規定がないため、選ばれたスキル名は応答の表示で確認します。
基本スキル以外に入っているもの
READMEの「Skills Library」には、基本の流れ以外のスキルも載っています。
| 分類 | スキル | 役割 |
|---|---|---|
| テスト | スキルtest-driven-development | 役割赤・緑・リファクタのサイクル(テストの悪い例の参照資料つき) |
| デバッグ | スキルsystematic-debugging | 役割4段階で根本原因を探る手順 |
| デバッグ | スキルverification-before-completion | 役割本当に直ったかを確かめる |
| デバッグ | スキルdiagnosing-superpowers | 役割セッションで何が起きたかを証拠つきで調べる |
| 協働 | スキルdispatching-parallel-agents | 役割サブエージェントの並列実行 |
| 協働 | スキルreceiving-code-review | 役割レビュー指摘への対応 |
| メタ | スキルwriting-skills | 役割ベストプラクティスに沿ったスキル作成 |
| メタ | スキルusing-superpowers | 役割スキル体系の入門 |
READMEが掲げる哲学は4つです。テストを常に先に書くこと、場当たりでなく体系を優先すること、複雑さを減らすこと、主張より証拠を重んじることです。
発火しない・出しゃばるときの切り分け
READMEは、スキルが出てほしくない場面で出る、出てほしい場面で黙る、計画を無視する、同じ作業を繰り返す、想定よりトークンを使う、といった不調が起こりうると認めています。対処として挙げているのは、Claudeに次のように頼むことです。
このセッションでsuperpowersに何が起きたか調べてください。すると diagnosing-superpowers が呼ばれ、セッションの記録を読んで、行単位の根拠つきで報告します。希望すれば、機微な情報を消した状態の一式を、バグ報告用にまとめてくれます。以前のセッションを調べるには、セッションIDを添えて指定します。
それ以前の確認項目は、プラグイン側の状態です。
- スキルが一覧に出ない: インストール要約の末尾が
Run /reload-plugins to apply.のまま保留になっていないか。Errorsタブに読み込み失敗の理由が出ていないか - 共同作業者だけ動かない: プロジェクトスコープでエントリをコミットしただけで、各自のインストールが済んでいない可能性があります
- 他のツールで動かない: READMEは、導入の方法がエージェントごとに違い、複数を使うなら環境ごとに別々に入れるよう求めています。Claude Codeに入れても、Codexなど他のエージェントには反映されません
- 同名プラグインが二重になる: 公式と専用の両マーケットプレイスに同名のプラグインがあります。片方を使う前提で、もう片方は入れないでください
更新・停止・削除
更新の仕組みは、プラグインの入手元のマーケットプレイスで決まります。公式マーケットプレイスは自動更新が既定でオン、それ以外のマーケットプレイスは既定でオフです。公式側から入れたsuperpowersは、新しいセッションの開始時に最新へ追従します。専用マーケットプレイスから入れた場合は、自動更新を自分で有効にするか、手動で更新します。
実行中のセッションは、読み込み済みの版を使い続けます。更新後は Plugin updated: <name> · Run /reload-plugins to apply と表示され、次のセッションから新しい版になります。
手動で更新するコマンドは次のとおりです。
claude plugin update superpowers@claude-plugins-official一時的に止めたいだけなら、/plugin のInstalledタブで該当プラグインにカーソルを合わせ、Spaceキーで無効にします。完全に外すときは、詳細メニューのUninstallを使います。マーケットプレイスごと削除すると、そこから入れたプラグインはすべてアンインストールされ、設定ファイルの enabledPlugins からも消えます。
入れる前に知っておきたい条件
第三者のプラグインには、導入前に確認しておく点がいくつかあります。
プラグインはフックやMCPサーバーを実行できます。Claude Codeの文書も、インストール前に詳細ペインを読むよう促しています。組織で使う場合は、管理者がマーケットプレイスの追加を制限している可能性があります。その場合の考え方はstrictPluginOnlyCustomizationの記事にあります。
スキルやプラグインのセキュリティを検査する仕組みについては、Enterprise向けのスキル・プラグインのセキュリティスキャンの記事が扱っています。
トークン消費も要注意です。サブエージェントを何本も走らせる方式は、READMEが「最も入念」と書く代わりに費用も嵩みます。小さな修正にまで全工程を回したくない場合は、インライン方式を選ぶか、小規模な作業ではプラグインを無効にしておく運用が現実的です。
LICENSEはMITです。商用利用に関する問い合わせ窓口は、READMEの「Commercial Services」に記載があります。
手元で効き目を測るには
導入しただけでは、効いているかどうかは分かりません。同じ小さなタスクを、プラグインありとなしで1回ずつ走らせ、次を見比べてください。
- 実装の前に質問が返ってきたか
- テストが実装より先にコミットされているか
- 計画に書かれていない変更が混ざっていないか
- 消費したトークンはどれだけ違うか
スキルそのものの効果を数値で測る方法は、skill-creatorのevalの記事で扱っています。複数のプラグインをセッション単位で試す方法は、CLAUDE_CODE_PLUGIN_DIRSの記事が参考になります。
まとめ
superpowersは、Claude Codeの作業の入口に「聞き取り、計画、テスト先行、レビュー」という段取りを差し込むプラグインです。導入は /plugin install の1行ですが、効果の大きさは、サブエージェント方式とインライン方式のどちらで回すかで変わります。
まずはローカルスコープで1つのリポジトリに入れ、小さな機能追加を1本通してみてください。段取りが自分の開発に合うかどうかは、その1本で分かります。