クロード・コード・サブエージェント・コレクション：開発効率向上のためのAIインテリジェントボディ拡張

Claude Code Subagent Collectionは、Claude Codeのために特別に設計された一連のAIサブエージェントを提供するオープンソースプロジェクトで、特定のドメイン知識を持つエキスパートを呼び出すことで開発ワークフローを強化するように設計されています。このコレクションには、特定のドメインの専門知識を持つ複数のサブエージェントが含まれており、コンテキストに基づいて自動的に呼び出したり、必要に応じてユーザーが明示的に指定したりすることができます。これらのサブエージェントは、バックエンドのアーキテクチャ設計、フロントエンドの開発、データベースの最適化、コードレビュー、セキュリティ監査、複数のプログラミング言語の専門家サポートなど、ソフトウェア開発のさまざまな側面をカバーしています。タスクを最適な専門家エージェントに任せることで、開発者は複雑な問題をより効率的に解決し、コード品質と開発速度を向上させることができる。このプロジェクトは、あらかじめ定義されたサブエージェントを提供するだけでなく、ユーザが自身のニーズに基づいて新しいサブエージェントを作成し、貢献することも可能にしており、その結果、開発ツールのエコシステムが拡大し、改善され続けている。

機能一覧

• 自動コールClaude Codeは、タスク要件、キーワード、ファイルタイプ、エラーメッセージに基づいて、自動的に最適なサブエージェントを選択し、起動することができます。
• 明示的呼出しユーザーは、自然言語による指示によって、タスクに対して特定のサブエージェントの使用を明示的に要求することができる。code-reviewer私の最近の変化をチェックしてください"
• ドメインエキスパート複数の技術分野をカバーするサブエージェントを提供する：
  • 開発＆建築としてbackend-architect(バックエンド・アーキテクト）、frontend-developer(フロントエンド開発者）、mobile-developer(モバイル開発者）など。
  • プログラミング言語スペシャリストとしてpython-pro(Pythonのエキスパート）、golang-pro(エキスパートへ）、rust-pro(錆の専門家）など。
  • インフラストラクチャーおよび運用・保守としてdevops-troubleshooter(オペレーション＆メンテナンス問題トラブルシューティング・スペシャリスト）、deployment-engineer(デプロイメント・エンジニア）、cloud-architect(クラウド・アーキテクト）など。
  • 品質と安全性としてcode-reviewer(コード・レビュアー）、security-auditor(セキュリティ監査人）、test-automator(テスト自動化エンジニア）など。
  • データとAIとしてdata-scientist(データサイエンティスト）、ai-engineer(AIエンジニア）、ml-engineer(機械学習エンジニア）など
  • 分野別としてapi-documenter(API Documentation Writer）、payment-integration(決済統合スペシャリスト）、blockchain-developer(ブロックチェーン開発者）など。
  • 暗号通貨取引提供crypto-trader(暗号通貨トレーダー）、defi-strategist(DeFiストラテジスト）をはじめ、多くの専門家が参加している。
• スケーラビリティユーザーは、特定のプロジェクト要件を満たすために、指定された形式で独自のサブエージェントを作成し、そのプロジェクトに新しいサブエージェントを貢献することができます。
• 簡単なインストールと設定ローカルにリポジトリをクローンし、サブエージェントとして.mdクロードコードの指定ディレクトリにファイルをコピーすることでインストールが完了します。

ヘルプの使用

このプロジェクトの中核は、Claude Codeの機能を拡張し、汎用のAIアシスタントから複数の専門家からなる共同チームへと変貌させることである。各サブエージェントは、そのエージェントの役割、専門知識、行動を定義する個別のプロファイル（Markdown形式）です。ユーザーがClaude Codeと対話すると、システムはどの専門家が手元のタスクを処理するのに最も適しているかをインテリジェントに判断し、タスクをその専門家に委譲します。

設置プロセス

1. 前提条件::
   • ローカルにクロードコードをインストールし、設定する必要があります。
   • クロード・コード・エージェントの設定ファイルを格納するディレクトリにアクセスできる必要があります。~/.claude/agents/.
2. クローン倉庫::
   ターミナルかコマンドラインツールを開いてgitコマンドでプロジェクトのコード・リポジトリをクローンする：

   git clone https://github.com/davepoon/claude-code-subagents-collection.git
   

3. プロジェクト・ディレクトリに移動する::

   cd claude-code-subagents-collection
   

4. サブプロキシファイルのコピー::
   すべてのサブエージェント・プロファイル(.mdファイル) をクロードコードのプロキシディレクトリにコピーします。お使いのオペレーティングシステムに応じて、以下の適切なコマンドを使用してください：
   • macOS/Linux:

     cp *.md ~/.claude/agents/
     

   • ウィンドウズ:

     copy *.md %USERPROFILE%\.claude\agents\
     

5. インストールの確認::
   ファイルが正常にコピーされたことは、プロキシディレクトリ内のファイルをリストアップすることで確認できる：

   ls ~/.claude/agents/
   

   またはWindowsでは dir %USERPROFILE%\.claude\agents\.過去にコピーされたものをすべて見ることができるはずです。.mdドキュメンテーション

6. リスタート・クロード・コード::
   クロード・コードが新しいサブエージェントを読み込むには、クロード・コードを再起動する必要がある。

操作方法

一度インストールすれば、これらのサブエージェントを日々の開発に活用することができる。主な使い方は2つある：

1.自動コール

これが最も一般的で便利な使い方です。いつものようにClaude Codeに要件を提示するだけで、あなたの説明に基づいてタスクを実行するための最も適切なサブエージェントを自動的に選択します。

• サンプルシナリオ::
  • 新しいユーザー認証機能を書き終えたら、Claudeに「ユーザー認証機能を実装しました」と伝えればいい。code-reviewerを呼び出しながら、コードの品質と保守性をレビューする。security-auditorセキュリティの脆弱性をチェックする。
  • コードを実行するときにエラーが発生した場合、たとえば「私のReactコンポーネントにはTypeError"を呼び出すと、クロードは自動的にdebugger問題を分析し、特定するのに役立ちます。
  • 特定のデータベースクエリが遅いことに気づいたら、"This query is running slow." と言うことができます。database-optimizerを使用してクエリ文を分析し、最適化の提案を行います。

2.明示的な呼び出し

場合によっては、特定のタスクにエキスパートを直接割り当てたいこともあるでしょう。この場合、質問時に使用するサブエージェントを指定することができます。

• サンプルシナリオ::
  • コード・レビュー"させるcode-reviewer私の最新の投稿をチェックしてください"
  • セキュリティ監査お願いしますsecurity-auditorこの認証コードを確認してください。
  • パフォーマンス最適化"させるperformance-engineerこの機能を最適化する

独自のサブエージェントを作成する

既存のサブエージェントがあなたのニーズに合わないと感じたら、絶対に自分で作ることができる。

1. ドキュメントの作成::
   プロジェクトディレクトリまたは~/.claude/agents/ディレクトリに新しいMarkdownファイルを作成する。your-agent-name.md例えばmy-database-expert.md.
2. 設定ファイルの書き込み::
   ファイルの内容は、特定のフォーマットに従う必要があります。frontmatterヘッダーとシステム・プロンプトが表示される。

   ---
   name: your-subagent-name
   description: A clear description of when this subagent should be invoked.
   tools: tool1, tool2 # 可选，限制该代理能使用的工具
   ---
   This is the system prompt. You are a helpful assistant specializing in...
   

   • name小文字とハイフンを使用する。
   • descriptionこのサブエージェントの目的を明確に記述することは、クロードが自動電話をかけるための重要な基礎となる。
   • tools (オプション): ファイルの読み書きなど、このエージェントが使用できるツールを指定します。
   • システムプロンプトエージェントの役割、能力、行動スタイル、専門知識を詳細に定義する。ここでは、どのように行動すべきかの具体的な指示や例を示すべきである。

アプリケーションシナリオ

1. 新機能開発
   チームが新機能の開発に着手する際、複数のサブエージェントを順次または並行して使用することができる。まずbackend-architectでAPIインターフェースとデータモデルを設計する。そしてfrontend-developerデザイン案に基づいてフロントエンドのインターフェイスを実装します。開発プロセスでは、次のようなことを遠慮なくお尋ねください。code-reviewerコードがレビューされ、最終的にtest-automator自動テストケースを作成し、安定した機能を保証する。
2. システム・パフォーマンスの最適化
   オンライン・アプリケーションにパフォーマンスのボトルネックがある場合はperformance-engineerを使って、コード内のパフォーマンス問題を特定することができる。問題がデータベースにある場合は、さらにdatabase-optimizer遅いクエリを分析し、インデックスを最適化する。クラウドリソースの割り当てミスの場合cloud-architectコストとパフォーマンスの最適化に関するアドバイスも提供できる。
3. 緊急トラブルシューティング
   本番環境で緊急の問題が発生した場合devops-troubleshooterログを分析し、データを監視し、問題の根本原因を素早く突き止めるのに役立つ。コードのバグであることが判明した場合はdebugger開発者がデバッグや修正のためにコードに潜り込むのを支援できる。
4. レガシーシステムの近代化
   古いプロジェクトの場合。legacy-modernizerリファクタリングソリューションを提供し、開発者が時代遅れのコードベースを最新の技術スタックに徐々に移行するのを支援します。既存のコード構造を分析し、改善点を提案し、部分的にリファクタリングされたコードを生成することができます。

品質保証

1. Q: クロード・コードはこれらのサブエージェントをどのように呼んでいるのですか？
   A: 呼び出しには2種類あります。一つ目は自動呼び出しで、Claude Code はリクエストの内容、コンテキスト、ファイルタイプ、その他の情報に基づいて、どのサブプロキシを使うべきかをインテリジェントに判断します。例えば、"データベースクエリ "と言った場合、自動的にdatabase-optimizer.もうひとつは明示的な呼び出しで、リクエストの中で直接指定することができる。security-auditorこのコードをチェックしてください」。
2. Q: 同じような機能を持つ複数のサブ・エージェントをインストールした場合、クロードはどのように選ぶのでしょうか？
   A: クロードの選択は、以下のサブエージェント設定ファイルに大きく依存します。descriptionフィールド説明が明確で具体的であればあるほど、クロードはより正確に最適なエージェントを選択することができます。記述が曖昧すぎたり、重複していたりすると、不正確な選択となる可能性があります。従って、カスタムサブエージェントには明確な説明を書くことが重要です。
3. Q: 複雑な仕事をこなすために、複数のサブ・エージェントを組み合わせて使うことはできますか？
   A: はい、これがクロード・コードの力です。クロード・コードは、複数のサブ・エージェントを自動的にオーケストレーションし、連携させることができます。例えば、完全な開発プロセスは次のようになります：backend-architectデザイン・アーキテクチャー python-proコードを書く code-reviewerコードを見直す security-auditor安全点検の実施 deployment-engineer配備を担当。全プロセスはバックグラウンドでクロードが自動的に調整することができる。