Claude Code を最大限活用する

概要

SuperpowersはJesse Vincent（Prime Radiant）が開発するClaude Code向けコアスキルライブラリです。TDD、デバッグ、コラボレーションパターンなど、ソフトウェア開発の規律あるワークフローをスキルとして提供します。

バージョン: 5.0.7
ライセンス: MIT
対応プラットフォーム: Claude Code、Cursor、Copilot CLI、Gemini CLI、Codex、OpenCode
スキル数: 14スキル、1エージェント、3コマンド

セッション開始スキル

using-superpowers

Superpowersを初めて使う際、またはセッション開始時のスキル選択フロー。タスクの性質に応じて最適なスキルを選択し、適切なワークフローに誘導します。

どのスキルを使うべきか判断する入口
新機能実装 → brainstorming、既存バグ → systematic-debugging など状況別のルーティング
Superpowersの全スキルを俯瞰するリファレンスとして機能

呼び出し: /superpowers:using-superpowers

設計・計画スキル

brainstorming

新機能やコンポーネント作成前に必須のスキル。ユーザーの意図を探索し、要件と設計を確定してから実装に進みます。

ハードゲート: 設計が提示され承認されるまで実装不可
9ステップの必須チェックリスト
1度に1つの質問、多肢選択を推奨
仕様書の出力先: docs/superpowers/specs/

writing-plans

承認済みの仕様や要件からマルチステップの実装計画を作成します。

実装者はコードベースのコンテキストがない熟練開発者と想定
タスク粒度: 1ステップ2〜5分
プレースホルダー（TBD、TODO）は禁止
計画書の出力先: docs/superpowers/plans/

executing-plans

writing-plans で作成された承認済み計画を実際に実行するスキル。計画書の各ステップをサブエージェントに委譲しながら順次実行します。

subagent-driven-development と並列のエントリーポイント
計画書の各ステップを独立したタスクとして実行
完了条件: 全ステップの verification-before-completion 通過

呼び出し: /superpowers:executing-plans

テスト・品質スキル

test-driven-development

全機能実装とバグ修正で必須。Iron Law: テストなしに本番コードを書かない。

RED-GREEN-REFACTORサイクル
テスト前に書かれたコードは削除（参考として保持しない）
11の言い訳に対する反論表を搭載
15のTDD違反パターンのRed Flagsリスト

verification-before-completion

完了宣言の前に必須の検証スキル。24の実際の失敗事例に基づいています。

ゲート: IDENTIFY -> RUN -> READ -> VERIFY -> 完了宣言
早すぎる満足感のRed Flagsリスト
コミット、PR、タスク完了、エージェント委譲の全場面に適用

デバッグスキル

systematic-debugging

バグや予期しない動作に遭遇した際に必須。Iron Law: 根本原因の調査なしに修正しない。

4フェーズ: 根本原因調査 -> パターン分析 -> 仮説検証 -> 実装
3回以上の修正失敗 = アーキテクチャを疑う
「根本原因なし」の95%は調査不足

支援技術

技術	説明
root-cause-tracing	コールスタックを逆追跡してバグの起点を特定
defense-in-depth	4層検証パターンでバグを構造的に不可能にする
condition-based-waiting	setTimeoutを条件ポーリングに置き換え

コラボレーションスキル

subagent-driven-development

実装計画を独立したタスクごとに新規サブエージェントで実行します。

タスクごとの2段階レビュー: 仕様準拠性 -> コード品質
モデル選択ガイダンス: 機械的タスクは安価、統合は標準、アーキテクチャは高性能
実装者ステータス: DONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_CONTEXT

requesting-code-review / receiving-code-review

コードレビューの依頼と受領を体系化。受領時は形式的な同意を禁止し、技術的検証を要求します。

dispatching-parallel-agents

2つ以上の独立したタスクを並行処理します。スコープが広すぎる場合や制約がない場合はアンチパターンとして警告します。

using-git-worktrees

Gitのworktree機能を活用して、ブランチごとに独立した作業ディレクトリを作成するスキル。並列サブエージェント実行時のファイル競合を防ぎます。

メインworktreeとは別に分離された作業空間を確保
標準パイプラインでは brainstorming の直後に実行
複数の独立タスクを並行処理する際の前提条件

呼び出し: /superpowers:using-git-worktrees

エージェント

code-reviewer

Superpowersが提供する唯一のエージェント。コードレビューを体系的に実施します。

requesting-code-review スキルと連携して動作
仕様準拠性とコード品質の2段階評価
形式的な同意を禁止し、技術的検証を要求（receiving-code-review との組み合わせ）

コマンド

Superpowersはスキルに加え、CLIコマンドとして直接呼び出せる3つのコマンドを提供します。

コマンド	対応スキル	用途
`/brainstorm`	`brainstorming`	ブレインストーミングセッションを開始
`/write-plan`	`writing-plans`	承認済み仕様から実装計画書を作成
`/execute-plan`	`executing-plans`	承認済み計画を実行

標準開発パイプライン

brainstorming -> worktree作成 -> writing-plans
  -> subagent-driven-development（TDD実行）
  -> code-review -> finishing-a-development-branch

finishing-a-development-branch

開発ブランチの完了処理を構造化するスキル。実装完了後にマージ、PR作成、クリーンアップのいずれかを選択するガイド付きフローを提供します。

呼び出し: /superpowers:finishing-a-development-branch

メタスキル

writing-skills

スキル自体をTDDで作成するスキル。Iron Law: スキルなしにテストなし。説明は「いつ使うか」のみを記述（Description Trapの回避）。

Superpowers スキルカタログ

概要