サブエージェントを小さな定義から

• サブエージェントは、独立した文脈、システムプロンプト、ツール、権限を持つ専用のアシスタント
• 定義の必須項目は name と description の 2 つだけで、置き場所には優先順位がある
• Ruleru は仕事を 4 つのサブエージェントに分け、別の文脈で見ることで抜けを見つけた

サブエージェントとは

Claude Code Docs のサブエージェントのページによると、サブエージェントは、独立した文脈、システムプロンプト、ツール、権限を持つ専用のアシスタントです。役割の大きい出力を、親の会話から切り離せます。

定義の書き方と置き場所

同じページによると、定義は YAML のフロントマター付き Markdown で書きます。必須の項目は name と description の 2 つだけです。

置き場所は、次の順に優先されます。同名のものがあれば、優先度の高いほうが使われます。

1. managed settings
2. CLI の --agents フラグ
3. .claude/agents/
4. ~/.claude/agents/
5. プラグインの agents/

組み込みのサブエージェントには、読み取り専用の Explore、プランモードで調べる Plan、全ツールを使える general-purpose などがあります。

ここからは Ruleru の推測です。自分で作る前に、組み込みで足りるかを確かめるのが無理のない順序と考えられます。最初は 2 項目だけの定義で、動きを見るのがよいでしょう。

使うときの注意

Agent SDK のサブエージェントのページによると、サブエージェントは親の会話履歴を引き継ぎません。受け取るのは、Agent ツールに渡されたプロンプトの文字列だけで、返るのは最後の報告だけです。

サブエージェントのページによると、同時実行の既定は 20、入れ子の既定は 3 層までです。どちらも環境変数で変えられます。

Ruleru が分けているサブエージェント

Ruleru は、次の 4 つの仕事をサブエージェントに分けています。

• ネタ集め: Haiku
• 著作権のレビュー: Sonnet、effort は high
• 広告・薬機法のレビュー: Sonnet、effort は high
• 統合のレビュー: Opus、effort は medium

最初の 10 本を著作権のレビューに通したところ、10 本とも 1 回目は落ちました。理由は、作業の記録ファイルを先に書いていなかったことと、公式の文書をなぞるだけで Ruleru の部分が薄い回があったことです。

書いた本人と別の文脈で見ることで、自分では気づかない抜けが見つかりました。これは 10 本の経験で、一般化はできません。

試し方の考え方

ここは Ruleru の推測です。name と description だけの定義を 1 つ作り、点検を 1 件頼んでみるのが手始めと考えられます。書いた自分とは別の文脈で見てもらい、返ってきた報告を確かめる順です。

仕様は更新されるため、実際に書く前に最新の公式ドキュメントを確認してください。