Shannon MCP

🚀 Claude Codeサブエージェントコレクション

Claude Code 用の専門的なAIサブエージェントの包括的なコレクションです。特定ドメインの専門知識を活用して開発ワークフローを強化します。

🚀 クイックスタート

このリポジトリには、Claude Codeの機能を拡張する46の専門サブエージェントが含まれています。各サブエージェントは特定のドメインの専門家であり、コンテキストに基づいて自動的に呼び出されるか、必要に応じて明示的に呼び出すことができます。すべてのエージェントは、タスクの複雑度に基づいて特定のClaudeモデルで構成されており、最適なパフォーマンスとコスト効率を実現します。

✨ 主な機能

利用可能なサブエージェント

開発とアーキテクチャ

• backend-architect - RESTful API、マイクロサービスの境界、データベーススキーマを設計します。
• frontend-developer - Reactコンポーネントを構築し、レスポンシブなレイアウトを実装し、クライアント側の状態管理を処理します。
• mobile-developer - React NativeまたはFlutterアプリをネイティブ統合で開発します。
• graphql-architect - GraphQLスキーマ、リゾルバ、フェデレーションを設計します。
• architect-reviewer - コード変更のアーキテクチャの一貫性とパターンをレビューします。

言語専門家

• python-pro - 高度な機能と最適化を備えた慣用的なPythonコードを記述します。
• golang-pro - ゴルーチン、チャネル、インターフェースを使用した慣用的なGoコードを記述します。
• rust-pro - 所有権パターン、ライフタイム、トレイト実装を使用した慣用的なRustを記述します。
• c-pro - 適切なメモリ管理とシステム呼び出しを備えた効率的なCコードを記述します。
• cpp-pro - 最新の機能、RAII、スマートポインタ、STLアルゴリズムを備えた慣用的なC++コードを記述します。
• javascript-pro - ES6+、非同期パターン、Node.js APIを使った最新のJavaScriptをマスターします。
• php-pro - 最新の機能とパフォーマンス最適化を備えた慣用的なPHPコードを記述します。
• sql-pro - 複雑なSQLクエリを記述し、実行プランを最適化し、正規化されたスキーマを設計します。

インフラストラクチャと運用

• devops-troubleshooter - 本番環境の問題をデバッグし、ログを分析し、デプロイメントの失敗を修正します。
• deployment-engineer - CI/CDパイプライン、Dockerコンテナ、クラウドデプロイメントを構成します。
• cloud-architect - AWS/Azure/GCPインフラストラクチャを設計し、クラウドコストを最適化します。
• database-optimizer - SQLクエリを最適化し、効率的なインデックスを設計し、データベースの移行を処理します。
• database-admin - データベースの操作、バックアップ、レプリケーション、監視を管理します。
• terraform-specialist - 高度なTerraformモジュールを記述し、状態ファイルを管理し、IaCのベストプラクティスを実装します。
• incident-responder - 本番環境のインシデントを迅速かつ正確に処理します。
• network-engineer - ネットワーク接続性をデバッグし、ロードバランサを構成し、トラフィックパターンを分析します。
• dx-optimizer - ツール、セットアップ、ワークフローを改善する開発者体験の専門家です。

品質とセキュリティ

• code-reviewer - 品質、セキュリティ、保守性のためのエキスパートコードレビューを行います。
• security-auditor - コードの脆弱性をレビューし、OWASP準拠を確保します。
• test-automator - 単体テスト、統合テスト、エンドツーエンドテストを含む包括的なテストスイートを作成します。
• 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 - 複数のエージェントと長時間実行されるタスク間のコンテキストを管理します。

ビジネスとマーケティング

• business-analyst - メトリクスを分析し、レポートを作成し、KPIを追跡します。
• content-marketer - ブログ記事、ソーシャルメディアコンテンツ、メールニュースレターを記述します。
• sales-automator - コールドメール、フォローアップ、提案テンプレートを作成します。
• customer-support - サポートチケット、FAQ応答、顧客メールを処理します。
• legal-advisor - プライバシーポリシー、サービス利用規約、免責事項、法的通知を作成します。

モデル割り当て

すべての46のサブエージェントは、タスクの複雑度に基づいて特定のClaudeモデルで構成されています。

🚀 Claude Haiku 3.5 (高速かつコスト効率が良い) - 8エージェント

モデル: claude-3-5-haiku-20241022

• data-scientist - SQLクエリとデータ分析
• api-documenter - OpenAPI/Swaggerドキュメント
• business-analyst - メトリクスとKPIの追跡
• content-marketer - ブログ記事とソーシャルメディア
• customer-support - サポートチケットとFAQ
• sales-automator - コールドメールと提案
• search-specialist - ウェブリサーチと情報収集
• legal-advisor - プライバシーポリシーとコンプライアンスドキュメント

⚡ Claude Sonnet 4 (バランスの良いパフォーマンス) - 26エージェント

モデル: claude-sonnet-4-20250514

開発と言語:

• python-pro - 高度な機能を備えたPython開発
• javascript-pro - 最新のJavaScriptとNode.js
• golang-pro - Goの並行性と慣用的なパターン
• rust-pro - Rustのメモリ安全性とシステムプログラミング
• c-pro - Cプログラミングと組み込みシステム
• cpp-pro - STLとテンプレートを備えた最新のC++
• frontend-developer - Reactコンポーネントと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 - インフラストラクチャ即コード
• network-engineer - ネットワーク構成
• dx-optimizer - 開発者体験
• data-engineer - ETLパイプライン

品質とサポート:

• test-automator - テストスイートの作成
• code-reviewer - コード品質分析
• debugger - エラー調査
• error-detective - ログ分析
• ml-engineer - MLモデルのデプロイ
• legacy-modernizer - フレームワークの移行
• payment-integration - 支払い処理

🧠 Claude Opus 4 (最大能力) - 11エージェント

モデル: claude-opus-4-20250514

• ai-engineer - LLMアプリケーションとRAGシステム
• security-auditor - 脆弱性分析
• performance-engineer - アプリケーション最適化
• incident-responder - 本番環境のインシデント処理
• mlops-engineer - MLインフラストラクチャ
• architect-reviewer - アーキテクチャの一貫性
• cloud-architect - クラウドインフラストラクチャ設計
• prompt-engineer - LLMプロンプト最適化
• context-manager - 複数エージェントの調整
• quant-analyst - 金融モデリング
• risk-manager - ポートフォリオリスク管理

📦 インストール

これらのサブエージェントは、~/.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"

単一エージェントタスク

# コード品質とレビュー
"Use code-reviewer to analyze this component for best practices"
"Have security-auditor check for OWASP compliance issues"

# 開発タスク
"Get backend-architect to design a user authentication API"
"Use frontend-developer to create a responsive dashboard layout"

# インフラストラクチャと運用
"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"

# データと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"

# ビジネスとマーケティング
"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"

複数エージェントワークフロー

これらのサブエージェントはシームレスに連携し、より複雑なオーケストレーションには、Claude Code Commands コレクションを使用できます。これは、これらのサブエージェントを高度なワークフローで活用する52の事前構築されたスラッシュコマンドを提供します。

# 機能開発ワークフロー
"Implement user authentication feature"
# 自動的に使用: backend-architect → frontend-developer → test-automator → security-auditor

# パフォーマンス最適化ワークフロー
"Optimize the checkout process performance"
# 自動的に使用: performance-engineer → database-optimizer → frontend-developer

# 本番環境インシデントワークフロー
"Debug high memory usage in production"
# 自動的に使用: incident-responder → devops-troubleshooter → error-detective → performance-engineer

# ネットワーク接続性ワークフロー
"Fix intermittent API timeouts"
# 自動的に使用: network-engineer → devops-troubleshooter → performance-engineer

# データベースメンテナンスワークフロー
"Set up disaster recovery for production database"
# 自動的に使用: database-admin → database-optimizer → incident-responder

# MLパイプラインワークフロー
"Build end-to-end ML pipeline with monitoring"
# 自動的に使用: mlops-engineer → ml-engineer → data-engineer → performance-engineer

# 製品リリースワークフロー
"Launch new feature with marketing campaign"
# 自動的に使用: business-analyst → content-marketer → sales-automator → customer-support

スラッシュコマンドを使用した高度なワークフロー

より洗練された複数サブエージェントのオーケストレーションには、コンパニオンのCommandsリポジトリを使用します。

# 複雑な機能開発 (8以上のサブエージェント)
/full-stack-feature Build user dashboard with real-time analytics

# 本番環境インシデント対応 (5以上のサブエージェント)
/incident-response Database connection pool exhausted

# MLインフラストラクチャセットアップ (6以上のサブエージェント)
/ml-pipeline Create recommendation engine with A/B testing

# セキュリティに重点を置いた実装 (7以上のサブエージェント)
/security-hardening Implement OAuth2 with zero-trust architecture

サブエージェントの形式

各サブエージェントは次の構造に従います。

---
name: subagent-name
description: When this subagent should be invoked
model: claude-3-5-haiku-20241022  # オプション - 使用するモデルを指定
tools: tool1, tool2  # オプション - デフォルトはすべてのツール
---

System prompt defining the subagent's role and capabilities

モデル構成

Claude Code v1.0.64以降、サブエージェントは使用するClaudeモデルを指定できます。これにより、タスクの複雑度に基づいてコスト効率の良いタスクの委任が可能になります。

• 低複雑度 (Haiku 3.5): 基本的なデータ分析、ドキュメント生成、標準的な応答などの単純なタスク
• 中複雑度 (Sonnet 4): 開発タスク、コードレビュー、テスト、標準的なエンジニアリング作業
• 高複雑度 (Opus 4): セキュリティ監査、アーキテクチャレビュー、インシデント対応、AI/MLエンジニアリングなどの重要なタスク

利用可能なモデル:

• claude-3-5-haiku-20241022 - 単純なタスクに高速かつコスト効率が良い
• claude-sonnet-4-20250514 - ほとんどの開発作業にバランスの良いパフォーマンス
• claude-opus-4-20250514 - 複雑な分析と重要なタスクに最も能力が高い

モデルが指定されていない場合、サブエージェントはシステムのデフォルトモデルを使用します。

エージェントのオーケストレーションパターン

Claude Codeは、次の一般的なパターンを使用してエージェントを自動的に調整します。

シーケンシャルワークフロー

User Request → Agent A → Agent B → Agent C → Result

Example: "Build a new API feature"
backend-architect → frontend-developer → test-automator → security-auditor

並列実行

User Request → Agent A + Agent B (simultaneously) → Merge Results

Example: "Optimize application performance" 
performance-engineer + database-optimizer → Combined recommendations

条件分岐

User Request → Analysis → Route to appropriate specialist

Example: "Fix this bug"
debugger (analyzes) → Routes to: backend-architect OR frontend-developer OR devops-troubleshooter

レビューと検証

Primary Agent → Review Agent → Final Result

Example: "Implement payment processing"
payment-integration → security-auditor → Validated implementation

いつどのエージェントを使用するか

🏗️ 計画とアーキテクチャ

• backend-architect: API設計、データベーススキーマ、システムアーキテクチャ
• frontend-developer: UI/UX計画、コンポーネントアーキテクチャ
• cloud-architect: インフラストラクチャ設計、スケーラビリティ計画

🔧 実装と開発

• python-pro: Python固有の開発タスク
• golang-pro: Go固有の開発タスク
• rust-pro: Rust固有の開発、メモリ安全性、システムプログラミング
• c-pro: Cプログラミング、組み込みシステム、パフォーマンスに敏感なコード
• javascript-pro: 最新のJavaScript、非同期パターン、Node.js/ブラウザコード
• 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: 深層ウェブリサーチ、競合分析、事実確認

💼 ビジネスと戦略

• business-analyst: KPI、収益モデル、成長予測、投資家メトリクス
• risk-manager: ポートフォリオリスク、ヘッジ戦略、Rマルチプル、ポジションサイジング
• content-marketer: SEOコンテンツ、ブログ記事、ソーシャルメディア、メールキャンペーン
• sales-automator: コールドメール、フォローアップ、提案、リード育成
• customer-support: サポートチケット、FAQ、ヘルプドキュメント、トラブルシューティング
• legal-advisor - プライバシーポリシー、サービス利用規約、免責事項、法的通知を作成します。

ベストプラクティス

🎯 タスクの委任

1. Claude Codeに自動的に委任させる - メインエージェントがコンテキストを分析し、最適なエージェントを選択します。
2. 要件を明確にする - 制約、テクノロジースタック、品質要件を含めます。
3. エージェントの専門知識を信頼する - 各エージェントはそのドメインで最適化されています。

🔄 複数エージェントのワークフロー

4. 高レベルのリクエストから始める - エージェントに複雑な多段階タスクを調整させます。
5. エージェント間でコンテキストを提供する - エージェントが必要な背景情報を持つようにします。
6. 統合ポイントをレビューする - 異なるエージェントの出力がどのように連携するかを確認します。

🎛️ 明示的な制御

7. 特定のニーズに明示的な呼び出しを使用する - 特定の専門家の視点が必要な場合。
8. 複数のエージェントを戦略的に組み合わせる - 異なる専門家が互いの作業を検証できます。
9. 特定のレビューパターンを要求する - "Have security-auditor review backend-architect's API design"

📈 最適化

10. エージェントの有効性を監視する - どのエージェントがあなたのユースケースに最適かを学びます。
11. 複雑なタスクを反復する - エージェントのフィードバックを使用して要件を洗練させます。
12. エージェントの強みを活用する - タスクの複雑度をエージェントの能力に合わせます。

貢献方法

新しいサブエージェントを追加するには、次の手順を実行します。

1. 上記の形式に従って新しい.mdファイルを作成します。
2. 小文字でハイフン区切りの名前を使用します。
3. サブエージェントを使用するタイミングについて明確な説明を記述します。
4. システムプロンプトに具体的な指示を含めます。

トラブルシューティング

一般的な問題

エージェントが自動的に呼び出されない場合

• リクエストでドメインを明確に示してください (例: "performance issue" → performance-engineer)
• タスクの種類を具体的に指定してください (例: "review code" → code-reviewer)

予期しないエージェントが選択される場合

• テクノロジースタックと要件に関するコンテキストを提供してください。
• 特定のエージェントが必要な場合は、明示的な呼び出しを使用してください。

複数のエージェントが矛盾するアドバイスを提供する場合

• これは正常な現象です - 異なる専門家は異なる優先事項を持つ場合があります。
• 説明を求めてください: "Reconcile the recommendations from security-auditor and performance-engineer"

エージェントがコンテキストを欠いているように見える場合

• リクエストで背景情報を提供してください。
• 以前の会話や確立されたパターンを参照してください。

ヘルプの取得

エージェントが期待通りに動作しない場合:

1. 個々のファイルのエージェントの説明を確認してください。
2. リクエストでより具体的な言葉を使用してみてください。
3. 特定のエージェントをテストするために明示的な呼び出しを使用してください。
4. プロジェクトと目標に関するコンテキストを提供してください。

詳細情報

• Claude Code Documentation
• Subagents Documentation
• Claude Code GitHub