Claude Codeでサブエージェントを作成
投資機会を比較したいが、複数の企業を調査してスコアリングするには何時間もかかります。サブエージェントは、あなたの研究ツールの使い方を正確に知っている金融アナリストを雇うようなものです。企業名を伝えると、レポートを収集し、主要な指標で各企業をスコアリングし、最適な投資を推奨します。サブエージェントの構築方法を学べば、仕事で繰り返し発生する複数ステップのワークフローを自動化できます。このチュートリアルでは、そのアナリストを構築する方法を示します。
主要な概念
- サブエージェント - 独自の目標、システムプロンプト、ツールを持ち、自律的にタスクを完了する専門的なAIワーカー
- スキル - サブエージェントが目標を達成するために呼び出すことができる再利用可能な機能（株式レポートの生成など）
- システムプロンプト - サブエージェントが何をするか、企業をどのようにスコアリングするか、どの形式で返すかを定義する指示
- 関心の分離 - スキルはデータを収集し、サブエージェントはそのデータを使用して意思決定を行う
必要なもの
- WindowsでVS CodeでClaude CodeまたはMacでVS CodeでClaude Codeを完了していること
- 株式レポートスキルがすでにインストールされていること（
.claude/skills/generate-stock-reports/内） - VS Codeまたは別のテキストエディタ
- 20〜25分
ステップ1：プロジェクトフォルダを作成してClaude Codeを起動
Windows（WSL）：
- スタートメニューからUbuntuを開く
- 次のコマンドを入力：
cd /mnt/c/Users/YOUR_USERNAME/Documents mkdir stock_picker_test cd stock_picker_testYOUR_USERNAMEをWindowsのユーザー名に置き換えてください - Claude Codeを起動：
claude
Mac：
- ターミナルを開く（アプリケーション > ユーティリティにあります）
- 次のコマンドを入力：
cd ~/Documents mkdir stock_picker_test cd stock_picker_test - Claude Codeを起動：
claude
Claude Codeが起動し、ウェルカムメッセージが表示されます。
ステップ2：株式レポートスキルの存在を確認
サブエージェントを構築する前に、スキルが利用可能であることを確認しましょう。次を入力してください：
利用可能なすべてのスキルをリストしてください
出力にgenerate-stock-reportsが表示されるはずです。このスキルは企業を調査し、製品ニュース、経営陣の更新、財務実績、アナリストの洞察をカバーするレポートを生成します。
表示されない場合、スキルファイルは.claude/skills/generate-stock-reports/（プロジェクトレベル）にあります。
ステップ3：サブエージェント vs スキルのアーキテクチャを理解
サブエージェントとスキルがどのように連携するかは次のとおりです：
| コンポーネント | 目的 | 例 |
|---|---|---|
| スキル | 1つの企業に関する生データを収集 | 「Appleのレポートを生成：製品、財務、経営陣、アナリスト」 |
| サブエージェント | スキルデータを使用して目標を達成 | 「AppleとMicrosoftのレポートを取得し、両方をスコアリングし、どちらに投資すべきか推奨」 |
主な違い：
- スキル = ツール 研究を行う
- サブエージェント = 意思決定者 ツールを使用してロジックを適用する
あなたの株式選択サブエージェントは：
- 各企業のために株式レポートスキルを呼び出す（2回以上）
- カテゴリ全体で企業をスコアリング（財務、成長、経営陣、センチメント）
- スコアを比較して最適な投資を推奨
ステップ4：株式選択サブエージェントを作成
次のコマンドを入力してください：
/agents
Claude Codeエージェントインターフェースが表示され、既存のサブエージェント（ある場合）と、サブエージェントを作成、編集、削除するオプションが表示されます。
サブエージェントを作成しましょう：
- Create new subagentを選択
- Projectを選択
- Generate with Claude (recommended)を選択
- 指示として次を貼り付けてください：
```
stock-pickerという新しいサブエージェント用のmarkdownファイルを作成してください：
- 2つ以上の株式を受け取る
- generate-stock-reportsスキルを使用して調査を行う
- 収集されたデータのカテゴリに基づいてスコアカードを作成する
- 最終的な推奨事項を提供する ```
- [Continue]でEnterを押してAll toolsを使用
- モデルにSonnetを選択
- Enterを押してランダムに色を選択
ステップ5：構築したものを確認（リフレクションチェックポイント）
VS Codeでファイルを開くには、ファイル > ファイルを開く…をクリックして.claude/agents/stock-picker.mdに移動します。
または、Claudeに依頼できます：
stock-pickerサブエージェントファイルを表示してください。
Claudeが.claude/agents/stock-picker.mdにあるサブエージェントファイルを表示します。次のことがわかります：
上部にYAMLフロントマターがあります：
---
name: stock-picker
description: 投資判断のために複数の企業を比較...
skills: generate-stock-reports
---
このフロントマター（---マーカー間のセクション）は、このサブエージェントをいつアクティブ化するか、どのスキルを使用できるかをClaude Codeに伝えます。
フロントマターの下にスコアリング方法論を含むシステムプロンプトがあります。
これらの主要な要素を確認：
- サブエージェントが
generate-stock-reportsスキルにアクセスできる - システムプロンプトがスコアリングの内訳を説明している
- サブエージェントの目標が明確：企業を比較して1つを推奨
ファイルを直接編集することも、Claudeに更新を依頼することもできます。
ステップ6：サブエージェントをテスト
実際の比較でサブエージェントをテストしましょう。次を入力してください：
AppleとGoogleではどちらが良い投資ですか？
サブエージェントは説明に基づいて自動的に起動します。
ステップ7：サブエージェントの動作を観察
サブエージェントが実行されると、次の流れが確認できます：
- スキルを2回呼び出す - Appleに対して1回、Googleに対して1回、generate-stock-reportsスキルを呼び出します
- データを収集 - 各スキル呼び出しがウェブを検索して企業レポートを生成します
- 企業をスコアリング - カテゴリ全体で40/30/20/10の重み付けを適用します
- 出力を生成 - 比較表と推奨事項を作成します
ウェブ検索が含まれるため、これには2〜3分かかる場合があります。
ステップ8：出力を確認
サブエージェントは次のような詳細な分析を返します：
- 個別の企業レポート - 各株式の製品更新、財務指標、経営陣の変更、アナリストのセンチメント
- 比較スコアカード - カテゴリ全体での数値スコア（財務健全性、成長可能性、経営品質、市場センチメント）
- 最終推奨事項 - どの株式に投資すべきか、その理由
サブエージェントは、これをターミナルに表示するか、完全なレポートを含むmarkdownファイルを生成する場合があります。スコアリングの重みや出力形式をカスタマイズするには、サブエージェントファイルを編集できます。
次のステップ
動作する株式選択サブエージェントができたので、これらの拡張を試してみてください：
- 3つ以上の株式を比較：「AAPL、MSFT、GOOGLを比較」して、サブエージェントがより多くのオプションをどのように処理するかを確認
- スコアリングの重みを調整：サブエージェントファイルを編集して40/30/20/10の内訳を変更（例：成長株を好む場合は成長を40%にする）
- 他のサブエージェントを作成：さまざまなタスク用に「code-reviewer」サブエージェント、「bug-hunter」サブエージェント、「document-writer」サブエージェントを構築
トラブルシューティング
- サブエージェントが起動しない：リクエストが企業の比較や投資判断について言及していることを確認してください。「stock-pickerサブエージェントを使用して比較…」と試してみてください
- スキルが見つからない：
.claude/skills/generate-stock-reports/SKILL.mdが存在することを確認してください。追加したばかりの場合は、Claude Codeを再起動してください - スコアが不完全：サブエージェントに「続けて」または「各カテゴリのスコアを詳しく説明して」と依頼してください
- サブエージェント作成エラー：
.claude/agents/フォルダが存在することを確認してください。Claude Codeが自動的に作成するはずです
ワークフロー概要
- サブエージェントは複数ステップのワークフローを自動化 - スキルを調整し、ロジックを適用し、意思決定を提供します
- スキルは再利用可能なツール - 1つのスキルを複数のサブエージェントがさまざまな目標のために使用できます
- システムプロンプトが動作を定義 - 明確な指示とスコアリング基準により、サブエージェントを信頼できるものにします
- サブエージェントはフォーカスを維持 - 各サブエージェントには、明確な単一の目的（株式選択、コードレビューなど）があります
- 構成がスケールする - 連携するスキルとサブエージェントのライブラリを構築できます
Steven Geが2025年12月14日に作成。