← 戻る 実際のところ、obra/superpowersをどう使っているか、Claude Codeに欠けている方法論レイヤー――ラインアート イラストレーション

私が実際に使っている obra/superpowers、Claude Code に欠けていた方法論レイヤー

制作会社の運営

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

そのレイヤーが、私にとっての obra/superpowers です。Jesse Vincent による Claude Code 用のエージェント型スキルフレームワークです。2026年5月時点で GitHub スター 180,000 に迫る勢いで、現在 v5.1.0 です。これはプロンプトテンプレートではなく、スラッシュコマンドパックでもなく、雰囲気でもありません。コンテキストに基づいて自動的にトリガーされ、テスト駆動開発を強制し、仕事を 2~5 分のタスクに分割して明確な仕様を持つ、完全な開発方法論です。

過去 6 ヶ月間、私が関わるすべてのプロジェクトで Superpowers を実行しています。このサイトで読んでいる個人サイト、Seahawk Media での コンサルティング業務(退職前)、HostList ディレクトリ、ブログのコンテンツ制作、および相当量の一回限りのデザインとツーリング作業。その程度の使用後の正直な感想:エージェント自体が出荷されて以来、Claude Code ワークフローへの最大の生産性向上です。このポストは、それが何か、5 つのカテゴリーすべてでどのように使用するか、そしてまだ改善が必要な部分の実際の内訳です。

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

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

/plugin install superpowers@claude-plugins-official

その後、Claude Code エージェントは合成可能なスキルライブラリにアクセスできます。各スキルはプラグインディレクトリ内の markdown ファイルで、特定のワークフロー、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のテスト駆動開発スキルがそれを強制し、ポストがゲートに落ちたら、失敗が解決されるまでドラフトは公開されない。散文に対するRED-GREEN-REFACTORだ。

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

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

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

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

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

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

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

Receiving-code-reviewとdispatching-parallel-agentsがコンポーネント仕様の作業を処理する。コンポーネント(価格カード、サービスハブブロック、比較テーブル)を説明すると、Claudeが完全な仕様を書く。props、バリアント、状態、アクセシビリティノート、エンジニアまたは別のエージェントが実装できる内容だ。仕様は引き継ぎの前に並列エージェントによってレビューされる。

3. スライド デック制作

プレゼンテーション作業はすべてSuperpowersを通じて行う。ナラティブのブレーンストーミング、スライド構成のライティングプラン、チャート生成とコピー改善のための並列エージェント。かつて1日かかった25スライドのデッキが、ガイドセッション2時間で完成し、スライドはバイナリではなくHTMLとChart.jsで配信される。

Web 開発での Superpowers の使用方法

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

WordPress Stack Advisor ツール

WordPress Stack Advisorを作りました。URLを入力するとサイトを取得し、CMSと30以上のプラグインを検出して、Claudeが生成したスタック提案を返す無料ツールです。セッション時間にして作業はおよそ8時間でした。ブレインストーミングのスキルで、入出力の仕様とシステムプロンプトの方針が固まりました。Writing-plansは、構築作業を検出モジュール、Claude連携、UIページ、CSP設定、スモークテストという個別のタスクに分解しました。サブエージェント駆動開発では、各タスクを新しいエージェントのコンテキストで個別に完了させ、メインエージェントはアーキテクチャ全体の見取り図を保ちました。検出モジュールのTDDでは、正規表現のバグを2件、本番に入る前に見つけられました。すべてが、実際のコミット履歴を伴うきれいなPRとして公開されています。

HIPAA ブログ クラスタ

3つの記事、完全にクロスリンク、ヒーロー画像、スキーママークアップ、既存のHIPAA準拠Next.js投稿への内部リンク構造。ブレーンストーミングはギャップ分析を表面化させた(AccountableHQがカバーしていないもの、Redditスレッドが古いところ)。Writing-plansはクラスタを構成した。親投稿アップグレード、2つの新しいサポート投稿(Supabase + Vercel BAA、AI HIPAA)、共有内部リンク骨組み。並列エージェントはDataForSEO SERP、VercelおよびSupabase、OpenAI、Anthropic、Azure HIPAA価格に関するライブウェブリサーチを引き出した。Subagent駆動開発は各投稿を生成した。クラスタは1つの焦点を絞ったセッションで出荷された。

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

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

旅行リサーチ

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

資金計画と意思決定

より大きな個人的な経済的決定(住宅ローンの借り換え、物件購入、自動車購入)は、商用の仕事と同じプラン作成プロセスを受けます。出力は、トレードオフが明示された構造化された比較であり、感覚的な推奨ではありません。コード以外のレビューに適応させた「コードレビュー受信」スキルは、スキップしてしまう見落とし分析をキャッチします。

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

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

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

  • 小さな編集、1行のCSS変更、単一のタイプミス修正、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プラグインマーケットプレイスから行えます。Claude Code使用量の標準レートはAnthropicに支払いますが、Superpowersはそれを変更しません。ただし、より豊富な計画と並列エージェント実行のため、タスクあたりのトークン数が増える傾向があります。実際には、これは私にとってプラスのトレードオフになっています。トークン数は増えますが、無駄なセッションは減ります。

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

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

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

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

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

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

落とし穴は何か?

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

関連資料

WordPress用Claude Code: 2026年にうちの代理店が実行するワークフロー、より広いClaude Code代理店ワークフロー、Superpowersが方法論レイヤーとして組み込まれている。

WordPress Stack Advisor は、私が Superpowers を使って約8時間のセッション時間で、エンドツーエンドで構築した実用的なツールです。

WordPress代替案2026年: ノーコードが答えではないとき、Superpowers writing-plans + parallel-researchワークフローが1つのセッションとして生成したクラスタ投稿。

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

本当のエンジニアリングまたはコンテンツチームにSuperpowersを組み込む方法について話したい場合、人的問題、ワークフロー設計、コスト経済学について、30分間の通話を予約する。これを Seahawk Media のすべてのプロジェクトで実行し、パターンはチームサイズ全体で一般化する。

← 戻る