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 ディレクトリ、ブログのコンテンツ製作、そしてかなりの数のワンオフデザインやツール開発。その量の使用後の正直な見解:それは、エージェント自体がリリースされて以来、僕の Claude Code ワークフローにおける単一の最大の生産性向上だ。このポストは実際の分解だ。それが何であるか、僕が働く5つのカテゴリーでどのように使うのか、そしてまだ改善が必要な部分。

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

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

/plugin install superpowers@claude-plugins-official

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

ついに理解できた思考モデル:これは、かつてシニアエンジニアリングチームの部族知識だったもの――このチームがどのように計画し、テストし、レビューし、リリースするかについての不文律――と同じですが、今はあらゆるプロジェクトにインストールできるポータブルライブラリであり、エージェントが各タスク前にそれを読み込みます。

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

価値の大部分は、Superpowersがデフォルトで強制する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のTDDスキルがそれを強制します。投稿がゲートで失敗すると、失敗が解決されるまでドラフトは公開されません。散文のRED-GREEN-REFACTORです。

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

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

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

Claude Codeを通じたデザインは別の問題形状です。Figmaはエージェントの手の中にはありませんが、その周囲のすべてはあります。デザイントークン、コンポーネント仕様、コピー、間隔、アクセシビリティ監査、スライドデッキ。私が依存する3つのパターンがあります。

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

ブランドブリーフ上でのブレーンストーミング+書き込みプランが、完全なデザイントークン仕様を生み出します。プリミティブレイヤー、セマンティックレイヤー、コンポーネントレイヤー。1セッションで。Claudeはデザインスキル(スコープ内にある場合)と書き込みプランスキルを並列にルーティングします。出力は後で誰かが翻訳する必要があるFigmaファイルではなく、コードベースの準備ができたCSS変数です。

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

コード レビュー受け取りと並列エージェント ディスパッチがコンポーネント仕様の作業を処理します。私がコンポーネント(価格カード、サービス ハブ ブロック、比較表)について説明すると、Claude が完全な仕様を書き出します。プロップ、バリアント、ステート、アクセシビリティ ノートが含まれ、エンジニアまたは別のエージェントが実装できます。仕様は並列エージェントがレビューしてから引き継がれます。

3. スライド デック制作

プレゼンテーション作業はすべて Superpowers を通すようになりました。ストーリー ラインのブレーンストーミング、スライド構成の書き込みプラン、チャート生成とコピー修正の並列エージェント処理。25スライドのデックは以前は1日かかっていましたが、ガイド付きセッションで2時間で完成します。スライドは HTML で 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つのタイプミスの修正、1段落のコピーの調整。Superpowersのオーバーヘッドはここで摩擦になる。ワークフロー段階を無効にするか、エージェントを直接呼び出す。
  • 純粋な探索 — 実際に何を構築しているのかまだわからず、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は方法論水準で動作します。両者は競争的ではなく補完的です — Superpowersをかましつつ、小さなタスクの生きた編集にはCursorを使っています。

落とし穴は何か?

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

関連資料

WordPress向けClaude Code: 当社が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: when no-code is not the answer — Superpowersの執筆計画と並列調査ワークフローが単一セッションで生み出したクラスター記事です。 — 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