claude-code-superpowers-how-i-actually-use-it.html
< BACK obra/superpowers の実際の使い方 — Claude Code に欠けていた方法論層のヒーロー画像

obra/superpowersの実際の使い方――Claude Codeの欠けていた方法論レイヤー

あなたの Claude Code セッションが、計画なしで書くことを拒否するジュニアエンジニアの面倒を見ているようだとしたら、あなたは一人ではない。2026年のコード化エージェントとの仕事の正直なバージョンは、エージェントが高速で、能力があり、構造的に楽観的だということだ。ブレインストーミングをスキップし、テストを無視し、間違った抽象化を書き、バグをリリースする。修正は、より良いプロンプトではない。修正は、エージェントの上に置く方法論層だ。

そのレイヤーが、私にとってはobra/superpowers――Jesse Vincentが作ったClaude Code向けのエージェント型スキルフレームワーク。2026年5月時点でGitHubスター数は18万に近づいており、現在v5.1.0。これはプロンプトテンプレートではなく、スラッシュコマンドパックでもなく、ただの雰囲気でもない。コンテキストに基づいて自動的にトリガーされ、テスト駆動開発を強制し、仕事を2~5分のタスクに分割する明示的な仕様を持つ、完全な開発方法論だ。obra/superpowers -- Jesse Vincent's agentic skills framework for Claude Code. Approaching 180,000 GitHub stars as of May 2026, currently at v5.1.0. It is not a prompt template, not a slash command pack, not a vibe. It is a complete development methodology that triggers automatically based on context, enforces test-driven development, and breaks work into 2-5 minute tasks with explicit specifications.

過去6ヶ月間、私が手がけるあらゆるプロジェクトでSuperpowersを導入している――今あなたが読んでいるこの個人サイト、Seahawk Mediaでのコンサルティング業務、HostListディレクトリ、ブログのコンテンツ制作、それにかなりの量の単発のデザインツール作業。6ヶ月のこれだけの使用量のあと、正直な評価は:これはエージェント自体が世に出て以来、私のClaude Codeワークフロー上で最大の生産性向上だ。このポストは本当の内訳――それは何か、5つのカテゴリでどう使うか、そしてまだ改善が必要な部分。

Superpowers が実際に何であるか、90秒で説明

Superpowers は Claude Code 用のマーケットプレイスプラグインとしてリリースされている。1つのインストールコマンド:

/plugin install superpowers@claude-plugins-official

そのあと、Claude Codeエージェントは構成可能なスキルライブラリにアクセスできる。各スキルはプラグインディレクトリ内のマークダウンファイルで、特定のワークフロー――TDD、並列エージェント送出、コードレビュー、ブレインストーミング、計画作成、デバッグなど数十種――をいつどう適用するかを説明している。Claude がスキルメタデータを読み、会話内の状況を認識し、関連するスキルを自動的にコンテキストに引き込む。ほとんどの場合、スキルを手動で呼び出さない。問題を説明すれば、Claude が自分でルーティングする。

やっと腑に落ちた思考モデル:これはすべてのシニアエンジニアリングチームがかつて持っていた部族知――そのチームがどう計画し、テストし、レビューし、出荷するかについての不文律――それが今は、どのプロジェクトにもインストールでき、エージェントが各タスク前に読む、ポータブルなライブラリになった。

重い仕事を担う7段階のワークフロー

価値の大部分は、Superpowersがデフォルトで強制する1つのコアワークフローから来ます。順序通りのステージで、括弧内はスキル名です:

  • ブレインストーミング――コードを1行も書く前に質問を通じてアイデアを洗練させる。(brainstorming)
  • ワークツリー分離――自明でないタスクはすべて、メインブランチではなくgitワークツリーで実行される。(using-git-worktrees)
  • 計画書作成――コードに手を付ける前に、2~5分の個別タスクに作業を分割し、正確な仕様を定める。(writing-plans)
  • サブエージェント駆動開発――タスクごとに新しいサブエージェントを起動し、2段階レビューを実施。メインエージェントは方向性を保ち、ワーカーエージェントは集中力を維持する。(subagent-driven-development)
  • テスト駆動開発――RED-GREEN-REFACTORは必須であり、オプションではない。(test-driven-development)
  • コードレビュー――重大度ベースのレビューで、クリティカルな問題は明示的にブロック。(requesting-code-review)
  • ブランチ完了――作業完了時に構造化されたマージまたはPR決定を実行。(finishing-a-development-branch)

実際には、10行の編集に対して7つのステップすべてを手動で実行することはありません。フレームワークはタスクの複雑さに基づいてどのステップを適用するかを判断し、オーバーキルになるものはスキップします。タイポ修正は計画スキルを簡潔に実行してTDDをスキップします。25,000ページのディレクトリ上の新機能はフルシーケンスを実行します。

ブログ執筆とSEOにSuperpowersを活用する方法

これは誰も言及しないユースケースです。フレームワークはコード用に構築されていますが、大規模なコンテンツ制作は同じ問題の別の姿です。構造化された計画、並列実行、公開前のレビュー。私が使用している5つの具体的なパターン:

1. 執筆前のポストのブレーンストーミング

すべてのポストはブレーンストーミングスキルから始まります。トピックを1~2行で説明するとClaudeが実際の質問を実施します:誰がこれを読むのか、彼らはすでに何を知っているのか、逆張りの視点は何か、私自身の仕事からどの具体的なシグナルをドラフトに含めるべきか。以前は90分のアウトラインセッションが必要だったほとんどのポストが、今は15分のガイド付き質問で完了し、より緊密なブリーフを生成します。

2. クラスターポスト用のプラン・ライティング

マルチポストコンテンツクラスター(今週リリースしたHIPAAクラスターが最新の例)は、writing-plansスキルを使用します。親トピックを説明するとClaudeが3~5個のサポートポストをそれぞれの視点、内部リンク構造、ターゲットキーワードを含めて計画します。プランはプロジェクト内のマークダウンファイルに入ります。各ポストは30~45分の個別タスクになります。クラスターは2週間ではなく1日でリリースされます。

3. キーワード調査の並列エージェント派遣

並列エージェント配信スキルは、大規模なSEO調査プロジェクトを実現可能にするものです。競合分析では、8つのキーワードについてDataForSEO SERPが必要で、ランキング上位の4社のコンテンツ監査、親トピックのAI Overview引用チェックが必要です。3つの並列エージェントが動き、それぞれが構造化された知見を持ち帰り、メインエージェントが統合します。かつての半日のSERPトグル作業が、今は10分の構造化分析になりました。

4. テスト駆動型コンテンツ品質ゲート

直感に反するが効果がある。私のコンテンツパイプラインにはテストスイートがある。単語数、Flesch-Kincaidスコア、メタディスクリプション長140~155文字、禁止ワードチェック、内部リンク最小値、スキーマ有効性、hreflang完全性。すべてのドラフトはゲートを通る。Superpowersのテスト駆動開発スキルがそれを強制する――投稿がゲートで失敗すれば、その失敗に対処されるまで下書きは公開されない。散文のREDGREENREFACTOR。

5. サイト全体のコンテンツ書き換えのためのWorktreeアイソレーション

今月TRIBE v2対応のために17個のヒーロコピーを書き直したとき、worktreeスキルはバッチ全体が完成し、レビューされるまで、書き換えをメインブランチから隔離したままにしておきました。半完成のヒーロコピーが本番環境に出ることはありません。このスキルは今やそれほど習慣化されているので、他のプロジェクトがそれを持っていないときに気づきます。

デザイン業務でのSuperpowersの使用方法

Claude Codeによる設計は異なる問題形式である――Figmaはエージェントの手にはないが、その周辺はすべてある。設計トークン、コンポーネント仕様、コピー、スペーシング、アクセシビリティ監査、スライドデッキ。私が頼りにする3つのパターン。

1. ブランドブリーフからのトークンアーキテクチャ

ブランドブリーフに対するブレインストーミング + 計画書作成により、1回のセッションで完全な設計トークン仕様――プリミティブレイヤー、セマンティックレイヤー、コンポーネントレイヤー――が生成される。Claudeは設計スキル(スコープ内の場合)と計画書作成スキルを並行してルーティングする。出力はコードベースに即座に使用できるCSS変数であり、後から誰かが翻訳する必要があるFigmaファイルではない。

2. コンポーネント仕様生成

コードレビュー受け取りと並行エージェント派遣により、コンポーネント仕様作業を処理する。私はコンポーネント(価格設定カード、サービスハブブロック、比較表)を説明し、Claudeがフルスペック――プロップ、バリアント、状態、アクセシビリティノート――を作成する。スペックは別のエージェントによってレビューされた後、引き渡される。

3. スライド デック制作

プレゼンテーション作業はすべてSuperpowersを通す。ナラティブのブレインストーミング、スライド構成の計画書作成、チャート生成とコピー改善の並行エージェント。かつて1日の作業だった25スライドのデッキが、今は2時間のガイド付きセッションで完成する――そしてスライドはHTML with Chart.jsで配信される。後から誰かが再作成する必要があるバイナリではなく。

Web 開発での Superpowers の使用方法

これは元のユースケースで、フレームワークの深さが見える場所です。今週の2つの例を挙げます。

WordPress Stack Advisor ツール

WordPress Stack Advisorというツールを作りました。これは無料で、URLを受け取ってサイトを取得し、CMSと30以上のプラグインを検出して、Claude生成のスタック推奨を返すものです。約8時間の作業時間で完成しました。ブレインストーミングスキルが入出力仕様とシステムプロンプトアプローチを生み出し、書く計画機能がビルドを個別のタスク(検出モジュール、Claude統合、UIページ、CSP配線、スモークテスト)に分解しました。サブエージェント駆動開発が各タスクを独立した新しいエージェントコンテキストで実行し、メインエージェントがアーキテクチャ全体像を保ちました。検出モジュールのTDDが本番環境に届く前に2つの正規表現バグを検出しました。すべてが清潔なPRで、真の履歴付きコミットとしてリリースされました。the WordPress Stack Advisor -- a free tool that takes a URL, fetches the site, detects the CMS and 30+ plugins, and returns a Claude-generated stack recommendation -- in roughly 8 working hours of session time. The brainstorming skill produced the input/output spec and the system prompt approach. Writing-plans broke the build into discrete tasks: detection module, Claude integration, UI page, CSP wiring, smoke test. Subagent-driven development delivered each task in isolation with a fresh agent context, while the main agent kept the architectural picture. TDD on the detection module caught two regex bugs before they landed in production. The whole thing went out as a clean PR with a real commit history.

HIPAA ブログ クラスタ

3 つの記事で、完全にクロスリンクされ、ヒーロー画像、スキーマ マークアップ、既存の HIPAA 準拠 Next.js ポストへの内部リンク構造を備えています。ブレーンストーミングはギャップ分析を明らかにしました(AccountableHQ がカバーしていない部分、Reddit スレッドが古い部分)。書き込みプランはクラスタを構成しました。親ポストのアップグレード、2 つの新しいサポート ポスト(Supabase + Vercel BAA、AI HIPAA)、共有内部リンク スケルトン。並列エージェントは DataForSEO SERP と Vercel、Supabase、OpenAI、Anthropic、Azure HIPAA 価格に関するライブ ウェブ リサーチを取得しました。サブエージェント駆動開発は各ポストを生成しました。クラスタは 1 つのフォーカス セッションで公開されました。HIPAA-compliant Next.js post. Brainstorming surfaced the gap analysis (what AccountableHQ doesn't cover, where Reddit threads are out of date). Writing-plans structured the cluster: parent post upgrade, two new supporting posts (Supabase + Vercel BAA, AI HIPAA), shared internal-link skeleton. Parallel agents pulled DataForSEO SERPs and live web research on Vercel, Supabase, OpenAI, Anthropic, Azure HIPAA pricing. Subagent-driven development produced each post. The cluster shipped in one focused session.

個人プロジェクトでの Superpowers の使用方法

このフレームワークは、仕事以外の問題にも驚くほどよく適応する。正直な3つの例:

旅行リサーチ

家族の休暇計画:実際のブリーフのためのブレインストーミング(子どもが許容できる内容、実際の予算、都合のつく日程)、レストラン調査、宿泊施設分析、旅程スコアリングの並列エージェント。出力は実際のソースへの引用を含む1ページの計画であり、一般的なリスト記事ではありません。ブレインストーミングスキルだけで導入する価値があります。ほとんどの家族計画がスキップする対話を強制するからです。

資金計画と意思決定

より大きな個人的な財務決定(住宅ローン借り換え、不動産購入、自動車購入)は商業的な仕事と同じ計画書作成の扱いを受けます。出力は取引がはっきりしている構造化された比較であり、感覚的な推奨ではありません。受け取るコード審査スキル(コード以外の審査に適応)が私がスキップしたであろう欠落分析を検出します。

自分の執筆練習用コンテンツ

個人エッセイ(オフスクリーンのブログ、カフェでの執筆、テク思考)はすべてまずブレストレーミングを通す。私の最高の個人的な執筆の多くは、自分では書かないであろう視点を浮上させた30分のSuperpowers会話として始まった。このスキルは、つまらないバージョンを書かせない共感的なエディターのように機能する。

Superpowersがまだ効果を発揮しない場面

  • 些細な編集──1行のCSS変更、単一のタイプミス修正、1段落のコピー微調整。スーパーパワーのオーバーヘッドはここで摩擦になります。ワークフローステージを無効にするか、エージェントを直接呼び出してください。
  • 純粋な探索──何を構築しているかまだ本当にわからず、5つの素早いプロトタイプを試行錯誤する必要がある場合。計画書作成スキルは早すぎる段階で構造化しようとします。手動モードの方が速いです。
  • 時間切迫デバッグ──本番環境がダウンしている、10分しかない、フレームワークの計画優先の反射は間違った反射です。体系的デバッグスキルをまったく使用する場合はそれを使い、7段階のワークフローはスキップしてください。
  • フレームワークを使っていないチームメンバーがいる場合。あなたの協力者が素のClaude Codeで、あなたがSuperpowersを使っている場合、アーティファクト(計画ファイル、ワークツリーブランチ、構造化されたコミット)はワークフローを混乱させ、むしろ明確にしない。全員が実行するか、誰も実行しないか、どちらかだ。

インストールと最初の24時間

Claude Codeを使っている場合、インストールはコマンド1つだ:

/plugin install superpowers@claude-plugins-official

インストール後、スキルはコンテキストに基づいて自動的に読み込まれます。覚える必要はありません。Claudeが自分自身をルーティングします。最も有用な最初の24時間は、意図的に実際のプロジェクト(おもちゃではない)を選んで、フレームワークに実行させることです。実際の機能での7段階ワークフローがリズムを教えます。READMEを読むだけでは十分ではありません。価値は使用により複合します。

私が1週間かけてハードウェイで学んだ2つの設定のコツ:ワークツリーディレクトリを高速SSD上に置く(ワークツリースキルは大量に生成する)、そしてスキルプラグインを自分のdotfilesに追加して、マシン間で持ち運べるようにする。新しいラップトップでセッションを開始して、習慣づいたワークフローが使えないほど悪いことはない。

よくある質問

Superpowersは無料ですか?

はい。フレームワークはパーミッシブライセンスの下でオープンソースです。インストールは公式Claude Codeプラグインマーケットプレイス経由で無料です。Anthropicへの標準レートでのClaude Code使用料は引き続き支払う必要があります。Superpowersはそれを変更しませんが、タスクごとにより多くのトークンを使用する傾向があります。より豊かな計画と並列エージェント実行のためです。実際には私にとってポジティブなトレードオフでした。より多くのトークン、より少ないセッション無駄。

Claude Codeの組み込みスキルに置き換わるのか?

いいえ。Superpowersは加算的なものです。Claude Code自体のスキルシステム(プロジェクトレベルスキル、マーケットプレイスプラグイン)は同じように動作します。Superpowersは方法論レイヤーとして並行してスロットされます──7段階ワークフロー、TDD強制、並列エージェントディスパッチ──基礎となるスキルがどのように使用されるかを調整します。

コーディング以外のタスクで機能するか?

はい、ただし留保条件があります。このフレームワークはソフトウェア開発向けに構築され、TDDとコードレビュースキルは明らかにコード指向です。しかしブレインストーミング、計画作成、並列エージェント派遣、ワークツリースキルはコンテンツ制作、デザイン、リサーチ、個人プロジェクトに適切に一般化します。現在のSuperpowers使用量の約40%はコード以外で、生産性向上は同等です。

他のエージェンティックフレームワークと比較してどうか?

最も近い比較はCursorのエージェントモード、Cline、Aiderの計画ワークフローです。Superpowersの差別化要因はスキルライブラリの深さとTDD強制です。CursorとClineはIDE レベルで優れています。Superpowersは方法論レベルで動作します。競争ではなく補完的です。Cursorでのライブ編集は小さなタスク用に保ちながら、Claude Code内でSuperpowersを実行しています。

落とし穴は何か?

本当の落とし穴が2つあります。第1に、実際に使わなければなりません。READMEを読むだけでワークフローを実行しないと、以前と同じClude Codeで終わります。第2に、このフレームワークの計画優先の反射は一部のタスク(純粋な探索、緊急デバッグ)に不適切です。ワークフローを無効にするときを知ることが学習曲線の一部です。約2週間の定期的な使用後、リズムが習慣化され、どのスキルが発動しているかについて考えなくなります。

関連資料

Claude Code for WordPress:2026年に私たちの代理店が運用しているワークフロー――より広いClaude Code代理店ワークフロー、Superpowersが方法論レイヤーとしてスロットインしています。 -- the broader Claude Code agency workflow, with Superpowers slotting in as the methodology layer.

WordPress Stack Advisor――Superpowersを使って、だいたい8時間のセッション時間で、エンドツーエンド構築した実用ツールです。 -- a working tool I built using Superpowers in roughly 8 hours of session time, end to end.

WordPress alternatives 2026:ノーコードが答えではない場合――Superpowersのwriting-plansと並列リサーチワークフローが1回のセッションで生成したクラスタポストです。 -- the cluster post that the Superpowers writing-plans + parallel-research workflow produced as a single session.

エージェントは高速です。エージェントは有能です。エージェントは構造的に楽観的です。方法論こそが、その楽観性が本番化されるのを止めるものです。

Superpowersをエンジニアリングチームやコンテンツチームに実装する方法について話したいのであれば――人的な問題、ワークフロー設計、コスト経済――30分間の電話をブッキングしてください。私はSeahawk Mediaのあらゆるプロジェクトで今これを実行していて、パターンはチームサイズ全体に一般化します。book a 30-minute call. I run this on every project at Seahawk Media now and the patterns generalise across team sizes.

< BACK