Superpowers: AIコーディングエージェント向けスキル

1. プロジェクト概要

Superpowersは、AIコーディングエージェントのためのオープンソースソフトウェア開発手法です。これは「スキル」のコンポーザブルなライブラリであり、Claude Code、Cursor、Codex CLIなどのツールが、場当たり的なコーディングにすぐ飛びつくのではなく、規律正しくエビデンスに基づいたワークフローに従うよう導きます。

2. 背景とポジショニング

Superpowersは、AIコーディングエージェントによく見られる失敗パターン、すなわち設計レビューやテストを省略し、まずコードを書いて後から考え、実際の検証なしにタスクを「完了」と宣言してしまう問題を解決するために生まれました。その核心的なミッションは、エージェントに再現可能でプロフェッショナルレベルのプロセス（ブレインストーミング、計画立案、分離された実行、テスト駆動開発、コードレビュー）を提供し、エージェントが生成するソフトウェアにも人間のエンジニアリングチームに期待されるのと同等の基準を適用することです。

単一目的のプロンプトライブラリや一回限りの「コーディングエージェント」ラッパーとは異なり、Superpowersは明確に手法とスキルライブラリの組み合わせであり、単一のツールではありません。設計上エージェントに依存しません。同じスキルセットを13種類以上の異なるコーディングエージェント（Claude Code、Cursor、Gemini CLI、GitHub Copilot CLI、Devinなど）にインストールでき、特定のベンダーのエコシステムに縛られることはありません。また、「場当たり的ではなく体系的な」意思決定と「主張ではなくエビデンス」を重視しており、プロセスの規律を強制しない軽量なプロンプトエンジニアリング集とは一線を画しています。

3. 機能カテゴリ

🧪 テスト — 1つのスキル。test-driven-developmentは厳格なRED-GREEN-REFACTORループを強制し、エージェントが実装コードを書く前に失敗するテストを書くようにします。
🐞 デバッグ — 2つのスキル。systematic-debuggingは推測ではなく根本原因分析を推進します。verification-before-completionは、実際に動作するという証拠がない限り、エージェントが作業を「完了」とマークすることを阻止します。
🤝 コラボレーション — 9つのスキル。brainstorming（コーディング前のユーザーとの設計検証）、writing-plans / executing-plans（タスクの分解と実行）、dispatching-parallel-agents（サブエージェントへの作業の分散）、requesting-code-review / receiving-code-review、using-git-worktrees（分離された安全な開発ブランチ）、finishing-a-development-branch、およびsubagent-driven-developmentが含まれます。
🧩 メタ — 2つのスキル。writing-skillsは新しいスキルの作成方法を文書化しています。using-superpowersはフレームワーク自体の呼び出し方と構成方法を説明しています。

4. 主なハイライト

7段階の開発ワークフロー — すべてのタスクは、設計のブレインストーミング、git worktreeによる分離、タスク分解、レビューサイクルを伴うサブエージェント実行、TDD、仕様に基づくコードレビュー、ブランチのクリーンアップを経て進行し、エージェント主導の開発に一貫した形を与えます。
エージェント非依存のインストール — 13種類以上のコーディングエージェント（Claude Code、Cursor、Codex CLI、Gemini CLI、GitHub Copilot CLI、Devin、Antigravity、Factory Droid、Grok Build CLI、Kimi Code、OpenCode、Pi、Hermes Agent）で動作するため、チームが単一のベンダーにロックインされることはありません。
デフォルトでのテスト駆動開発 — test-driven-developmentスキルにより、RED-GREEN-REFACTORがオプションの規律ではなくデフォルトのループとなります。
主張よりエビデンスを重視する検証 — verification-before-completionは、エージェントが証拠もなく成功を自己報告することを防ぐために特別に設計されています。
Git worktreeによる分離 — 開発は分離されたworktreeで行われるため、実験中または進行中のエージェントの作業がメインブランチを不安定にすることはありません。
コンポーザブルで拡張可能なスキルライブラリ — スキルはモジュール式のMarkdownベースのユニット（SKILL.md）であり、writing-skillsは独自に追加したいチーム向けにそのパターンを文書化しています。

5. ロール別のユースケース

一般の開発者 — お好みのコーディングエージェントにSuperpowersをインストールすることで、構造化された計画、TDDの強制、コードレビューが日常のエージェント支援コーディングセッションに組み込まれます。
プロジェクトマネージャー / テックリード — ブレインストーミングと計画立案のスキルを使用して、実装開始前にエージェントに設計のトレードオフを提示させ、レビュー可能な計画を作成させることで、予期せぬ書き直しを減らせます。
オープンソースメンテナー — using-git-worktreesとfinishing-a-development-branchスキルは、エージェントが提出したブランチを分離されたクリーンな状態に保つのに役立ち、メンテナーのレビュー負担を軽減します。

（DevOps/SRE、セキュリティエンジニアリング、データ/研究科学は、本プロジェクトの明確な重点分野ではないため省略されています。）

6. はじめに

必要なものを見つける
リポジトリのskills/ディレクトリにあるカテゴリ（テスト、デバッグ、コラボレーション、メタ）ごとにスキルライブラリを閲覧するか、エージェント固有のセットアップノートについてはdocs/をお読みください。

インストール / 統合
インストールは、お使いのコーディングエージェント固有の単一コマンドで行います。例：

# Claude Code
/plugin install superpowers@claude-plugins-official

# Cursor
/add-plugin superpowers

# Gemini CLI
gemini extensions install https://github.com/obra/superpowers

# GitHub Copilot CLI
copilot plugin install superpowers@superpowers-marketplace

サポートされている13種類以上のエージェントすべてを網羅した完全な表については、リポジトリのREADMEをご覧ください。

貢献
リポジトリをフォークし、devブランチから作業を開始してください。プルリクエストを開く前に、skills/writing-skills/SKILL.mdに文書化されている手法に従ってください。メンテナーは、完全に新しいスキルの貢献は一般的に受け付けないと述べている点にご注意ください。既存のスキルのバグ修正や改善が主な貢献の道筋となります。

7. プロジェクト構造

superpowers/
├── .claude-plugin/     # Claude Codeプラグインマニフェスト
├── .cursor-plugin/     # Cursorプラグインマニフェスト
├── .devin-plugin/      # Devinプラグインマニフェスト
├── .kimi-plugin/       # Kimi Codeプラグインマニフェスト
├── .opencode/          # OpenCode拡張 + INSTALL.md
├── .pi/extensions/     # Pi拡張マニフェスト
├── .agents/plugins/    # 共有エージェントプラグイン定義
├── skills/             # コアスキルライブラリ（スキルごとにSKILL.md）
├── docs/               # エージェント固有および一般的なドキュメント
├── hooks/              # ワークフローフック
├── scripts/            # サポート用自動化スクリプト
├── assets/             # 静的アセット（ロゴ、テレメトリピクセルなど）
└── tests/              # テストスイート / 評価ハーネス

skills/ディレクトリはプロジェクトの中心です。各スキルは、エージェントがいつ、どのようにそれを適用すべきかを記述した自己完結型のSKILL.mdです。.{agent}-plugin/ディレクトリは、同じスキルライブラリをサポートされている各コーディングエージェントのプラグイン形式に適応させます。

8. 関連エコシステム

Superpowersは、それがインストールされるコーディングエージェントプラットフォーム（Claude Code、Cursor、Gemini CLI、GitHub Copilot CLI、Codex CLI、Devin、Antigravity、Factory Droid、Grok Build CLI、Kimi Code、OpenCode、Pi、Hermes Agent）に依存しています。これらはそれぞれ、Superpowersのスキルがその上で動作する基盤となるLLMランタイムとプラグイン/拡張メカニズムを提供します。Superpowersは、各エージェントのネイティブ機能を置き換えるのではなく、それらの上に共通の開発手法を層として追加することで補完します。

9. ライセンス

✅ 商用利用を含め、使用、複製、修正、マージ、公開、配布は自由です（MITライセンス）。
✅ 個人または組織を問わず、サポートされている任意のコーディングエージェントに自由にインストールできます。
❌ 保証は一切提供されません。ソフトウェアは「現状有姿」で提供されます。
ℹ️ 元の著作権表示およびライセンス表示は、ソフトウェアの複製または実質的な部分に保持する必要があります。
ℹ️ プロジェクトにはオプトアウト可能なオプションのテレメトリ（ロゴ読み込みビーコンによるバージョン採用追跡）が含まれています。環境変数で無効にできます。

10. よくある質問

Q: Superpowersは私のコーディングエージェントで使えますか？
A: Claude Code、Cursor、Gemini CLI、GitHub Copilot CLI、Codex CLI、Devinを含む13種類以上のエージェントをサポートしています。お使いのエージェント用の正確なコマンドについては、READMEのインストール表を確認してください。

Q: Superpowersは単一のツールですか、それともプロンプトのセットですか？
A: どちらでもありません。それはコンポーザブルなスキルライブラリ（skills/）として実装された構造化された手法であり、一度きりのプロンプトではなく、完全な開発ワークフロー全体を通してエージェントによって呼び出されるように設計されています。

Q: 新しいスキルを貢献できますか？
A: プルリクエストを開くことはできますが、メンテナーは完全に新しいスキルの貢献は一般的に受け付けないと述べています。既存のスキル、ドキュメント、またはエージェント統合を改善する貢献の方がマージされる可能性が高くなります。必須フォーマットについてはskills/writing-skills/SKILL.mdをご覧ください。

Q: 私のデータを収集しますか？
A: バージョン採用追跡に限定されたオプションのテレメトリが含まれており、オプトアウトの環境変数を尊重します。

Q: インストール後にSuperpowersを更新するにはどうすればよいですか？
A: 更新はお使いのコーディングエージェントの通常のプラグイン/拡張更新メカニズムに従います。お使いのエージェント固有の詳細については、リポジトリREADMEの「Updating」セクションをご覧ください。

11. クイックリンク

リポジトリ: https://github.com/obra/superpowers
貢献ガイド: skills/writing-skills/SKILL.md（リポジトリ内）
エージェント固有のドキュメント: docs/ディレクトリ（リポジトリ内）
コミュニティ: リポジトリのGitHub IssuesおよびDiscussions

12. まとめ

Superpowersは、場当たり的なAI支援コーディングを、規律正しくエビデンスに基づくエンジニアリングプロセス（ブレインストーミング、計画立案、TDD、コードレビュー）へと変え、チームがすでに使用している任意のコーディングエージェントにインストールできます。これは、単一のエージェントベンダーにロックインされることなく、AIコーディングエージェントに、高速だが雑なオートコンプリートではなく、慎重なエンジニアのように振る舞ってほしいと考える開発者やチームにとって最も価値があります。