エンジニアリンググレード開発のためのClaude Codeスーパーパワー
スーパーパワー入門
スーパーパワー（Superpowers）は、Jesse Vincent（オンラインハンドル：obra）が作成したオープンソースのエージェントスキルフレームワークで、AIプログラミングにおける核心的な問題を解決するために特別に設計されました：AIに「おもちゃレベル」ではなく「エンジニアリンググレード」のコードを生成させるにはどうすればよいか。
通常のAIコーディングアシスタントを「優秀なインターン」と想像してください。実行可能なコードを書けますが、テストがなく、ドキュメントがなく、ベストプラクティスの規律がないかもしれません。スーパーパワーは、そのインターンに「シニアエンジニアメンター」を割り当て、完全なソフトウェア開発プロセスに従うことを強制するようなものです。
なぜスーパーパワーが必要なのか
スーパーパワー以前、Claude Codeの使用にはいくつかの問題がありました：
- バイブコーディングの混乱：AIが計画なしにコーディングを始め、頻繁な手戻りが発生
- TDDの規律欠如：AIはコードを先に書き、後からテストを追加、またはテストを完全にスキップする傾向
- 曖昧な要件でのコーディング：ユーザーが「ログイン機能を作って」と言うとAIがすぐに始め、結果が期待と異なる
- 不安定なコード品質：コードレビューの仕組みがなく、品質がAIの「気分」に依存
スーパーパワーはこれらの問題を解決し、Claudeを「規律のある開発チーム」に変えます。まず要件を明確にし、次に計画を作成し、TDDで開発し、最後にコードレビューで品質を確保します。
クイックスタート
ステップ1：スーパーパワーのインストール
Claude Codeで実行：
# マーケットプレイスを追加
/plugin marketplace add obra/superpowers-marketplace
# スーパーパワーをインストール
/plugin install superpowers@superpowers-marketplaceまたは手動でクローン：
git clone https://github.com/obra/superpowers.git ~/.claude/skills/superpowersステップ2：最初のスキルを試す
スーパーパワーのブレインストーミングスキルでその価値を体験しましょう。
Claude Codeで次のように入力：
ユーザーログイン機能を作ってスーパーパワーなし：Claudeが直接コードを書き始め、本当に欲しいものと異なる結果を生成する可能性。
スーパーパワーあり：Claudeがソクラテス式質問を使用して要件を明確化：
このログイン機能はWebアプリ向けですか、モバイルアプリ向けですか？
どのログイン方法が必要？メール/パスワード？サードパーティログイン（Google、GitHub）？
「ログイン状態を保持」機能は必要？
パスワードリセットはメールかSMSか？
...
これらの質問により、コーディング前に実際に何が必要かを明確にし、使われないコードの大量生成を防ぎます。
ステップ3：スキルトリガーの仕組みを理解
スーパーパワーは「魔法のスイッチ」ではありません。それはスキルのセットです。スキルがどうトリガーされるかを理解することが重要。
3つのトリガー方法：
キーワードトリガー
- 「TDD」「テスト駆動開発」「テストファースト」に言及
test-driven-developmentスキルが活性化
シナリオトリガー
- 要件が不明確なとき、
brainstormingが積極的に質問 - バグが発生したとき、
systematic-debuggingが活性化
- 要件が不明確なとき、
手動呼び出し
- スキル名を直接使用、例：
/test-driven-development
- スキル名を直接使用、例：
💡 重要な明確化：TDDを指定しないとどうなる？
これはよくある誤解です。明確にしましょう：
# ケースA：TDDに言及しない
「計算機を実装して」
-> Claudeはテストを書くかもしれないし、書かないかもしれない
-> モデル自身の習慣に依存
# ケースB：TDDを明示的に要求
「TDDで計算機を実装して」
-> test-driven-developmentスキルが活性化
-> RED-GREEN-REFACTORが強制スーパーパワーの本当の価値：無から能力を創造するのではなく、規律を強化すること。
- TDDスキルなし：Claudeがテストを書くのは「たぶん」
- TDDスキルあり：ClaudeはTDDフローに従うことが強制される
スーパーパワーの価値の理解
上記の説明から、スーパーパワーの核心的な価値は明確です：
- 要件第一：
brainstormingが要件が曖昧なときに積極的に質問 - プロセスの規律：
test-driven-developmentがTDDレッド・グリーン・リファクタサイクルを強制 - タスク分解：
writing-plansが大きなプロジェクトを小さなタスクに分解 - 品質管理：
code-reviewスキルがコード品質を確保
スーパーパワーコアスキルの詳細
スーパーパワーには、ソフトウェアライフサイクル全体をカバーする20以上の合成可能なスキルが含まれています。カテゴリごとに見ていきましょう。
🧪 テストスキル
test-driven-development
トリガー方法：「TDD」「テスト駆動開発」「テストファースト」などのキーワードに言及。
このスキルがすること：Claudeに「後でたぶんテストを書く」のではなく、TDDレッド・グリーン・リファクタサイクルに従うことを強制。
従来のアプローチ（よくある問題）：
- 直接コードを書く
- 手動で簡単テスト
- バグを見つけてパッチ
- 繰り返し...（テスト？次回かも）
TDDアプローチ（スキル活性化後）：
- 🔴 RED：まず失敗するテストを書く
- 🟢 GREEN：テストをパスする最小限のコードを書く
- 🔵 REFACTOR：テストがパスしたままリファクタリング
- 繰り返し
使用例：
TDDでユーザー認証モジュールを実装してClaudeの動作：
- まずテストを書く（ユーザー名/パスワードの検証、トークン生成など）
- テストを実行し、すべて失敗することを確認（RED）
- 最小限の実装コードを書く
- テストを実行し、パスすることを確認（GREEN）
- コードをリファクタリングし、共有ロジックを抽出
- 再度テストを実行し、パスすることを確認（REFACTOR）
注意：「TDD」に言及しない場合、Claudeはテストを書くかもしれないし、書かないかもしれません。スキルの役割はプロセスの規律を強制し、テストが「忘れられない」ようにすること。
🐛 デバッグスキル
systematic-debugging
バグが発生したとき、人間の開発者はランダムな修正を試みがち。スーパーパワーは4段階の根本原因分析を強制：
段階1：問題の再現
- バグが一貫して再現できることを確認
- 正確な再現手順を記録
段階2：根本原因の特定
- 二分探索スタイルの絞り込みでスコープを狭める
- ログを追加して問題のあるコードを特定
段階3：仮説の検証
- 根本原因の仮説を提示
- 検証実験を設計
段階4：修正と確認
- 修正を実装
- バグが解決されたことを確認
- リグレッションテストを追加
verification-before-completion
このスキルは、Claudeが「まあ十分に近い」だけで止まることを防ぐ。完了を宣言する前に、以下を要求：
- すべてのテストを実行
- 主要機能を手動テスト
- コード品質をチェック（lint）
- ドキュメントが更新されていることを確認
🤝 コラボレーションスキル
brainstorming
これは最も興味深いスーパーパワースキルの1つ。ソクラテス式質問を使用して要件を明確化。
仕組み：曖昧な要件を提供すると、Claudeは直接コーディングを始めず、質問します：
あなた：ブログシステムを作って
Claude：
- このブログの対象読者は？技術読者？一般読者？
- Markdown編集をサポートする必要がある？
- コメント機能は必要？
- 検索機能は必要？
- 単一ユーザー？複数著者？
- ...これらの質問により、本当に必要な機能を考え、使われない機能の大量生成を防ぎます。
writing-plans
このスキルは大きなタスクを2〜5分で完了できる小さなタスクに分解。
例：
writing-plansを使ってtodo APIの開発を計画してClaudeが詳細な計画を生成：
# 実装計画
## タスク1：データベーススキーマの設計（推定5分）
- todosテーブルの作成
- フィールドの定義：id, title, completed, createdAt
## タスク2：Expressルートの作成（推定10分）
- POST /todos - タスクの作成
- GET /todos - タスクリストの取得
- GET /todos/:id - 1つのタスクを取得
- PUT /todos/:id - 更新
- DELETE /todos/:id - 削除
## タスク3：入力検証の追加（推定10分）
- titleは空にできない
- completedはbooleanでなければならない
## タスク4：テストの作成（推定15分）
- 各エンドポイントのテストを書く
- エッジケースをカバー
## タスク5：サーバーの起動と検証（推定5分）
- テストを実行
- APIを手動テスト
受け入れ基準：
- すべてのテストがパス
- 各エンドポイントでcurlテストがパスexecuting-plans
このスキルは計画をバッチで実行し、各チェックポイントで一時停止して確認。
使用例：
上の計画を実行して、各タスク完了後に一時停止してClaudeの動作：
- タスク1を完了し、一時停止：
✅ データベーススキーマ完了。続けますか？ - あなたの確認後、タスク2を完了し、再び一時停止
- 以下同様
これにより、各段階で方向を確認でき、後になって軌道がずれていたことに気づくのを防ぎます。
dispatching-parallel-agents
このスキルは複数のサブエージェントを並列で起動。
ユースケース：複数の独立したタスクを同時に処理する必要がある場合。
並列エージェントを使って以下を完了：
- エージェントA：バックエンドAPIを書く
- エージェントB：フロントエンドコンポーネントを書く
- エージェントC：テストを書く各エージェントは独自の隔離環境で干渉なく動作。
subagent-driven-development
このスキルは小さなタスクごとに独立したサブエージェントを起動。
利点：
- 各サブエージェントが隔離されたコンテキストを持つ
- 1つのタスクの失敗が他に影響しない
- 複数のタスクを並列実行可能
using-git-worktrees
このスキルはGit worktreeを使用して隔離された開発環境を作成。
メリット：
- 複数の機能を並列開発可能
- 各worktreeが独立
- 相互の競合がない
👀 コードレビュースキル
requesting-code-review
コードが完了した後、このスキルが自動的にコードレビューを要求。
機能完了後に自動的にコードレビューをトリガーしてreceiving-code-review
このスキルはレビューフィードバックの受け取りと処理方法を定義。
レビューワークフロー：
- コードを提出
- レビューが自動トリガー
- レビュアーがコード品質、セキュリティ、テストカバレッジをチェック
- レビュアーが改善提案を提供
- 問題を修正
- 承認されるまで再レビュー
完全なスーパーパワーワークフロー
スーパーパワーの真の力は、複数のスキルを組み合わせて完全な開発ワークフローを形成することにあります。
標準開発ワークフロー
1. ブレインストーミング
↓ Q&Aで本当の要件を明確化
2. 設計ドキュメント
↓ 設計をチャンクで提示し、確認を待つ
3. 計画の作成
↓ 2〜5分のタスクに分解
4. サブエージェント開発
↓ タスクごとに隔離されたサブエージェントを起動
↓ 2段階レビュー：仕様準拠 + コード品質
5. TDD
↓ RED-GREEN-REFACTORを強制
6. コードレビュー
↓ 品質ゲート
7. 完了実践例：スーパーパワーでユーザー認証システムを構築
完全な例でスーパーパワーワークフローを体験しましょう。
ステップ1：ブレインストーミングで要件を明確化
ユーザー認証システムが必要Claudeの質問：
- Webアプリですか、モバイルアプリですか？
- どのログイン方法が必要？
- パスワードリセットは必要？
- 「ログイン状態を保持」は必要？
- ...
ステップ2：設計ドキュメントの生成
要件が確認されると、Claudeが設計ドキュメントを生成：
# ユーザー認証システム設計
## 機能要件
1. ユーザー登録（メール + パスワード）
2. ユーザーログイン
3. パスワードリセット（メール）
4. ログイン状態を保持（JWT + Refresh Token）
## 技術選択
- バックエンド：Node.js + Express
- データベース：SQLite
- 認証：JWT
- 暗号化：bcrypt
## API設計
- POST /api/auth/register
- POST /api/auth/login
- POST /api/auth/refresh
- POST /api/auth/reset-passwordステップ3：実装計画の作成
writing-plansを使って実装計画を作成してClaudeが詳細なタスクリストを生成。各タスクは2〜5分で完了可能。
ステップ4：開発の実行
上の計画をTDDで実行してClaudeの動作：
- まずテストを書く
- テストが失敗することを確認（RED）
- 実装コードを書く
- テストがパスすることを確認（GREEN）
- コードをリファクタリング（REFACTOR）
ステップ5：コードレビュー
完了後、コードレビューが自動トリガーされ、以下をチェック：
- コード品質
- セキュリティ（SQLインジェクション、XSSなど）
- テストカバレッジ
- ドキュメントの完全性
スーパーパワー vs Claude Code直接使用
| 次元 | Claude Code直接使用 | スーパーパワー使用 |
|---|---|---|
| 要件の明確化 | AIが直接コーディングを開始 | ソクラテス式質問でまず要件を明確化 |
| 開発プロセス | AI次第の自由形式 | TDDレッド・グリーン・リファクタを強制 |
| タスク管理 | 一発完了 | チェックポイント付きの小タスクに分割 |
| コード品質 | AIの判断に依存 | コードレビューを強制 |
| 予測可能性 | 不安定な結果 | 再現可能なプロセス |
| 最適な用途 | 単純タスク、プロトタイプ検証 | 複雑なプロジェクト、本番コード |
視覚的メタファー
Claude Codeが「優秀なインターン」だとすると：
- 直接使用：インターンに「ログイン機能を作って」と言うと、すぐにコーディングを始め、ターゲットから外れたものを生成する可能性
- スーパーパワーあり：インターンにシニアメンターを割り当て、要件を明確にし、計画を作成し、コード品質をチェック
インストールと設定の詳細
方法1：マーケットプレイス経由（推奨）
# マーケットプレイスを追加
/plugin marketplace add obra/superpowers-marketplace
# インストール
/plugin install superpowers@superpowers-marketplace
# インストールの確認
/skills方法2：手動クローン
# ディレクトリの作成
mkdir -p ~/.claude/skills
# リポジトリのクローン
git clone https://github.com/obra/superpowers.git ~/.claude/skills/superpowers方法3：プロジェクトレベルのインストール
特定のプロジェクトでスーパーパワーを使用したい場合：
# プロジェクトルートで
mkdir -p .claude/skills
# スーパーパワーをコピー
cp -r ~/.claude/skills/superpowers .claude/skills/これにより、チームメンバーが同じスーパーパワー設定を共有可能。
一般的なスキルクイックリファレンス
| スキル名 | 機能 | 使用場面 |
|---|---|---|
brainstorming | ソクラテス式質問で要件を明確化 | 要件が不明確なとき |
writing-plans | タスクを小さなステップに分解 | 大きなプロジェクトを始める前 |
executing-plans | チェックポイント付きで計画を実行 | 計画駆動開発中 |
test-driven-development | TDDレッド・グリーン・リファクタループ | すべての機能開発 |
systematic-debugging | 4段階の根本原因分析 | バグが発生したとき |
verification-before-completion | 完了前の検証 | タスク完了時 |
requesting-code-review | コードレビューを要求 | コード提出前 |
subagent-driven-development | サブエージェント駆動開発 | 並列タスク |
using-git-worktrees | Git worktreeの隔離 | 並列機能開発 |
ベストプラクティス
1. 明確なトリガーキーワードを使用
スーパーパワースキルはキーワードでトリガーされます。一般的なトリガーワードを学びましょう：
| スキル | トリガーキーワード |
|---|---|
test-driven-development | 「TDD」「テスト駆動」「テストファースト」 |
brainstorming | 要件が不明確なときに自動トリガー |
systematic-debugging | 「デバッグ」「バグ」「動かない」 |
writing-plans | 「計画を立てて」「プランニング」 |
2. プロセス規律が必要なときにスーパーパワーを使用
- 本番グレードのコード開発 -> 「TDD」に言及
- 要件が不明確 ->
brainstormingに明確化させる - 複雑なプロジェクト ->
writing-plansでタスクを分解
3. 単純なタスクに無理に使わない
ラピッドプロトタイプや一回限りのスクリプトなら、完全なプロセスは不要。スーパーパワーは長期保守が必要なコードに最適。
4. スキルは組み合わせ可能
TDDでユーザー認証を実装し、完了後にコードレビューをしてこれでtest-driven-developmentとcode-reviewスキルの両方がトリガー。
よくある質問
Q1：スーパーパワー使用時に「TDD」を指定しなければならない？
必須ではありません。
スーパーパワーはスキルセットであり、各スキルには独自のトリガー条件があります：
- 「TDDを使って」と言う ->
test-driven-developmentがトリガー - TDDに言及しない -> Claudeはテストを書くかもしれないし、書かないかも（モデルの動作に依存）
スーパーパワーはプロセス規律を強制するために存在し、無から能力を創造するためのものではありません。
Q2：スーパーパワーは開発を遅くする？
最初は遅く感じるかもしれません：
- 要件の明確化に時間がかかる
- コードの前にテストを書く
- コードレビューが必要
しかし長期的には、手戻りの削減とバグの減少により、全体的な効率が向上。
Q3：小さなプロジェクトにもスーパーパワーが必要？
プロトタイプ検証や非常に単純なタスクには、Claude Codeを直接使用可能。スーパーパワーは以下に適している：
- 本番グレードプロジェクト
- 複数人でのコラボレーション
- 長期保守可能性
Q4：スーパーパワーとスキルの違いは？
| 次元 | スーパーパワー | スキル |
|---|---|---|
| 性質 | 完全な開発方法論フレームワーク | 再利用可能なスキルパッケージ |
| スコープ | 開発プロセス全体をカバー | 特定の機能に焦点 |
| 関係 | スーパーパワーが内部でスキルを使用 | スーパーパワーはスキルのコレクション |
Q5：スーパーパワースキルをカスタマイズできる？
はい。スーパーパワーはオープンソースで：
- リポジトリをフォーク
- 既存のスキルを修正
- 新しいスキルを追加
- コミュニティに貢献
参考文献
公式リソース
- obra/superpowers GitHub - 公式リポジトリ（50,000以上 ⭐）
- スーパーパワー詳細使用チュートリアル - 詳細な中国語チュートリアル
- スーパーパワー環境構築ガイド - 構築ガイド
コミュニティリソース
| リポジトリ | 説明 |
|---|---|
| affaan-m/everything-claude-code | TDDワークフローを含む包括的ツールキット |
| shanraisshan/claude-code-best-practice | 公式ベストプラクティス |
関連記事
- バイブコーディングにさよなら！スーパーパワーでClaude Codeにエンジニアリンググレードのコードを書かせる
- スーパーパワーMCPを使ってClaude Codeにコーディング前に計画させる方法
- Claude Code + スーパーパワー初心者チュートリアル
まとめ
スーパーパワーは、Claude Codeを「優秀なインターン」から「規律のある開発チーム」にアップグレードするエンジニアリンググレードの開発スキルセットです。
核心的なポイント
スーパーパワーはスキルセットであり、魔法ではない
- インストール後、スキルはバックグラウンドで利用可能
- キーワードまたはシナリオでトリガー
- 特定のスキルを手動で呼び出し可能
主要なトリガーフレーズを覚える
- TDDが欲しい -> 「TDDを使って」と言う
- 要件が曖昧 ->
brainstormingが積極的に質問 - バグ発生 -> 「デバッグ」に言及して
systematic-debuggingをトリガー
最適なシナリオ
- ✅ 本番グレードのコード開発
- ✅ 長期保守が必要なプロジェクト
- ✅ チームコラボレーションプロジェクト
- ❌ ラピッドプロトタイプ（オプション）
- ❌ 一回限りのスクリプト（オプション）
覚えておいてください：スーパーパワーはAIを賢くするのではなく、AIをより規律正しくする。