# サブエージェント (/ja/docs/verdent-manager/configuration/subagents)

> メインエージェントが必要に応じて呼び出せる専門エキスパートエージェント



サブエージェントとは、メインエージェント（Worker）がタスク実行中にいつでも呼び出せる専門「エキスパート」です。各サブエージェントは独自の専門分野と専用プロンプトを持ち、異なるモデルで動作させることもできます。チャットでは `@SubagentName` と入力するだけで参加して手伝ってくれます。グループチャットで同僚をタグ付けするのと同じ感覚です。

***

## 組み込みサブエージェント [#組み込みサブエージェント]

Verdent には、ソフトウェア開発で最もよくあるニーズをカバーする 6 つのサブエージェントが標準で付属しています。

| 名前                      | デフォルトモデル                        | 得意なこと                                                 |
| ----------------------- | ------------------------------- | ----------------------------------------------------- |
| **General**             | メインエージェントに従う                    | 複雑な問題、コード検索、複数ステップのタスクに対応する汎用リサーチエージェント。ほぼ何でも手伝えます    |
| **Fast Context**        | Gemini 3 Flash                  | コードの素早い特定とコンテキスト証拠の収集が得意。コードベースのインデックス作成を専門とし、非常に高速です |
| **Verifier**            | Sonnet 4.6                      | 高速なコードレビュー。変更を加えたあとにタグ付けすると、明らかな問題を見つけます              |
| **Verdent Helper**      | Haiku 4.5                       | Verdent の使い方アシスタント。Verdent の動作について何でも聞けます             |
| **Multi-Model Planner** | Gemini 3.1 Pro、Opus 4.6、GPT-5.4 | 複数のモデル（Claude、GPT、Gemini）を使ってプランを生成し、その出力をマージします      |
| **Reviewer**            | Gemini 3.1 Pro、Opus 4.6、GPT-5.4 | 完全なコードレビュー。ロジックエラー、エッジケース、隠れたリスクをチェックします              |

<Note>
  2 つのサブエージェントは特別です。**Multi-Model Planner** と **Reviewer** は 2〜3 個のモデルを並列で実行します。各モデルが独立して考え、それぞれの出力を生成し、その結果が統合されます。それ以外のサブエージェントはすべて単一モデルです。
</Note>

***

## サブエージェントの使い方 [#サブエージェントの使い方]

どの会話でも `@` と入力するとサブエージェント選択メニューが開きます（あいまい検索に対応）。使いたいサブエージェントを選択すると、現在のコンテキストを引き継ぎます。

**例:**

* 複雑な認証ロジックを書いたあと: `@Reviewer please review this` → Reviewer がセキュリティ、ロジック、エッジケースの観点からチェックします。
* 難しいアーキテクチャ上の判断について: `@Multi-Model Planner` → 複数のモデルが解決策を提案し、その中から最良のものを選べます。
* コーディング後に手早く `@Verifier` を実行 → 基本的な検証なら完全なテストスイートを実行するより高速です。

***

## カスタムサブエージェント [#カスタムサブエージェント]

組み込みのサブエージェントはほとんどのニーズをカバーしますが、プロジェクトに合わせた専門家がほしいこともあります。その場合は自分で作成できます。

### 保存場所 [#保存場所]

カスタムサブエージェントは、次の場所に Markdown ファイルとして保存します。

```
~/.verdent/subagents/
```

整理のためにサブディレクトリは最大 5 階層までサポートしています。

### ファイル形式 [#ファイル形式]

各サブエージェントは、YAML フロントマター付きの Markdown ファイルです。

```markdown
---
name: SQL-Expert
description: Specializes in SQL optimization and database design, good at analyzing slow queries and indexing strategies
color: blue
model: claude-sonnet-4-6
---

You are a senior database expert focused on PostgreSQL performance optimization.
When users provide SQL queries, you should:
1. Analyze the query execution plan
2. Identify performance bottlenecks (full table scans, missing indexes, etc.)
3. Provide concrete optimization suggestions and rewritten SQL
...
```

### 重要なポイント [#重要なポイント]

* **名前:** 使えるのは英字、数字、ハイフンのみです（例: `SQL-Expert`、`MyAgent123`）。スペースや非 ASCII 文字は使えません。
* **色:** `dark-green`、`light-green`、`red-orange`、`amber`、`cyan`、`blue`、`pink`、`purple`、`verdent` のいずれか。視覚的に識別しやすくなります。
* **ホットリロード:** `.md` ファイルを保存するとすぐに反映されます。Verdent を再起動する必要はありません。

***

## 設定でのサブエージェント管理 [#設定でのサブエージェント管理]

サブエージェントの管理はすべて **Settings → Subagents** で行います。

| 操作            | 説明                                                                              |
| ------------- | ------------------------------------------------------------------------------- |
| **一覧表示**      | すべてのサブエージェントがカードとして表示されます。組み込みのものには「Built-in」ラベルが付き、プラグインベースのものにはプラグイン名が表示されます。 |
| **有効化 / 無効化** | 他に影響を与えずに各サブエージェントを個別にオン・オフできます。                                                |
| **新規作成**      | **Add Subagent** を選択し、Identifier（一意の名前）、Model、Description、Prompt を入力します。        |
| **編集**        | カードにカーソルを合わせると編集できます。組み込みサブエージェントは Model と Description のみ変更できます。                |
| **複製**        | 任意のカスタムサブエージェントをコピーします（複製は有効化するまでデフォルトで無効です）。                                   |
| **削除**        | カスタムサブエージェントは削除できます（確認あり）。組み込みのものは削除できません。                                      |

### モデル選択の違い [#モデル選択の違い]

* **Multi-Model Planner** と **Reviewer** は複数モデルの選択（同時に 2〜3 個）に対応しています。
* その他のサブエージェントは単一モデルの選択を使います。
* **General** には特別なオプションがあり、メインエージェントのモデルを自動的に追従できるため、別途設定を管理する必要がありません。

***

## ユースケース [#ユースケース]

### コードレビュー [#コードレビュー]

複雑なロジックを実装したあと、`@Reviewer` をタグ付けします。正確性、エッジケース、潜在的なバグをチェックし、1 行ずつ手作業で確認する手間を省きます。

### 多角的なアーキテクチャ設計 [#多角的なアーキテクチャ設計]

重要な判断（マイクロサービスの採用、データベースの選択など）には `@Multi-Model Planner` を使って、複数のトップモデルから独立した提案を得て、判断のリスクを減らします。

### 高速な検証 [#高速な検証]

コード変更後、`@Verifier` が構文、型、基本的な問題を素早くチェックします。完全なテストスイートより高速で、チェックしないよりはるかに信頼できます。

### カスタムドメインエキスパート [#カスタムドメインエキスパート]

プロジェクトに合わせたサブエージェントを作成します。

* スキーマとクエリパターンを把握した SQL 最適化エキスパート
* ESLint とデザインシステムのルールを徹底するフロントエンドコード規約のガーディアン
* 技術的な内容を明快で読みやすい文章に整えるドキュメントアシスタント

***

## 注意事項 [#注意事項]

* カスタムサブエージェントを有効化するには、有効なモデルを設定する必要があります。BYOK を使っていてキーの期限が切れたりモデルが廃止されたりすると、そのサブエージェントは自動的に無効になります。
* 組み込みサブエージェントのモデルは変更できますが、デフォルトはチューニング済みのため、変更するとパフォーマンスが低下する可能性があります。
* **説明（Description）は重要です:** これはメインエージェントのコンテキストに注入され、サブエージェントを呼び出すタイミングに影響します。説明が適切なほど、ルーティングが賢くなります。
* サブエージェント同士は互いに呼び出せません。呼び出せるのはメインエージェント（Worker）のみで、これ以上深いネストはできません。