Claude Code サブエージェントコレクション
Claude Code用の専門的なAIサブエージェントを網羅したコレクションで、分野別の専門知識により開発ワークフローを強化します。
概要
このリポジトリには、Claude Codeの機能を拡張する76種類の専門サブエージェントが含まれています。各サブエージェントは特定分野のエキスパートであり、コンテキストに基づいて自動的に呼び出されるか、必要に応じて明示的に呼び出すことができます。すべてのエージェントは、タスクの複雑さに応じたClaudeモデルで構成され、最適なパフォーマンスとコスト効率を実現します。
利用可能なサブエージェント
開発とアーキテクチャ
- backend-architect - RESTful API、マイクロサービスの境界、データベーススキーマを設計
- frontend-developer - Reactコンポーネントの構築、レスポンシブレイアウトの実装、クライアントサイドの状態管理を担当
- ui-ux-designer - インターフェースデザイン、ワイヤーフレーム、デザインシステムの作成
- ui-visual-validator - 厳密なスクリーンショット分析により、UI変更が目的を達成したかを検証
- mobile-developer - React NativeまたはFlutterアプリの開発とネイティブ統合
- graphql-architect - GraphQLスキーマ、リゾルバ、フェデレーションの設計
- architect-reviewer - アーキテクチャの一貫性やパターンに関するコード変更のレビュー
言語スペシャリスト
- python-pro - 高度な機能と最適化を備えたイディオマティックなPythonコードの作成
- ruby-pro - メタプログラミング、Railsパターン、gem開発、テストフレームワークを活用したイディオマティックなRubyコードの作成
- golang-pro - ゴルーチン、チャネル、インターフェースを用いたイディオマティックなGoコードの作成
- rust-pro - 所有権パターン、ライフタイム、トレイト実装を用いたイディオマティックなRustの作成
- c-pro - 適切なメモリ管理とシステムコールを備えた効率的なCコードの作成
- cpp-pro - モダンな機能、RAII、スマートポインタ、STLアルゴリズムを用いたイディオマティックなC++コードの作成
- javascript-pro - ES6+、非同期パターン、Node.js APIを駆使したモダンJavaScriptの習得
- typescript-pro - 高度な型、ジェネリクス、厳格な型安全性を備えたTypeScriptの習得
- php-pro - モダンな機能とパフォーマンス最適化を備えたイディオマティックなPHPコードの作成
- java-pro - ストリーム、並行処理、JVM最適化を駆使したモダンJavaの習得
- elixir-pro - OTPパターン、関数型プログラミング、Phoenixフレームワークを活用したイディオマティックなElixirコードの作成
- csharp-pro - 高度な機能と.NET最適化を備えたモダンC#コードの作成
- scala-pro - 関数型プログラミング、分散システム、ビッグデータ処理を駆使したエンタープライズグレードのScala開発
- flutter-expert - Dart、ウィジェット、プラットフォーム統合を活用したFlutter開発の習得
- unity-developer - 最適化されたスクリプトとパフォーマンスチューニングによるUnityゲームの構築
- minecraft-bukkit-pro - Bukkit、Spigot、Paper APIによるMinecraftサーバープラグイン開発の習得
- ios-developer - Swift/SwiftUIでのネイティブiOSアプリケーション開発
- sql-pro - 複雑なSQLクエリの記述、実行プランの最適化、正規化スキーマの設計
インフラストラクチャと運用
- devops-troubleshooter - 本番問題のデバッグ、ログ分析、デプロイ失敗の修正
- deployment-engineer - CI/CDパイプライン、Dockerコンテナ、クラウドデプロイの構成
- cloud-architect - AWS/Azure/GCPインフラの設計とクラウドコストの最適化
- hybrid-cloud-architect - AWS/Azure/GCPとOpenStackオンプレミス環境を跨ぐハイブリッドクラウドインフラの設計
- kubernetes-architect - Kubernetesを中核としたクラウドネイティブインフラの設計と、AWS/Azure/GCPおよびハイブリッド環境でのGitOps原則の導入
- database-optimizer - SQLクエリの最適化、効率的なインデックス設計、データベース移行の対応
- database-admin - データベース運用、バックアップ、レプリケーション、監視の管理
- terraform-specialist - 高度なTerraformモジュールの作成、ステートファイル管理、IaCベストプラクティスの実装
- incident-responder - 本番インシデントを迅速かつ正確に対応
- network-engineer - ネットワーク接続のデバッグ、ロードバランサーの設定、トラフィックパターンの解析
- dx-optimizer - 開発者体験スペシャリスト、ツール・セットアップ・ワークフローの改善
品質 & セキュリティ
- code-reviewer - 高度な設定セキュリティと本番信頼性に重点を置いた専門的なコードレビュー
- security-auditor - コードの脆弱性をレビューし、OWASP準拠を保証
- test-automator - ユニット・統合・E2Eテストを含む包括的なテストスイートを作成
- performance-engineer - アプリケーションのプロファイリング、ボトルネックの最適化、キャッシュ戦略の実装
- debugger - エラー、テスト失敗、予期せぬ挙動のデバッグ専門家
- error-detective - ログやコードベースからエラーパターン、スタックトレース、異常を検索
- search-specialist - 高度な検索技術と統合を用いたウェブリサーチ専門家
データ & AI
- data-scientist - SQLクエリ、BigQuery操作、データインサイトの解析専門家
- data-engineer - ETLパイプライン、データウェアハウス、ストリーミングアーキテクチャの構築
- ai-engineer - LLMアプリケーション、RAGシステム、プロンプトパイプラインの構築
- ml-engineer - MLパイプライン、モデル提供、特徴量エンジニアリングの実装
- mlops-engineer - MLパイプライン、実験トラッキング、モデルレジストリの構築
- prompt-engineer - LLMやAIシステム向けのプロンプト最適化
専門分野
- api-documenter - OpenAPI/Swagger仕様作成と開発者向けドキュメント作成
- payment-integration - Stripe、PayPal、各種決済プロセッサの統合
- quant-analyst - 金融モデル構築、トレーディング戦略のバックテスト、マーケットデータ分析
- risk-manager - ポートフォリオリスク、Rマルチプル、ポジション制限の監視
- legacy-modernizer - レガシーコードベースのリファクタリングと段階的モダナイゼーションの実装
- context-manager - 複数エージェントや長期タスク間でのコンテキスト管理
ドキュメント
- docs-architect - 既存コードベースから包括的な技術ドキュメントを作成
- mermaid-expert - フローチャート、シーケンス、ERD、アーキテクチャ用のMermaidダイアグラム作成
- reference-builder - 技術リファレンス・APIドキュメントの網羅的作成
- tutorial-engineer - コードからステップバイステップのチュートリアルと教育コンテンツを作成
ビジネス & マーケティング
- business-analyst - メトリクス解析、レポート作成、KPIトラッキング
- content-marketer - ブログ記事、SNSコンテンツ、メールニュースレター作成
- hp-pro - 採用、オンボーディング/オフボーディング、PTO・休暇、パフォーマンス、コンプライアンス方針、従業員関係のパートナー
- sales-automator - コールドメール、フォローアップ、提案テンプレートの作成
- customer-support - サポートチケット、FAQ対応、顧客メールの処理
- legal-advisor - プライバシーポリシー、利用規約、免責事項、法的通知の作成
SEO & コンテンツ最適化
- seo-content-auditor - 提供されたコンテンツの品質、E-E-A-Tシグナル、SEOベストプラクティスを分析
- seo-meta-optimizer - 最適化されたメタタイトル、説明文、URL案を作成
- seo-keyword-strategist - キーワードの使用分析、密度計算、意味的バリエーションを提案
- seo-structure-architect - コンテンツ構造、ヘッダ階層、スキーママークアップを最適化
- seo-snippet-hunter - 強調スニペットやSERP機能向けにコンテンツをフォーマット
- seo-content-refresher - 古くなった要素を特定し、コンテンツの更新を提案
- seo-cannibalization-detector - 複数ページのキーワード重複や競合を分析
- seo-authority-builder - コンテンツのE-E-A-Tシグナルや信頼指標を分析
- seo-content-writer - キーワードやブリーフに基づいたSEO最適化コンテンツの執筆
- seo-content-planner - コンテンツアウトライン、トピッククラスター、カレンダーを作成
モデル割り当て
全76サブエージェントは、タスクの複雑さに基づき特定のClaudeモデルで構成されています:
🚀 Haiku(高速・コスト効率重視) - 15エージェント
モデル:haiku
data-scientist- SQLクエリとデータ分析api-documenter- OpenAPI/Swaggerドキュメント作成reference-builder- 詳細な技術リファレンスとAPI文書business-analyst- 指標・KPIトラッキングcontent-marketer- ブログ投稿とSNSコンテンツcustomer-support- サポートチケットとFAQsales-automator- コールドメールや提案書作成search-specialist- ウェブリサーチと情報収集legal-advisor- プライバシーポリシーやコンプライアンス文書seo-meta-optimizer- メタタイトル・説明文の最適化seo-keyword-strategist- キーワード密度・意味解析seo-structure-architect- コンテンツ構造・スキーママークアップseo-snippet-hunter- 強調スニペットフォーマットseo-content-refresher- コンテンツの鮮度更新seo-cannibalization-detector- キーワード重複検出seo-content-planner- コンテンツカレンダー・アウトライン
⚡ Sonnet(バランス型パフォーマンス) - 45エージェント
モデル:sonnet開発 & 言語:
python-pro- 高度な機能を備えたPython開発ruby-pro- メタプログラミング、Railsパターン、gem開発を含むRuby開発javascript-pro- 最新のJavaScriptとNode.jstypescript-pro- 型システムを活用した高度なTypeScriptgolang-pro- Goの並行処理とイディオマティックなパターンrust-pro- Rustのメモリ安全性とシステムプログラミングc-pro- C言語によるプログラミングと組み込みシステムcpp-pro- STLとテンプレートを活用した最新C++php-pro- 高度な機能を備えた最新PHPjava-pro- ストリームと並行処理を活用した最新Javaelixir-pro- OTPパターンとPhoenixを使ったElixircsharp-pro- .NETフレームワークとパターンによる最新C#scala-pro- Apache Pekko、Akka、Spark、ZIO/Cats Effectを用いたエンタープライズScalaflutter-expert- 状態管理とアニメーションを含むFlutter開発unity-developer- Unityによるゲーム開発と最適化minecraft-bukkit-pro- Bukkit/Spigot/PaperによるMinecraftプラグイン開発ios-developer- Swift/SwiftUIによるネイティブiOS開発frontend-developer- ReactコンポーネントとUIui-ux-designer- インターフェース設計とワイヤーフレームui-visual-validator- スクリーンショット解析による厳格なUIバリデーションbackend-architect- API設計とマイクロサービスmobile-developer- React Native/Flutterアプリsql-pro- 複雑なSQL最適化graphql-architect- GraphQLスキーマとリゾルバ
devops-troubleshooter- 本番環境のデバッグdeployment-engineer- CI/CDパイプラインdatabase-optimizer- クエリ最適化database-admin- データベース運用terraform-specialist- Infrastructure as Codenetwork-engineer- ネットワーク構成dx-optimizer- 開発者体験の最適化data-engineer- ETLパイプライン
test-automator- テストスイート作成code-reviewer- コード品質分析debugger- エラー調査error-detective- ログ解析ml-engineer- 機械学習モデルのデプロイlegacy-modernizer- フレームワークの移行payment-integration- 決済処理mermaid-expert- Mermaid図とビジュアルドキュメントflutter-expert- Flutter開発seo-content-auditor- コンテンツ品質とE-E-A-T分析seo-authority-builder- 権威シグナルの最適化seo-content-writer- SEO最適化コンテンツ作成
🧠 Opus(最大能力)- 15エージェント
モデル:opus
ai-engineer- LLMアプリケーションとRAGシステムsecurity-auditor- 脆弱性分析performance-engineer- アプリケーション最適化incident-responder- 本番インシデント対応mlops-engineer- 機械学習インフラarchitect-reviewer- アーキテクチャ整合性cloud-architect- クラウドインフラ設計prompt-engineer- LLMプロンプト最適化context-manager- マルチエージェント協調quant-analyst- 金融モデリングrisk-manager- ポートフォリオリスク管理docs-architect- コードベースから包括的な技術ドキュメント作成tutorial-engineer- ステップバイステップのチュートリアルと教育コンテンツ
インストール
これらのサブエージェントは ~/.claude/agents/ ディレクトリに配置することで自動的に利用可能になります。
cd ~/.claude
git clone https://github.com/wshobson/agents.git使用方法
自動呼び出し
Claude Codeは、タスクのコンテキストとサブエージェントの説明に基づいて、適切なサブエージェントに自動的に委任します。明示的な呼び出し
リクエスト内でサブエージェントの名前を明記してください:"Use the code-reviewer to check my recent changes"
"Have the security-auditor scan for vulnerabilities"
"Get the performance-engineer to optimize this bottleneck"使用例
単一エージェントタスク
# Code quality and review
"Use code-reviewer to analyze this component for best practices"
"Have code-reviewer scrutinize these configuration changes"
"Have security-auditor check for OWASP compliance issues"Development tasks
"Get backend-architect to design a user authentication API"
"Use frontend-developer to create a responsive dashboard layout"Infrastructure and operations
"Have devops-troubleshooter analyze these production logs"
"Use cloud-architect to design a scalable AWS architecture"
"Get network-engineer to debug SSL certificate issues"
"Use database-admin to set up backup and replication"Data and AI
"Get data-scientist to analyze this customer behavior dataset"
"Use ai-engineer to build a RAG system for document search"
"Have mlops-engineer set up MLflow experiment tracking"Business and marketing
"Have business-analyst create investor deck with growth metrics"
"Use content-marketer to write SEO-optimized blog post"
"Get sales-automator to create cold email sequence"
"Have customer-support draft FAQ documentation"マルチエージェントワークフロー
これらのサブエージェントはシームレスに連携し、より複雑なオーケストレーションには、これらのサブエージェントを高度なワークフローで活用する52の事前構築済みスラッシュコマンドを提供するClaude Code Commandsコレクションを使用できます。
# Feature development workflow
"Implement user authentication feature"
Automatically uses: backend-architect → frontend-developer → test-automator → security-auditor
Performance optimization workflow
"Optimize the checkout process performance"
Automatically uses: performance-engineer → database-optimizer → frontend-developer
Production incident workflow
"Debug high memory usage in production"
Automatically uses: incident-responder → devops-troubleshooter → error-detective → performance-engineer
Network connectivity workflow
"Fix intermittent API timeouts"
Automatically uses: network-engineer → devops-troubleshooter → performance-engineer
Database maintenance workflow
"Set up disaster recovery for production database"
Automatically uses: database-admin → database-optimizer → incident-responder
ML pipeline workflow
"Build end-to-end ML pipeline with monitoring"
Automatically uses: mlops-engineer → ml-engineer → data-engineer → performance-engineer
Product launch workflow
"Launch new feature with marketing campaign"
Automatically uses: business-analyst → content-marketer → sales-automator → customer-support
スラッシュコマンドを用いた高度なワークフロー
より高度なマルチサブエージェントのオーケストレーションには、付属のCommandsリポジトリを使用してください:
# Complex feature development (8+ subagents)
/full-stack-feature Build user dashboard with real-time analyticsProduction incident response (5+ subagents)
/incident-response Database connection pool exhaustedML infrastructure setup (6+ subagents)
/ml-pipeline Create recommendation engine with A/B testingSecurity-focused implementation (7+ subagents)
/security-hardening Implement OAuth2 with zero-trust architectureサブエージェント形式
各サブエージェントはこの構造に従います:
---
name: subagent-name
description: When this subagent should be invoked
model: haiku # Optional - specify which model to use (haiku/sonnet/opus)
tools: tool1, tool2 # Optional - defaults to all tools
System prompt defining the subagent's role and capabilities
モデル構成
Claude Code v1.0.64以降、サブエージェントは使用するClaudeモデルを指定できます。これにより、タスクの複雑さに応じたコスト効率の良いタスク委譲が可能になります:
- 低複雑度(Haiku):基本的なデータ分析、ドキュメント生成、標準的な応答などの簡単なタスク
- 中複雑度(Sonnet):開発作業、コードレビュー、テスト、一般的なエンジニアリング作業
- 高複雑度(Opus):セキュリティ監査、アーキテクチャレビュー、インシデント対応、AI/MLエンジニアリングなどの重要なタスク
haiku- 簡単なタスクに対して高速かつコスト効率が良いsonnet- ほとんどの開発作業に対してバランスの取れた性能opus- 複雑な分析や重要タスクに最も適したモデル
エージェントオーケストレーションパターン
Claude Codeはこれらの一般的なパターンを使って自動的にエージェントを調整します:
逐次ワークフロー
User Request → Agent A → Agent B → Agent C → ResultExample: "Build a new API feature"
backend-architect → frontend-developer → test-automator → security-auditor
Parallel Execution
User Request → Agent A + Agent B (simultaneously) → Merge ResultsExample: "Optimize application performance"
performance-engineer + database-optimizer → Combined recommendations
条件分岐
User Request → Analysis → Route to appropriate specialistExample: "Fix this bug"
debugger (analyzes) → Routes to: backend-architect OR frontend-developer OR devops-troubleshooter
レビューと検証
Primary Agent → Review Agent → Final ResultExample: "Implement payment processing"
payment-integration → security-auditor → Validated implementation
どのエージェントをいつ使うべきか
🏗️ 計画・アーキテクチャ
- backend-architect: API設計、データベーススキーマ、システムアーキテクチャ
- frontend-developer: UI/UX計画、コンポーネントアーキテクチャ
- ui-ux-designer: インターフェース設計、ワイヤーフレーム、デザインシステム、ユーザーリサーチ
- cloud-architect: インフラ設計、スケーラビリティ計画
🔧 実装・開発
- python-pro: Python特有の開発タスク
- ruby-pro: Rubyメタプログラミング、Railsアプリケーション、gem開発、RSpec/Minitestテスト
- golang-pro: Go特有の開発タスク
- rust-pro: Rust開発、メモリ安全性、システムプログラミング
- c-pro: Cプログラミング、組み込みシステム、パフォーマンス重視コード
- javascript-pro: 最新JavaScript、非同期パターン、Node.js/ブラウザーコード
- typescript-pro: 高度なTypeScript、ジェネリクス、型推論、エンタープライズパターン
- java-pro: 最新Java開発、ストリーム、並行処理、Spring Boot
- elixir-pro: Elixir開発、OTPパターン、Phoenixフレームワーク、関数型プログラミング
- csharp-pro: 最新C#開発、.NETフレームワーク、エンタープライズパターン
- scala-pro: エンタープライズScala、関数型プログラミング、Apache Pekko/Akkaアクター、Apache Spark、ZIO/Cats Effect、リアクティブアーキテクチャ
- flutter-expert: Flutter開発、Dart、状態管理、アニメーション、クロスプラットフォーム展開
- unity-developer: Unityゲーム開発、C#スクリプト、パフォーマンス最適化
- minecraft-bukkit-pro: Minecraftプラグイン開発、イベントシステム、サーバー側機能
- ios-developer: Swift/SwiftUIによるネイティブiOS開発
- sql-pro: データベースクエリ、スキーマ設計、クエリ最適化
- mobile-developer: React Native/Flutter開発
🛠️ 運用・保守
- devops-troubleshooter: 本番環境の問題、デプロイ障害
- incident-responder: 緊急障害への即時対応
- database-optimizer: クエリパフォーマンス、インデックス戦略
- database-admin: バックアップ戦略、レプリケーション、ユーザー管理、災害復旧
- terraform-specialist: インフラ構成管理、Terraformモジュール、ステート管理
- network-engineer: ネットワーク接続、ロードバランサー、SSL/TLS、DNSデバッグ
📊 分析・最適化
- performance-engineer: アプリケーションのボトルネック、最適化
- security-auditor: 脆弱性スキャン、コンプライアンスチェック
- data-scientist: データ分析、インサイト、レポーティング
- mlops-engineer: MLインフラストラクチャ、実験トラッキング、モデルレジストリ、パイプライン自動化
🧪 品質保証
- code-reviewer: コード品質、構成のセキュリティ、運用信頼性
- test-automator: テスト戦略、テストスイート作成
- debugger: バグ調査、エラー解決
- error-detective: ログ解析、エラーパターン認識、根本原因分析
- search-specialist: ディープウェブ調査、競合分析、ファクトチェック
📚 ドキュメント
- api-documenter: OpenAPI/Swagger仕様、APIドキュメント
- docs-architect: 包括的な技術ドキュメント、アーキテクチャガイド、システムマニュアル
- reference-builder: 網羅的なAPIリファレンス、設定ガイド、パラメータドキュメント
- tutorial-engineer: ステップバイステップチュートリアル、学習パス、教育コンテンツ
💼 ビジネス&戦略
- business-analyst: KPI、収益モデル、成長予測、投資家指標
- risk-manager: ポートフォリオリスク、ヘッジ戦略、Rマルチプル、ポジションサイズ管理
- content-marketer: SEOコンテンツ、ブログ投稿、SNS、メールキャンペーン
- sales-automator: コールドメール、フォローアップ、提案書、リード育成
- customer-support: サポートチケット、FAQ、ヘルプドキュメント、トラブルシューティング
- legal-advisor - プライバシーポリシー、利用規約、免責事項、法的通知の作成
ベストプラクティス
🎯 タスクの委任
- Claude Codeに自動委任させる - メインエージェントが文脈を分析し最適なエージェントを選択
- 要件を具体的に伝える - 制約、技術スタック、品質要件を含める
- エージェントの専門性を信頼する - 各エージェントは自分の分野に最適化されている
🔄 マルチエージェントワークフロー
- 高レベルなリクエストから始める - エージェントに複雑なマルチステップタスクを調整させる
- エージェント間で文脈を提供する - 必要な背景情報をエージェントに共有
- 統合ポイントをレビューする - 異なるエージェントの成果物がどう連携するか確認
🎛️ 明示的なコントロール
- 特定のニーズには明示的に呼び出す - 特定の専門家の視点が欲しい場合
- 複数エージェントを戦略的に組み合わせる - 異なる専門家が互いの成果を検証できる
- 特定のレビュー方法を依頼する - 「security-auditorにbackend-architectのAPI設計をレビューしてもらう」
📈 最適化
- エージェントの有効性を監視する - ユースケースに最適なエージェントを学習する
- 複雑なタスクを反復する - エージェントのフィードバックを活用して要件を洗練する
- エージェントの強みを活用する - タスクの複雑さをエージェントの能力に合わせる
貢献方法
新しいサブエージェントを追加するには:
- 上記のフォーマットに従った新しい
.mdファイルを作成する - 小文字・ハイフン区切りの名前を使用する
- サブエージェントを使用すべき場面を明確に記述する
- システムプロンプトに具体的な指示を含める
トラブルシューティング
よくある問題
エージェントが自動的に呼び出されない:
- リクエストがドメインを明確に示しているか確認する(例:「パフォーマンス問題」→ performance-engineer)
- タスクの種類を具体的にする(例:「コードレビュー」→ code-reviewer)
- 技術スタックや要件についてより多くの情報を提供する
- 特定のエージェントが必要な場合は明示的に呼び出す
- これは正常です - 専門家によって優先事項が異なる場合があります
- 明確化を依頼する:「security-auditor と performance-engineer の推奨事項を調整してください」
- リクエストに背景情報を記載する
- 過去の会話や確立されたパターンを参照する
サポートを受ける
エージェントが期待通りに動作しない場合:
- 各エージェントの個別ファイルで説明を確認する
- より具体的な言語でリクエストを試す
- 明示的な呼び出しで特定のエージェントをテストする
- プロジェクトや目標についてより多くの情報を提供する
ライセンス
このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。