Claude Code に superpowers を入れて、エージェントが「考えてから書く」ようになった

こんにちは、サーバーワークスで生成AIの活用推進を担当している針生です。

今回は superpowers という Claude Code のプラグインを紹介します。

このプラグインを入れると、Claude Code が「ちゃんと考えてからコードを書く」ようになります。たとえばこんな動きが自動的に入ります。

何を作るのか、どんな条件があるのかをまず確認してくれる
バグが出たら、いきなり直さずに原因を調べてくれる
「できました」と言う前に、本当に動いているか確かめてくれる
大きな実装は、小さなタスクに分けて順番に進めてくれる

普段プロンプトで毎回お願いしているようなことを、superpowers が必要な場面で自動的にやってくれるイメージです。

この記事では、superpowers の概要と導入方法、そして役立つスキルを紹介します。

superpowers とは

superpowers は、Jesse Vincent 氏（Prime Radiant）が開発したコーディングエージェント向けのプラグインです。開発の場面ごとに踏むべき手順を「スキル」としてまとめ、それを組み合わせる構成になっています。

superpowers は Claude Code 専用ではなく、複数のコーディングエージェントに対応しています。公式 README に記載されているのは、Claude Code、Codex CLI、Codex App、Factory Droid、Gemini CLI、OpenCode、Cursor、GitHub Copilot CLI です。手元のエージェントに応じてインストール方法は異なりますが、同じスキル群を共通の基盤として使えます。この記事では Claude Code を例に紹介します。

スキルとは、エージェントに特定の手順・作業フローを覚えさせるための仕組みです。「機能を追加する前に必ず要件を整理する」「バグを直す前に必ず原因を特定する」といったルールをスキルとして定義しておくと、エージェントがそのルールに従って動くようになります。

特徴的なのは、多くのスキルが自動的に起動する点です。「実装して」と伝えると、コードを書く前に自動で brainstorming が始まります。バグに遭遇すると、修正を試みる前に原因究明のフローが入ります。毎回指示しなくても、エージェントが段取りを踏んでくれます。

インストール方法

Claude Code の公式プラグインマーケットプレイスから導入できます。

/plugin install superpowers@claude-plugins-official

インストール後、/reload-plugins で反映します。設定は ~/.claude/settings.json の enabledPlugins に自動追記されます。

{
  "enabledPlugins": {
    "superpowers@claude-plugins-official": true
  }
}

執筆時点でのバージョンは 5.1.0 です。

含まれているスキル

superpowers には以下のスキルが含まれています。

スキル名	役割
brainstorming	実装に入る前に要件と設計を整理する
writing-plans	合意した設計を細かいタスクに分割した実装計画にする
executing-plans	実装計画をチェックポイントを挟みながら進める
subagent-driven-development	タスクごとにサブエージェントを起動して並行で進める
test-driven-development	テストを先に書く RED-GREEN-REFACTOR の流れを徹底する
systematic-debugging	バグの原因究明を 4 フェーズで進める
verification-before-completion	完了を宣言する前に検証コマンドで確認する
requesting-code-review	コードレビューを依頼する前のチェックリストを回す
receiving-code-review	レビュー指摘への対応を整理する
using-git-worktrees	作業を独立した worktree に分けて並行開発する
finishing-a-development-branch	作業終了時のマージ・PR 化・ブランチ整理を判断する
dispatching-parallel-agents	複数のサブエージェントを並列で動かす
writing-skills	独自スキルを正しく作る
using-superpowers	superpowers 自体の使い方を学ぶ

ここでは、特に日常的に使う場面が多いスキルをいくつか紹介します。

brainstorming：設計を固めてから実装する

機能追加やコンポーネント作成など「何かを新しく作る」指示を出すと、自動で起動します。

Claude がまず質問を一つずつ投げかけ、「何を作るのか」「どんな条件があるのか」「どうなれば完了か」を順に確認します。その後、2〜3 つの実現方法とそれぞれの利点・欠点を提示し、ユーザーの承認を得てから実装に移ります。

このスキルが効くのは、「なんとなくコードを書き始めて後から直す」というパターンを未然に防いでくれる点です。設計が曖昧なまま実装を始めれば手戻りが発生しますが、brainstorming はその曖昧さを実装前に取り除いてくれます。

手動で呼び出すには /brainstorming を使います。

writing-plans：実装計画を細かく切り出す

brainstorming が完了すると、自動的にこのスキルが引き継ぎます。

作業を 2〜5 分程度の小さなタスクに分割し、それぞれに以下を含む実装計画を作成します。

変更するファイルの具体的なパス
書くべきコードの内容
完了を確認する方法

「どこから手をつければいいかわからない」という状態を解消し、そのまま実装作業に入れる細かさまで分解してくれます。

systematic-debugging：原因を特定してから修正する

バグや予期しない挙動に遭遇すると自動で起動します。

修正を試みる前に、4 つのフェーズを順に踏むことを強制します。

根本原因の調査：エラーメッセージの精読、再現条件の特定、最近の変更の確認
パターン分析：類似の問題が他にないか、共通の原因が潜んでいないかを確認
仮説の立案と検証：原因の仮説を立て、検証可能な形で確認する
修正の実装：根本原因に対する修正を入れる

ドキュメントには「原因究明が終わるまで修正に手を出さない」という鉄則が掲げられており、根本原因の調査を完了するまでは修正提案ができない設計になっています。「急いでいるときほどこのプロセスを守れ」とも明記されています。

verification-before-completion：「できた」と言う前に確認する

作業の完了を宣言する前に、本当に完了しているかを検証するスキルです。対象は修正だけでなく、テストの合格、ビルドの成功、実装完了の宣言など、「完了した」と主張するあらゆる場面を含みます。

ドキュメントには「主張するなら必ず証拠を示せ」という原則が掲げられており、検証コマンドを実行して出力を確認するまでは完了を宣言できない設計になっています。「動いた気がする」のまま先に進むことを防いでくれる仕組みです。

writing-skills：自分でスキルを作る

writing-skills は、独自スキルを正しく作るためのガイドです。設計の進め方、記述方法、テスト手順を体系的に説明しています。決まった作業フローがあるなら、スキルとして定義しておくと Claude が毎回同じ手順を踏んでくれるようになります。

仕様駆動開発との比較

設計を固めてから実装するというアプローチは、Kiro や Spec Kit、AI-DLC といった仕様駆動開発のツールでもおなじみです。superpowers は何が違うのでしょうか。

共通点

どちらも「いきなりコードを書かず、まず設計や要件を文書化する」という基本思想を持っています。superpowers の brainstorming も、合意した設計を Markdown ファイルとして残します。writing-plans はその設計ファイルを入力にして実装計画を作ります。全体としては、仕様駆動開発と同じ「要件 → 設計 → 計画 → 実装」の流れになっているわけです。

違い：起動の仕組み

仕様駆動開発のツールは、明示的にコマンドを実行して起動するのが基本です。たとえば Spec Kit では /speckit.specify → /speckit.plan → /speckit.tasks → /speckit.implement のように複数のスラッシュコマンドを段階的に実行します。Kiro なら IDE 内の専用フローを開始します。

superpowers はスキルが状況に応じて自動起動します。「実装して」と伝えただけで brainstorming が立ち上がり、バグに遭遇するだけで systematic-debugging が動き出します。仕様駆動開発のフローを「明示的に始める」のではなく「常時オン」にしているイメージです。

違い：カバー範囲

仕様駆動開発のツールは、仕様 → 実装のパイプラインに焦点を絞っています。

superpowers はそこに加えてデバッグ、完了確認、コードレビュー、git 運用など、開発サイクル全体をスキルとしてカバーしています。

どう使い分けるか

仕様の形を組織内で標準化したい、要件の管理を厳密にしたいというニーズには、Kiro や AI-DLC のような専用ツールが向いています。一方、Claude Code の中で「設計して、実装して、デバッグして、レビューして」という一連の作業を一貫した手順で回したい場合は、superpowers のほうが摩擦が少ないでしょう。両方を組み合わせて、仕様管理は Kiro、Claude Code 内の振る舞いは superpowers と使い分けることもできます。

使ってみた感想

superpowers を導入してからは、特に意識することなくスキルが裏で動いてくれます。「実装して」「このバグを直して」と普段どおり指示するだけで、必要な場面で brainstorming や systematic-debugging が自動的に立ち上がります。

明示的な操作を増やさずに開発の段取りが整うので、入れておいて損はないと感じました。

参考：Sonnet との組み合わせ

参考情報として、外部のベンチマーク記事 [4] では「Sonnet 4.6 + superpowers」と「Opus 4.7 単体」を 18 タスクで比較しており、前者が 13 勝、後者が 4 勝、引き分けが 1 という結果が報告されています。手順をスキルとして組み込むことで、より小さなモデルでも実用的な精度を出せる可能性を示す参考データとして紹介しておきます。