meta-agent-creator

カスタムエージェントの作成

概要

サブエージェントは、YAML フロントマター付きの Markdown ファイルとして定義される、専門的な AI アシスタントです。各サブエージェントは、カスタムシステムプロンプト、特定のツールへのアクセス権、独立した権限を備えた専用のコンテキストウィンドウで実行されます。タスクの内容がサブエージェントの説明に一致すると、親の会話から自動的にタスクが委任されます。これにより、メインのコンテキストを維持しながら制約を適用できます。

使用する場合： 大量の操作（テスト、ログなど）の分離、レビュー担当者への読み取り専用アクセスの適用、単純なタスクの低コストなモデルへの振り分け、並行調査の実行、再利用可能なチームのワークフローの作成。

使用しない場合： 頻繁なやり取りが必要なタスク、迅速で対象を絞った変更、ネストされた委任が必要なワークフロー（サブエージェントはサブエージェントを起動できません）、最新のコンテキスト収集にコストがかかる、レイテンシに敏感な操作。

クイックリファレンス

パターン	設定	要点
ファイルの場所（プロジェクト）	.claude/agents/name.md	バージョン管理で共有。優先度 2
ファイルの場所（ユーザー）	~/.claude/agents/name.md	すべてのプロジェクトで使用可能。優先度 3
必須フィールド	name, description	必須なのはこの 2 つのフィールドのみ
ツールの制限	tools: Read, Grep, Glob	許可リスト。省略した場合はすべてを継承
ツールの拒否	disallowedTools: Write, Edit	拒否リスト。継承したセットから削除
モデルの選択	model: haiku	選択肢：sonnet、opus、haiku、inherit（デフォルト）
権限モード	permissionMode: dontAsk	権限の確認プロンプトの動作を制御
スキルの事前読み込み	skills: [auth, api-patterns]	起動時に注入。親からは継承されない
ライフサイクルフック	hooks: { PreToolUse: [...] }	条件に応じてツールの使用を検証またはブロック
CLI で定義するエージェント	claude --agents '{...}'	セッション内のみ有効。最優先。JSON 形式
対話形式での作成	/agents コマンド	Claude による生成を含むガイド付きセットアップ
積極的なトリガー	"Use proactively after..."	自動委任のため、説明に含める

よくある間違い

間違い	正しいパターン
単純なチェックリストのレビューに opus を使う	読み取り専用のレビューやスタイルチェックには haiku を使う
システムプロンプトに出力形式を指定しない	一貫した結果を得るため、構造化された出力テンプレートを含める
すべてのツールが必要なのに、ツールを明示的に列挙する	tools フィールドを省略し、MCP を含むすべてのツールを継承する
親の会話からスキルが継承されると思い込む	skills フィールドにスキルを明示的に列挙する
トリガーを含めず、説明が汎用的になる	「必要に応じて積極的に使用」などの具体的なトリガーフレーズを含める
1 つのエージェントに責任を負わせすぎる	それぞれ明確な目的を 1 つ持つ、特化したエージェントを設計する
注意せずに bypassPermissions を使用する	より安全な自動化のため、acceptEdits または dontAsk を優先する
深くネストされたエージェントのワークフローを作成する	メインの会話からサブエージェントを連鎖させる。ネストはサポートされていません

委任

• エージェントパターンの検出：Explore エージェントを使用して、.claude/agents/ に既存のエージェントがあるか確認します
• 対話形式での作成：/agents コマンドを使用して、Claude による生成を利用したガイド付きセットアップを行います
• エージェントファイルのコードレビュー：Task エージェントを使用して、システムプロンプトと設定を検証します

参考資料

• エージェントの設定：YAML フィールド、ファイルの場所、優先順位
• ツールの選択：アクセスパターン、一般的な組み合わせ、モデルガイド
• テンプレート：一般的なワークフローですぐに使えるエージェントパターン