subagentlisted

# subagent Claude Code の **subagent** = `Agent` tool / `Task` tool で起動できる子エージェント。 「メインの context を汚さず、独立した context window で作業させる」のが本質。 親には **結果サマリのみ** が返るので、大量ログ・grep 結果・ファイル中身が main を圧迫しない。 この skill は「subagent を呼ぶべきか / どう呼ぶか / どう書くか」の判断 skill。 --- ## いつ subagent を使うか ### 強く推奨 (積極的に並列化) - **広範な調査** — 「この機能どこで使われてる？」「依存関係は？」「過去の実装は？」など 3 query 以上必要なもの → `Explore` - **複数の独立タスク** — 同時に違うファイル/領域を触る作業 → 並列 `general-purpose` × N - **別視点の検証** — レビュー / 第二意見 / 設計レビュー → `Plan` や独立 `general-purpose` - **ノイズの多い結果** — log 解析・大量の grep 結果・長い transcript の要約 → `general-purpose` ### 不要 (直接やった方が速い) - 場所が分かっている 1 ファイルを読む → `Read` - 既知 symbol の grep → `Grep` - 1 〜 2 query で済む確認 - 既に context にある情報を再確認するだけ ### 微妙 (判断ポイント) - 中規模調査 (3〜5 query) → 自分でやって良いが、結果が長文ログを伴うなら subagent - ユーザーへ即返答が要る対話 → subagent は遅延が出るので避ける --- ## ビルトイン subagent の使い分け | subagent_type | 用途 | 強み | 注意 | |---|---|---|---| | `Explore` | コード探索専用 (read-only) | 速い・探索に特化 | 全文読まない (excerpt のみ) → 設計レビュー不可 | | `general-purpose` | 何でも屋 | フル tool 利用可・編集も可 | 重い・トークン消費 | | `Plan` | 実装計画立案 | アーキ視点で plan を返す | 編集はしない | | `statusline-setup` | ステータスライン設定専用 | — | — | | `claude-code-guide` | Claude Code 公式仕様の Q&A | docs / web 参照 | 限定用途 | | `codex:rescue` | 別 LLM (GPT-5 系) で裏取り | 視点の多様化 | コスト高 | **迷ったら**: 探索 = `Explore` / 計画 = `Plan` / 編集を伴う作業 = `general-purpose`。 --- ## 起動方法 (`Agent` tool) ``` Agent({ description: "Branch ship-readiness audit", // 3〜5 語 subagent_type: "general-purpose", // 省略時は general-purpose pro