create-subagents

サブエージェントは、役割を特化させ、ツールへのアクセスを制限した、隔離されたコンテキストで動作する Claude のインスタンスです。このスキルでは、効果的なサブエージェントの作成方法、優れたシステムプロンプトの作成方法、ツールアクセスの設定方法、Task ツールを使ったマルチエージェントワークフローのオーケストレーション方法を学びます。

サブエージェントを使うと、複雑なタスクを専門のエージェントに委任できます。サブエージェントはユーザーとのやり取りなしに自律的に動作し、最終的な出力をメインの会話に返します。

<quick_start>

1. /agents コマンドを実行します
2. 「Create New Agent」を選択します
3. プロジェクトレベル（.claude/agents/）またはユーザーレベル（~/.claude/agents/）を選択します
4. サブエージェントを定義します：
   • name：小文字とハイフンを使用します
   • description：このサブエージェントを使用するのはどのような場合ですか？
   • tools：省略可能なカンマ区切りのリスト（省略すると、すべてのツールを継承します）
   • model：省略可能（sonnet、opus、haiku、または inherit）
5. システムプロンプト（サブエージェントへの指示）を作成します

```markdown --- name: code-reviewer description: Expert code reviewer. Use proactively after code changes to review for quality, security, and best practices. tools: Read, Grep, Glob, Bash model: sonnet --- You are a senior code reviewer focused on quality, security, and best practices.

<focus_areas>

• Code quality and maintainability
• Security vulnerabilities
• Performance issues
• Best practices adherence </focus_areas>

<output_format> Provide specific, actionable feedback with file:line references. </output_format>

</example>
</quick_start>

<file_structure>
| 種類 | 場所 | 適用範囲 | 優先度 |
|------|----------|-------|----------|
| **プロジェクト** | `.claude/agents/` | 現在のプロジェクトのみ | 最高 |
| **ユーザー** | `~/.claude/agents/` | すべてのプロジェクト | 低 |
| **プラグイン** | プラグインの `agents/` ディレクトリ | すべてのプロジェクト | 最低 |

名前が重複する場合、プロジェクトレベルのサブエージェントがユーザーレベルのものより優先されます。
</file_structure>

<configuration>
<field name="name">
- 小文字とハイフンのみを使用します
- 一意である必要があります
</field>

<field name="description">
- 目的を自然言語で説明します
- Claude がこのサブエージェントを呼び出すべき状況を含めます
- サブエージェントの自動選択に使用されます
</field>

<field name="tools">
- カンマ区切りのリスト：`Read, Write, Edit, Bash, Grep`
- 省略した場合：メインスレッドからすべてのツールを継承します
- `/agents` インターフェースを使って、利用可能なすべてのツールを確認します
</field>

<field name="model">
- `sonnet`、`opus`、`haiku`、または `inherit`
- `inherit`：メインの会話と同じモデルを使用します
- 省略した場合：設定済みのサブエージェントモデル（通常は sonnet）がデフォルトで使用されます
</field>
</configuration>

<execution_model>
<critical_constraint>
**サブエージェントは、ユーザーとやり取りできないブラックボックスです。**

サブエージェントは隔離されたコンテキストで動作し、最終的な出力をメインの会話に返します。サブエージェントは次のことができます：
- ✅ Read、Write、Edit、Bash、Grep、Glob などのツールを使用できます
- ✅ MCP サーバーやその他の非対話型ツールにアクセスできます
- ❌ **AskUserQuestion や、ユーザーとのやり取りを必要とするツールは使用できません**
- ❌ **選択肢を提示したり、ユーザーの入力を待ったりすることはできません**
- ❌ **ユーザーにはサブエージェントの途中経過が表示されません**

メインの会話に表示されるのは、サブエージェントの最終的な報告または出力のみです。
</critical_constraint>

<workflow_design>
**サブエージェントを使ったワークフローの設計：**

次の用途には**メインチャット**を使用します：
- ユーザーから要件を収集する（AskUserQuestion）
- ユーザーに選択肢や決定事項を提示する
- ユーザーの確認や入力が必要なタスク
- ユーザーが進捗を確認する必要のある作業

次の用途には**サブエージェント**を使用します：
- 調査タスク（API ドキュメントの検索、コード分析）
- 事前に定義された要件に基づくコード生成
- 分析と報告（セキュリティレビュー、テストカバレッジ）
- ユーザーとのやり取りを必要としない、コンテキスト負荷の高い処理

**ワークフローのパターン例：**

Main Chat: Ask user for requirements (AskUserQuestion) ↓ Subagent: Research API and create documentation (no user interaction) ↓ Main Chat: Review research with user, confirm approach ↓ Subagent: Generate code based on confirmed plan ↓ Main Chat: Present results, handle testing/deployment

</workflow_design>
</execution_model>

<system_prompt_guidelines>
<principle name="be_specific">
サブエージェントの役割、能力、制約を明確に定義します。
</principle>

<principle name="use_pure_xml_structure">
システムプロンプトは純粋な XML タグで構成します。本文からすべての Markdown 見出しを削除します。

```markdown
---
name: security-reviewer
description: Reviews code for security vulnerabilities
tools: Read, Grep, Glob, Bash
model: sonnet
---

<role>
You are a senior code reviewer specializing in security.
</role>

<focus_areas>
- SQL injection vulnerabilities
- XSS attack vectors
- Authentication/authorization issues
- Sensitive data exposure
</focus_areas>

<workflow>
1. Read the modified files
2. Identify security risks
3. Provide specific remediation steps
4. Rate severity (Critical/High/Medium/Low)
</workflow>

指示は特定のタスク領域に合わせて調整します。汎用的な「ヘルパー」サブエージェントは作成しないでください。

❌ 悪い例：「あなたは、コードを手伝う親切なアシスタントです」 ✅ 良い例：「あなたは React コンポーネントのリファクタリングを専門とするエージェントです。コンポーネントを分析し、フックのベストプラクティス、パフォーマンス上のアンチパターン、アクセシビリティの問題を確認します。」 </system_prompt_guidelines> <subagent_xml_structure> Subagent.md ファイルは Claude のみが使用するシステムプロンプトです。スキルやスラッシュコマンドと同様に、最適なパースとトークン効率のために純粋な XML 構造を使用する必要があります。

<recommended_tags> サブエージェント構造の一般的なタグ:

• <role> - サブエージェントが何者で、何を行うか
• <constraints> - 厳格なルール (NEVER/MUST/ALWAYS)
• <focus_areas> - 何を優先するか
• <workflow> - ステップバイステップのプロセス
• <output_format> - 成果物をどのように構造化するか
• <success_criteria> - 完了基準
• <validation> - 作業をどのように検証するか </recommended_tags>

<intelligence_rules> シンプルなサブエージェント (単一の集中的なタスク):

• 最低限、role + constraints + workflow を使用します
• 例: code-reviewer、test-runner

中規模のサブエージェント (複数ステップのプロセス):

• workflow ステップ、output_format、success_criteria を追加します
• 例: api-researcher、documentation-generator

複雑なサブエージェント (調査 + 生成 + 検証):

• validation、examples を含め、必要に応じてすべてのタグを追加します
• 例: mcp-api-researcher、comprehensive-auditor </intelligence_rules>

<critical_rule> サブエージェント本文からすべての Markdown 見出し (##、###) を削除してください。 代わりにセマンティックな XML タグを使用します。

コンテンツ内の Markdown フォーマット (太字、斜体、リスト、コードブロック、リンク) は維持してください。

XML 構造の原則とトークン効率の詳細については、@skills/create-agent-skills/references/use-xml-tags.md を参照してください。同じ原則がサブエージェントにも当てはまります。 </critical_rule> </subagent_xml_structure>

Claude は、`description` フィールドに基づいて、現在のタスクに一致する場合にサブエージェントを自動的に選択します。 サブエージェントを明示的に呼び出すことができます:

> Use the code-reviewer subagent to check my recent changes

> Have the test-writer subagent create tests for the new API endpoints

`/agents` を実行すると、以下の操作を行うためのインタラクティブなインターフェイスが起動します: - 利用可能なすべてのサブエージェントを表示する - 新しいサブエージェントを作成する - 既存のサブエージェントを編集する - カスタムサブエージェントを削除する

<manual_editing> サブエージェントのファイルを直接編集することもできます:

• プロジェクト: .claude/agents/subagent-name.md
• ユーザー: ~/.claude/agents/subagent-name.md </manual_editing>

**主要なリファレンス**:

サブエージェントの使用と設定: references/subagents.md

• ファイル形式と設定
• モデル選択 (Sonnet 4.5 + Haiku 4.5 のオーケストレーション)
• ツールのセキュリティと最小権限
• プロンプトキャッシュの最適化
• 完全な例

効果的なプロンプトの作成: references/writing-subagent-prompts.md

• 中核となる原則と XML 構造
• ルーティングのための description フィールドの最適化
• 複雑な推論のための拡張思考
• セキュリティ制約と強い法助動詞
• 成功基準の定義

高度なトピック:

評価とテスト: references/evaluation-and-testing.md

• 評価指標 (タスク完了、ツールの正確性、堅牢性)
• テスト戦略 (オフライン、シミュレーション、オンライン監視)
• 評価駆動開発
• カスタム基準のための G-Eval

エラー処理と復旧: references/error-handling-and-recovery.md

• 一般的な障害モードと原因
• 復旧戦略 (グレースフルデグラデーション、リトライ、サーキットブレーカー)
• 構造化されたコミュニケーションとオブザーバビリティ
• 避けるべきアンチパターン

コンテキスト管理: references/context-management.md

• メモリアーキテクチャ (STM、LTM、ワーキングメモリ)
• コンテキスト戦略 (要約、スライディングウィンドウ、スクラッチパッド)
• 長時間実行タスクの管理
• プロンプトキャッシュとの相互作用

オーケストレーションパターン: references/orchestration-patterns.md

• 順次、並列、階層、コーディネーターの各パターン
• コスト/パフォーマンスのための Sonnet + Haiku オーケストレーション
• マルチエージェントの連携
• パターン選択のガイダンス デバッグとトラブルシューティング: references/debugging-agents.md
• ログ記録、トレーシング、相関 ID
• よくある障害の種類（ハルシネーション、フォーマットエラー、ツールの誤用）
• 診断手順
• 継続的なモニタリング

<success_criteria> 適切に構成されたサブエージェントには、以下が備わっています。

• 有効な YAML frontmatter（name がファイル名と一致し、description にトリガーが含まれている）
• システムプロンプトにおける明確な役割の定義
• 適切なツール制限（最小権限）
• 役割、アプローチ、制約を含む XML 構造のシステムプロンプト
• 自動ルーティング向けに最適化された description フィールド
• 代表的なタスクでのテストに成功している
• タスクの複雑さに応じた適切なモデル選択（推論には Sonnet、単純なタスクには Haiku） </success_criteria>