Superpowers

Composable skills for coding agents. Your agent doesn't just jump into code — it plans, reviews, and follows a disciplined workflow.

1 — 概要
何か

Superpowers は、コーディングエージェント（Claude Code、Cursor、Codex、OpenCode、Gemini CLI など）向けのソフトウェア開発ワークフロー一式。組み合わせ可能な「スキル」と、エージェントがそれらを確実に使うための初期指示で構成され、コードを書く前に仕様を引き出し、設計を承認してからプランに落とし、TDD とサブエージェント駆動で実装・レビュー・マージ判断まで一貫したプロセスを提供する。

Skills組み合わせ可能
TDDRED-GREEN-REFACTOR
Subagentタスク単位実行
Review計画準拠チェック

エージェントは「何か作る」と検知すると、いきなりコードを書かずに「何をしたいか」を問いかけ、仕様を固めてから設計を短いチャンクで示し、承認後に実装プランを作成する。「go」と言えばサブエージェント駆動でタスクを消化し、レビューを挟みながら進める。スキルは自動でトリガーされるため、ユーザーは特別な操作をせずにエージェントに Superpowers を持たせられる。

2 — 基本ワークフロー
6 ステップ

エージェントはタスクの前に必ず関連スキルを確認する。推奨ではなく必須のワークフローとして組み込まれる。

順スキル役割
1brainstormingコードを書く前に発動。曖昧なアイデアを問いで整理し、設計をセクションごとに示して承認を得る。設計ドキュメントを保存。
2using-git-worktrees設計承認後に発動。分離したワークスペースで新ブランチを作成し、セットアップとクリーンなテストベースを確認。
3writing-plans承認された設計に基づき、2〜5 分で完了するタスクに分解。各タスクにファイルパス・完全なコード・検証手順を記載。
4subagent-driven-development / executing-plansプランに従い、タスクごとにサブエージェントを起動。二段階レビュー（仕様準拠 → コード品質）またはバッチ実行＋人間チェックポイント。
5test-driven-development実装中に発動。RED-GREEN-REFACTOR を強制。失敗テストを書き、落ちることを確認し、最小コードで通す。テストより前に書いたコードは削除。
6requesting-code-reviewタスク間で発動。プランとの整合性をレビューし、深刻度別に報告。クリティカルな問題は進行をブロック。
7finishing-a-development-branchタスク完了時に発動。テスト確認後、マージ / PR / 維持 / 破棄の選択肢を提示し、ワークツリーを整理。
3 — スキルライブラリ
カテゴリ別一覧
カテゴリスキル概要
Testingtest-driven-developmentRED-GREEN-REFACTOR サイクル（アンチパターン参照付き）
Debuggingsystematic-debugging4 段階の根因追跡（root-cause-tracing、defense-in-depth、condition-based-waiting）
Debuggingverification-before-completion修正が本当に効いているか確認してから完了とする
Collaborationbrainstorming問いによる設計の洗練
Collaborationwriting-plans詳細な実装プラン
Collaborationexecuting-plansチェックポイント付きバッチ実行
Collaborationdispatching-parallel-agents並列サブエージェントワークフロー
Collaborationrequesting-code-reviewレビュー前チェックリスト
Collaborationreceiving-code-reviewフィードバックへの対応
Collaborationusing-git-worktrees分離ブランチでの並行開発
Collaborationfinishing-a-development-branchマージ / PR 判断ワークフロー
Collaborationsubagent-driven-development二段階レビュー付きの高速イテレーション
Metawriting-skillsベストプラクティスに沿った新規スキル作成（テスト手法含む）
Metausing-superpowersスキルシステムの導入
4 — インストール
プラットフォーム別

Claude Code / Cursor はプラグイン市場から、Codex / OpenCode は手動セットアップ。各環境でインストール後、新セッションで「この機能を計画して」などスキルが発動するような依頼をすると、エージェントが該当スキルを自動で読み込む。

Claude Code（公式マーケットプレース）

/plugin install superpowers@claude-plugins-official

Claude Code（コミュニティマーケットプレース）

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Cursor

Agent チャットでプラグイン市場から /add-plugin superpowers または「superpowers」で検索。

Codex

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md

詳細: docs/README.codex.md

OpenCode

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

詳細: docs/README.opencode.md

Gemini CLI

gemini extensions install https://github.com/obra/superpowers
gemini extensions update superpowers   # 更新時
確認: 新規セッションで「この機能を計画して」や「このバグを調査して」などスキルが発動しそうな依頼をすると、エージェントが該当スキルを自動で読み込む。
5 — 哲学
設計思想
  • Test-Driven Development — 常にテストを先に書く
  • Systematic over ad-hoc — 当て推量よりプロセス
  • Complexity reduction — シンプルさを最優先
  • Evidence over claims — 主張の前に検証してから「完了」とする
公式・関連