サブエージェントとは何か？なぜ必要なのか？
サブエージェントの3つのメリット
コンテキスト隔離
各サブエージェントが独自のコンテキストウィンドウを持ち、探索や調査の中間出力がメインの会話を圧迫しない。親エージェントは最終要約だけ受け取り、判断に集中できる。
並列実行
複数のサブエージェントを同時に動作させることができ、フォアグラウンド・バックグラウンドモードで即座に制御が戻る。コードレビューとテスト実行の並行処理など、現実的な時間で完了。
コスト効率
Exploreなど高速で安いモデルを設定可能。トークン消費を抑え、導入コスト以上の生産性向上が得られる。
エージェントの限界とサブエージェントの誕生
室谷代表取締役エージェントが複雑なタスクをやろうとすると、すぐコンテキスト上限にぶつかるんですよね。それでタスクが途中で止まったり、品質が落ちたりする。
テキトー教師DotAI 認定講師たしかに、最初は「全部このエージェントに任せればいい」と思うんですけど、長い会話の中でどんどん発散していくんですよね。
室谷代表取締役そこでCursorが導入したのがサブエージェントです。親エージェントがタスクを細かく分割して、独立したAIに委任する仕組み。
これでコンテキスト問題を根本的に解決してます。
これでコンテキスト問題を根本的に解決してます。
コンテキスト隔離による効率化
テキトー教師DotAI 認定講師各サブエージェントは独自のコンテキストウィンドウを持つ、と。つまり、探索や調査の中間出力がメインの会話を圧迫しないってことですよね。
室谷代表取締役そうです。例えばコードベース探索を担当するExploreサブエージェントは、大量の出力を生成しますが、親には最終要約だけ返す。
結果的にメインのコンテキストを節約できる。
結果的にメインのコンテキストを節約できる。
テキトー教師DotAI 認定講師それで、親エージェントは判断に集中できるんですね。これ、現場でよく聞く「エージェントが途中で迷子になる」問題の解決策だと思います。
室谷代表取締役コスト面でも効きます。Exploreは高速で安いモデルを使う設定になってるので、トークン消費を抑えられる。
時給換算で考えると馬鹿にならない差です。
時給換算で考えると馬鹿にならない差です。
並列実行で実現する高速タスク処理
テキトー教師DotAI 認定講師もう一つの大きなメリットは並列実行ですよね。複数のサブエージェントを同時に動かせるので、処理速度が段違いになる。
室谷代表取締役そう。フォアグラウンドとバックグラウンドのモードがあって、バックグラウンドに投げれば即座に制御が戻ってくる。
コードレビューとテスト実行を同時にやらせるとか、現実的な時間で終わります。
コードレビューとテスト実行を同時にやらせるとか、現実的な時間で終わります。
テキトー教師DotAI 認定講師最初に戸惑うのが「どのタイミングでサブエージェントが動くのか」という点ですが、Agentが必要と判断したら自動で起動してくれます。
室谷代表取締役明示的にカスタムサブエージェントを定義することもできるので、チームの開発フローに合わせた並列処理を組める。ROIで見ると、導入コスト以上に生産性向上が得られるケースが多いです。
標準搭載のサブエージェント3種の役割と使いどころ
標準搭載のサブエージェント3種の役割と使いどころ
Explore
- コードベース探索・分析の専用エージェント
- 高速モデルで並列検索
- 大量検索でもメインのコンテキストを節約
- リファクタ前のコードベース全体調査に最適
Bash
- シェルコマンド連続実行を隔離
- フォアグラウンド/バックグラウンド処理可能
- 冗長なビルドログやテスト出力を吸収
- 安いモデルを使いコスト節約
Explore：コードベース探索の自動化
室谷代表取締役まず Explore。これはコードベースを検索・分析する専用のサブエージェントです。
デフォルトで高速なモデルが割り当てられていて、並列で複数の検索を走らせるんですよね。
デフォルトで高速なモデルが割り当てられていて、並列で複数の検索を走らせるんですよね。
テキトー教師DotAI 認定講師たしかに。あれをメインの会話でやると、大量の中間出力でコンテキストがすぐパンクしますからね。
サブエージェントに隔離されることで、メインは整理されたサマリだけを受け取れる。
サブエージェントに隔離されることで、メインは整理されたサマリだけを受け取れる。
室谷代表取締役MYUUU の現場でも、大規模リファクタの前にコードベース全体を調べさせるときに使ってます。普通の会話だとすぐ200kトークン制限に引っかかるんですが、Explore だとその心配がない。
テキトー教師DotAI 認定講師最初に難しいのは「サブエージェントが裏で勝手に動いてる」という意識を持てるかどうかですね。あ、今の検索、サブエージェントがやってたんだと気づくと、使い方が変わります。
Bash：シェルコマンド実行の効率化
室谷代表取締役次は Bash。シェルコマンドを連続実行するためのサブエージェントで、出力が冗長になりがちな処理を隔離します。
フォアグラウンドで逐次処理も、バックグラウンドで並列実行もできる。
フォアグラウンドで逐次処理も、バックグラウンドで並列実行もできる。
テキトー教師DotAI 認定講師これ、地味に効くんですよね。ビルドログとかテスト出力って往々にして長いですが、Bash サブエージェントがそれを吸収してくれるから、メインエージェントは「次に何をするか」に集中できる。
室谷代表取締役コスト面でも有利です。Bash サブエージェントには高速で安いモデルが使われるので、トークン消費の大きいコマンド出力を安いモデルで処理できる。
時給換算したら馬鹿にならない節約です。
時給換算したら馬鹿にならない節約です。
テキトー教師DotAI 認定講師うん。あと、初心者は「ターミナルで何かやってる」という表示を見て不安になりがちですが、あれは Bash サブエージェントが動いてるサインで、正常な動作なんです。
Browser：ブラウザ操作と情報収集
室谷代表取締役3つ目が Browser。ブラウザを操作して情報収集するサブエージェントです。
MCP ツール経由でブラウザを制御し、ページ遷移・クリック・スクリーンショットまでやります。
MCP ツール経由でブラウザを制御し、ページ遷移・クリック・スクリーンショットまでやります。
テキトー教師DotAI 認定講師これも、ブラウザの DOM やスクリーンショットってノイズが多いので、Browser サブエージェントが要約してからメインに返してくれる。生の HTML が会話に流れ込まないのは快適です。
室谷代表取締役シリコンバレーのスタートアップだと、ドキュメントを読ませて実装に反映させるという使い方が定着してます。あの Browser サブエージェントがないと、手動で調べてコピペする手間が発生する。
テキトー教師DotAI 認定講師最初は「え、エージェントがブラウザ開くの？」と戸惑う人もいますが、慣れると「調べて反映」を一貫して任せられるので、開発速度が確実に上がります。
カスタムサブエージェントの作成方法
フォアグラウンドとバックグラウンドの使い分け
フォアグラウンド
- 結果が返るまでブロック
- 編集が必要な作業に安全
- 途中で止めて確認可能
バックグラウンド
- 非同期で実行
- 調査系に適している
- 並列実行で生産性向上 (例:コードレビュー)
.cursor/agents/ の構成ルール
室谷代表取締役サブエージェント、自分で作れるようになったんですよね。.cursor/agents/ にマークダウンファイルを置くだけで定義できる。
MYUUU の現場でも、テスト用のエージェントとか作ってます。
MYUUU の現場でも、テスト用のエージェントとか作ってます。
テキトー教師DotAI 認定講師たしかに。最初に戸惑うのが「どのファイルがどの役割か」ってところですね。
.cursor/agents/ 以下に *.md を置けば自動で認識されるので、まずは1つファイルを作ってみると理解しやすいです。
.cursor/agents/ 以下に *.md を置けば自動で認識されるので、まずは1つファイルを作ってみると理解しやすいです。
室谷代表取締役あと、rules と違ってサブエージェントは明示的に呼ばれるまで動かない。そこを理解しないと混乱する人もいるみたいです。
プロンプト・モデル・ツールアクセスの設定
テキトー教師DotAI 認定講師設定項目はプロンプト、モデル、ツールアクセス。これが自由に変更できるのが大きい。
例えばバグ調査専用ならモデルコストを抑えて read-only にするとか。
例えばバグ調査専用ならモデルコストを抑えて read-only にするとか。
室谷代表取締役コストの話で言うと、Explore のデフォルトが速いモデルになってるのは理にかなってますね。安いモデルで10本並列検索させて、結果だけ親に返す。
時給換算するとバカにならないです。
時給換算するとバカにならないです。
テキトー教師DotAI 認定講師自作するときも、タスクの重要度に応じてモデルを切り替えるといい。あとツールアクセスはデフォルトで親のツールを継承するけど、readonly に制限することもできます。
フォアグラウンドとバックグラウンドの使い分け
室谷代表取締役モードの選択も設計ポイントですね。フォアグラウンドは結果が返ってくるまでブロック、バックグラウンドは非同期で動く。
好みが分かれるところなんですけど…
好みが分かれるところなんですけど…
テキトー教師DotAI 認定講師僕の感覚だと、調査系はバックグラウンドで放っておいて、編集が必要な作業はフォアグラウンドのほうが安全です。途中で止めて確認したいケースもあるので。
室谷代表取締役うちでも、コードレビューのサブエージェントはバックグラウンドで並列に回してます。メインの作業を止めずに済むので生産性が上がりました。
テキトー教師DotAI 認定講師組み込みのサブエージェント（Explore/Bash/Browser）は自動で動くので、まずはそれを体験してから自作に進むのがスムーズですね。
サブエージェント vs スキル：使い分けのポイント
サブエージェント vs スキル
サブエージェント
- 独立したAIワーカー
- 処理を完全に任せて独立稼働
- 結果を親に返すだけ
- 例: 単体テストを全部書く
- 並列実行させたい時に選択
スキル
- How toガイド
- 手順を踏んで作業を進める
- エージェント自身が手順を踏む
- 例: コードレビューのチェックリスト
- 手順を教えたいだけの時に選択
スキル（SKILL.md）の特徴とサブエージェントとの違い
室谷代表取締役スキルってSKILL.mdに書く手順書で、エージェントがその場で見つけて使うもの。サブエージェントは完全に独立したAIエージェントを立ち上げるという違いがありますよね。
テキトー教師DotAI 認定講師そうなんです。最初に戸惑うのが、どっちも「タスクを細分化する」ように見えるところ。
でもスキルはあくまで「How toガイド」で、サブエージェントは実際に処理を任せるワーカーなんですよ。
でもスキルはあくまで「How toガイド」で、サブエージェントは実際に処理を任せるワーカーなんですよ。
室谷代表取締役現場感覚で言うと、スキルはエージェントに「この手順を踏め」と指示するためのもの。サブエージェントは「この処理はお前に任せた」で独立稼働する。
動的コンテキスト検出と宣言的ルールの使い分け
テキトー教師DotAI 認定講師rules（ルール）は常時適用される宣言的な設定。スキルは動的に検出されるから、タスクに応じてエージェントが「あ、これスキル使えるな」と判断するんです。
室谷代表取締役そこが肝心。ルールに全部書くとコンテキストが肥大化するし、逆にスキルだけだと基本動作がぶれる。
コスト的にも、頻繁に使わない手順をスキルにしておけば、必要なときだけ呼ばれるので効率的。
コスト的にも、頻繁に使わない手順をスキルにしておけば、必要なときだけ呼ばれるので効率的。
テキトー教師DotAI 認定講師実際、チームで「このリポジトリではテストを先に書く」みたいな共通認識はルールに。特定のフレームワークのセットアップ手順はスキルに、という使い分けがよく聞かれますね。
実際のユースケースで選ぶ判断基準
室谷代表取締役単純な基準としては「その処理をエージェントに完全に任せて並列実行させたいか」どうか。並列が必要ならサブエージェント、手順を教えたいだけならスキルです。
テキトー教師DotAI 認定講師あとは「結果のスコープ」もポイント。サブエージェントは結果を親に返すだけ。
スキルはエージェント自身が手順を踏んで作業を進める。
スキルはエージェント自身が手順を踏んで作業を進める。
室谷代表取締役たとえばコードレビューのチェックリストはスキル。でも「このモジュールの単体テストを全部書いて」はサブエージェントに投げる、という感じですね。
テキトー教師DotAI 認定講師最初はどちらでも動くケースも多いので、まずはスキルから試して、コンテキストが足りなくなったらサブエージェントに切り替える、という流れが現実的です。
チーム開発におけるサブエージェントの活用法
まとめ
チーム開発におけるサブエージェントの活用法
- コードレビューに自動組み込み：VerifierサブエージェントでPRをチェック。定型作業から始める。
- CI/CDパイプラインとの連携：ヘッドレスモードで定時実行。並列でテスト結果を解析し、原因をPRに自動リンク。
- 小規模チームのミニマム構成：ExploreとBashを有効化。カスタムレビューサブエージェントを追加し、.cursor/agents/reviewer.mdで指示。
コードレビューへの自動組み込み
室谷代表取締役コードレビューって、チームが大きくなるとボトルネックになりがちですよね。サブエージェントをレビュアーとして組み込む手、地味に効くんですよ。
テキトー教師DotAI 認定講師たしかに。カスタムサブエージェントで「Verifier」みたいなのを作って、変更内容を自動でチェックさせるといいですよね。
実装漏れやエッジケースを拾わせる。
実装漏れやエッジケースを拾わせる。
室谷代表取締役うちの現場では、PR作成後に自動で検証サブエージェントを走らせて、問題があればコメントを付けるようにしてます。人間のレビュアーはその結果を見て判断するだけ。
テキトー教師DotAI 認定講師最初に戸惑うのが「サブエージェントに何を任せるか」ですけど、コードスタイルや単体テストの実行みたいな定型作業から始めると失敗しにくいですよ。
CI/CDパイプラインとの連携
室谷代表取締役せっかくサブエージェントをCIに乗せるなら、ビルド後のテスト失敗解析なんかに使うと良さそうです。
テキトー教師DotAI 認定講師はい。Cursor CLIにはヘッドレスモードもあるので、GitHub Actionsなどでエージェントを定時実行できます。
サブエージェントを並列に動かして、各モジュールのテスト結果を一気に調べさせる。
サブエージェントを並列に動かして、各モジュールのテスト結果を一気に調べさせる。
室谷代表取締役コスト面も考えると、高速なモデルをExplorer代わりに使うのが現実的です。USのスタートアップだと、テストスイートの失敗ログをサブエージェントに解析させて、原因をPRに自動リンクする仕組みをよく見かけます。
テキトー教師DotAI 認定講師重要なのは、サブエージェントが出力した結果をどう本流に戻すかですよね。背景モードで走らせて、完了したら親エージェントが結果をまとめる。
その連携をCIのスクリプト上で記述しておく。
その連携をCIのスクリプト上で記述しておく。
小規模チームで始めるミニマム構成
室谷代表取締役「まずは何から？」って聞かれますが、標準のExploreとBashサブエージェントを有効にするだけで、だいぶ変わるんです。
テキトー教師DotAI 認定講師そうですね。コードベースの探索とシェルコマンドの実行が自動で分割されるので、コンテキストウィンドウを圧迫しなくなります。
室谷代表取締役小規模チームなら、そこに「レビュー用」のカスタムサブエージェントをひとつ追加すれば十分です。プロジェクトルートに.cursor/agents/reviewer.mdを置いて、確認事項を指示するだけ。
テキトー教師DotAI 認定講師現場でよく聞かれるのは「カスタムサブエージェントって難しそう」という声ですけど、マークダウンファイルを置くだけなので、普段のsettings.json編集よりずっと簡単ですよ。
サブエージェント導入の注意点とベストプラクティス
まとめ
サブエージェント導入の注意点とベストプラクティス
- セキュリティ: 読み取り専用のsubagentには`readonly`を明示指定し、権限継承を理解する。
- コスト最適化: タスクに適したモデルをsubagentごとに選択し、高速モデルで十分な作業に高コストモデルを使わない。
- トラブル対策: 親から明確な指示と十分なコンテキストを渡す。必要に応じてVerifier subagentで出力検証や、タイムアウト時のフォールバックを用意する。
- 設計原則: subagentは会話履歴を持たないため、文脈を誤解しないよう親が指示書のようにコンテキストを送るイメージが重要。
セキュリティと権限管理の考慮
室谷代表取締役サブエージェントの権限設定、意外と軽視されがちなんですよね。デフォルトで親のツールを継承するので、読み取り専用にすべきsubagentに書き込み権限がついてしまうケースがある。
テキトー教師DotAI 認定講師たしかに。最初に戸惑うのが「subagentが勝手にファイルを変更してしまう」という話。
Verifierのようにreadonlyで動かす設計が大事ですね。
Verifierのようにreadonlyで動かす設計が大事ですね。
室谷代表取締役MYUUUでは、カスタムsubagentに
readonlyを明示的に指定するルールにしてます。セキュリティとコストの両面でリスクを減らせる。テキトー教師DotAI 認定講師権限は親から継承されるので、子にだけ制限をかけるには明示的に制限するしかない。そこを理解してないと意図しない動作が起きます。
コスト最適化（モデル選択とトークン管理）
室谷代表取締役subagentは独立したコンテキストを使うので、トークン消費が増える。でも逆に、メイン会話のコンテキストが節約されるからトータルでは効率的。
モデル選びが鍵。
モデル選びが鍵。
テキトー教師DotAI 認定講師特にExploreはデフォルトで高速なモデルを使う想定。ユーザーが無意識に高いモデルをsubagentに指定してしまうのが落とし穴。
室谷代表取締役時給換算すると、安いモデルで済む作業に高いモデルを使うのはもったいない。「検索タスクは高速モデルで十分」という判断を自動でやってくれるのが理想。
テキトー教師DotAI 認定講師現場でよく聞くのは「全部Opusで動かしたらコストが跳ね上がった」という話。subagentごとにモデルを適材適所で選ぶ設計が必要です。
よくあるトラブルと解決策
室谷代表取締役subagentが期待した結果を返さない時、原因の大半は「親からの指示が曖昧」か「コンテキスト不足」のどちらか。プロンプトに具体性を持たせることが重要。
テキトー教師DotAI 認定講師subagentは過去の会話履歴を持たないので、親が十分なコンテキストを渡さないと文脈を誤解する。指示書を一緒に送るイメージが必要です。
室谷代表取締役トラブルシューティングとしては、subagentの出力を検証するVerifierを別途用意する手もある。フォーラムで提案されてるカスタム構成ですね。
テキトー教師DotAI 認定講師あと、backgroundモードで走らせたsubagentから結果が戻ってこないケース。タイムアウトやエラーが起きた場合のフォールバックを考えておく必要があります。
よくある質問
Q1. サブエージェントを覚えるのにどれくらい時間がかかりますか？
テキトー教師DotAI 認定講師初めて触る人だと、標準の3種を試すだけで半日あれば十分です。ただ、カスタムを作り始めると奥が深くて、現場で使いこなすには1週間くらい見たほうがいいですね。
室谷代表取締役そうそう。学習コストはコードを書く感覚に近いです。
単純な指示ならすぐですが、複雑なロジックを任せようとすると設計の練習が必要ですから。
単純な指示ならすぐですが、複雑なロジックを任せようとすると設計の練習が必要ですから。
Q2. サブエージェントに権限を設定できますか？
室谷代表取締役現状、Cursor自体がファイルシステムへのアクセス権限を統一的に管理してるんですよ。サブエージェントごとに細かく制限する機能はまだないです。
テキトー教師DotAI 認定講師チームで使うときに気になりますよね。今は「このエージェントはこのフォルダだけ触る」みたいな運用は、プロンプトでルールを書いて制御するしかないです。
Q3. サブエージェントの動作ログは残りますか？
室谷代表取締役残ります。Cursorのチャット履歴と同じ場所に、サブエージェントが行った操作の記録も保存されます。
あとで振り返れるのは結構便利です。
あとで振り返れるのは結構便利です。
テキトー教師DotAI 認定講師ただ、大量に動かすとログが膨れやすいので、必要に応じて消す運用も考えたほうがいいですね。
Q4. 無料プランでもサブエージェントは使えますか？
テキトー教師DotAI 認定講師使えますよ。ただ無料プランだとAPI呼び出し回数に制限がありますから、ヘビーに使うならProかMaxプランが現実的です。
室谷代表取締役時給換算すると、サブエージェントに作業させて自分は別のことやってる方が確実にペイするので、ビジネス用途なら最初から有料プランをおすすめしますね。
Q5. VS Code拡張でも同じような機能はありますか？
テキトー教師DotAI 認定講師Cursor独自の機能なので、VS Codeでは標準では使えません。ただ、類似の拡張で「Continue」なんかは近い体験を提供してますよ。
室谷代表取締役でも結局、エディタに組み込まれてるかどうかで操作性が全然違う。一度Cursorのサブエージェントに慣れると、拡張だらけのVS Codeに戻るのは正直しんどいですね。
まとめ
室谷代表取締役サブエージェントは、エディタ上で「チームメイト」を増やすような感覚ですね。標準の3種だけでもかなり仕事が捗ります。
テキトー教師DotAI 認定講師特にカスタムが作れるのが大きい。自分のプロジェクトのルールやスタイルに合わせたエージェントを育てれば、作業品質が一気に安定します。
室谷代表取締役導入の壁は最初だけ。「何を任せるか」さえ決めてしまえば、あとはどんどん効率が上がります。
まずはCode Reviewエージェントを試してみるのがおすすめです。
まずはCode Reviewエージェントを試してみるのがおすすめです。
テキトー教師DotAI 認定講師あとはスキルとサブエージェントの住み分けを意識すると、無駄な混乱を避けられます。ここは現場感覚で覚えるのが一番ですね。
室谷代表取締役サブエージェントはまだ進化途上ですが、今のうちに触っておく価値は間違いなくあります。まずは1つ、自分用にカスタムを作ってみてください。
