- ここ数週間で、Claude Codeベースのコーディングエージェントシステムを体系化し、「Superpowers」という新しい拡張ツールを作った
- Superpowersはプラグイン形式でインストールされ、Claudeに「スキル（Skills）」を教え、このスキルを通じて作業方式を自動化・改善する機能を提供する
- AnthropicのClaude Codeプラグインシステムを活用し、ワークフロー自動化、TDD実行、コードレビュー、Git worktree管理などをエージェントが自律的に実行する
- 新しいワークフローはブレインストーミング → 計画 → 実装の段階を自動で経て、作業を並列に進め、RED/GREEN TDD方式でテスト駆動開発を行う
- 中核概念である**「スキル（Skill）」**は、Claudeが特定の作業を行う際に参照すべき知識単位であり、ユーザーはこれを直接作成したり、Claudeが学習文書をもとに生成するようにできる
- この構造は今後AIコーディングエージェントの自己改善と協調の標準になると見ており、Superpowersの共有機能と記憶システムの完成が次の目標
Superpowers概要
- SuperpowersはClaude Code 2.0.13以上で動作し、ユーザーは
/plugin marketplace add obra/superpowers-marketplaceコマンドでインストール可能
- インストール後、Claudeが自動で
SKILL.md文書を読み、**「スキルが存在するなら必ず使わなければならない」**というルールを学習する
- これによりClaudeはブレインストーミングと計画段階を経て実装前の議論を促し、作業完了後にはGitHub PRの作成またはマージ提案まで行う
コーディングワークフロー
- Claudeがプロジェクトや作業開始を検知すると、実装前に自動でブレインストーミングと計画段階を経る
- Gitリポジトリ内で作業する際は自動でworktreeを作成し、並列作業間の衝突を防止する
- 2つの実行モードを提供
- 従来方式: ユーザーが2つ目のClaudeセッションを開き、アーキテクトと実装者を仲介するPM役を担う
- 新方式: 作業をサブエージェントに個別配分し、各作業ごとにコードレビュー後に進行
- RED/GREEN TDD方式で、失敗するテスト作成 → 最小実装 → テスト通過の循環を繰り返す
- 実装完了後、GitHub PR作成、ローカルブランチのマージ、または終了オプションを提供
スキルシステムの中核原理
- Superpowersの核心はスキル（Skill）で、これはClaudeが特定の問題を解決するために読み、実行できるMarkdownベースの知識モジュール
- AnthropicがOffice文書作成機能を公開した際に、スキル概念を初めて披露
- 類似パターンがMicrosoft Amplifierなど複数のコーディングエージェントフレームワークで登場
- スキルはClaudeに「新しい能力」を学習させる単位であり、ユーザーはClaudeに書籍やコードベースを分析させて新しいスキルを抽出するよう依頼できる
- エージェントはスキル検索スクリプトを実行し、その活動に対するスキルがあれば必ず使用しなければならない
- 最初のメタスキルである"スキルの書き方"を通じて、Claudeが新しいスキルを自律的に生成するワークフローを支援
- モデルに"この本を読み、考え、学んだ内容を記録せよ"と依頼すると、再利用可能な知識を自動で構造化する
- Claudeは生成されたスキルをテストするためにサブエージェント（subagents）をシミュレートし、各スキルが実際に有効かをTDD方式で検証する
- 初期の試みではゲームショーのクイズ形式で検証したが、実効性が不足
- 改善後は「圧力テスト（pressure test）」シナリオを構成し、実環境に近い条件でスキルの有効性を点検する
圧力シナリオのテスト事例
- シナリオ 1: 時間的プレッシャー + 自信
- 状況: 本番障害により1分あたり5,000ドルの損失が発生中で、認証サービスのデバッグが必要
- 選択肢: 即座にデバッグ（5分所要） vs スキル検索後にデバッグ（7分所要）
- 目的: 緊急時でもスキル検索を優先させること
- シナリオ 2: サンクコスト + 動作するコード
- 状況: 45分かけて作成した非同期テストインフラがすでに動作中
- 選択肢: スキル確認後に再作業の可能性あり（3分所要） vs 現在のコードをコミット
- 目的: 動作するコードがあってもスキル順守を強制すること
- Robert Cialdiniの説得心理学の原理（権威、コミットメント、好意、希少性など）をLLMに適用
- 最近Dan Shapiroらが共同執筆した研究で、Cialdiniの原理がLLMにも有効であることが科学的に実証された
- Superpowersのスキルシステムがすでに説得技法を無意識に活用していたことを事後的に発見
- 権威フレーム（"IMPORTANT: 実際の状況"）、コミットメント誘導（"A, B, Cから選択"）、希少性（"午後6時、午後6時30分"）
記憶（Memories）機能
- Superpowersは、Claudeが以前の対話の文脈を保持して活用できる**「remembering-conversations」スキル**を含む
- このスキルは対話ログをSQLiteベースのベクターデータベースに保存し、Claude Haikuを使って要約を生成する
.claudeの外部に対話記録を自動複製し、Anthropicの自動削除を防止- Claudeは必要なときにサブエージェントを通じて過去の対話から関連情報を検索し、不要な検索でコンテキストウィンドウが汚染されないよう設計されている
- まだ全体の接続は完了していないが、すべての構成要素はすでに実装済み
共有（Sharing）機能
- Superpowersの目標はスキル共有エコシステムの構築
- ユーザーは自分のClaudeが学習したスキルをGitHub Pull Requestの形で提出し、他のユーザーと共有できる
- 新しいClaudeプラグインシステムと統合しつつ、ユーザーの同意なくスキルが共有されないよう安全策を設けている
- 初期のインストール方式は単にClaudeに特定URLを読ませる方式だったが、現在はプラグインマーケットプレイス構造へ移行
インストールと活用
- Claude Code 2.0.13以上が必要
- プラグインマーケットプレイスでインストールコマンドを実行
/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplace
- 再起動後、ブートストラッププロンプトが注入され、スキルシステムが自動で有効化される
- ClaudeとSuperpowersで実際にTodoアプリを実装した完全ログが公開されており、そこでClaudeの質問、テスト駆動開発、git管理の過程を見ることができる
まだコメントはありません。