Introduction to Subagentsコースで学ぶ委任ワークフロー設計

Introduction to Subagentsは、Anthropic Academyが無料で公開しているコースです。Claude Codeのサブエージェント機能について、仕組みの理解から作成方法、設計パターン、使うべき場面の判断までを1本のカリキュラムで扱います。構成は「What are subagents?」「Creating a subagent」「Designing effective subagents」「Using subagents effectively」の4モジュールです。

Introduction to Subagentsコースの概要

本コースはSkilljar(anthropic.skilljar.com)上で公開されており、受講にAnthropicアカウントは不要です。登録に必要なのはSkilljarアカウントのみで、料金は無料です。

コースの説明文は、サブエージェントを「長いClaude Codeセッションから多くを引き出すための、最も実践的な手段の一つ」と位置付けています。作業を独立したアシスタントに委任し、そのアシスタントが別のコンテキストで作業を終えて必要な情報だけを返すことで、メインのコンテキストウィンドウをきれいに保てるという狙いです。この説明は、Claude Code公式ドキュメントが挙げる「コンテキストの保全」「制約の強制」「設定の再利用」「振る舞いの専門化」「コストの制御」という5つの利点と重なります。

Anthropic Academyには本コース以外にも複数のコース・パスがあり、開発者向けの系列には「Introduction to agent skills」や「Introduction to Model Context Protocol」も並びます。全コースの一覧と、Pearson監督試験による有料の認定資格制度はAnthropic Academyの全コースと認定資格の学習ルートで扱っています。本記事はIntroduction to Subagentsコースが教える委任ワークフロー設計の内容に絞って掘り下げます。

カリキュラム4モジュールで学ぶ内容

コースのカリキュラムは4モジュールで構成され、それぞれ次の内容を教えるとコース説明文に明記されています。

コース説明文は到達点も明示しています。複雑な作業を焦点の絞られた単位に分割し、時間内に完了して結果を明確に報告するサブエージェントを作れるようになること、そして委任する価値があるかどうかを自分で判断できるようになることの2点です。

「What are subagents?」— コンテキスト分離の仕組み

サブエージェントは、メインの会話とは別のコンテキストウィンドウで動くAIアシスタントです。作業はサブエージェント側のウィンドウで完結し、メインの会話にはその結果の要約だけが返ります。

Claude Codeは、依頼内容とサブエージェントのdescriptionフィールドを照合して、どのタスクをどのサブエージェントに委任するかを自動的に判断します。この自動委任を後押ししたい場合は、descriptionに「use proactively」のような一文を加える設計が公式ドキュメントで案内されています。自動委任に任せず特定のサブエージェントを確実に使わせる方法も3段階あります。プロンプト内で名前を挙げる、@でメンションする、--agentフラグでセッション全体をそのサブエージェントに切り替える、の順でエスカレーションが強くなります。

サブエージェントはフォアグラウンドとバックグラウンドのどちらでも動きます。フォアグラウンドは結果が出るまでメインの会話をブロックし、バックグラウンドは並行して動きながら権限確認だけをメインセッションに戻します。対話セッションでは既定でフォーク(fork)モードが有効です。そのため、フォークでないサブエージェントも含めて基本的にバックグラウンドで動きます。これがコース説明文の「仕組みの理解」が指すコンテキスト管理の実像です。

「Creating a subagent」— コース公開時から仕様が変わった点

サブエージェントの実体は、YAMLフロントマターとMarkdownのシステムプロンプトで構成される1つのファイルです。.claude/agents/(プロジェクト)または~/.claude/agents/(ユーザー)に置き、フロントマターの必須フィールドはnameとdescriptionの2つだけです。

ファイルの作成方法自体は変わっていません。Claudeに「こういうサブエージェントを作って」と依頼して書かせるか、frontmatterを手書きするかのどちらかです。ファイルを追加・編集すると、Claude Codeは数秒以内に変更を検知して次回の委任から反映します。ただし新しいagentsディレクトリを作った直後や、--add-dirで追加したディレクトリ内のファイルは監視対象に入らず、再起動が必要になる場合があります。

サブエージェントの権限設計は、tools(許可するツール)とdisallowedTools(禁止するツール)のフロントマターで制御します。ツールアクセスの絞り方の実務的な判断基準はClaude Codeサブエージェント権限ルール設計で詳しく扱っています。

「Designing effective subagents」— 3つのパターンを仕様で確認する

コース説明文が挙げる3つの設計パターン(構造化された出力形式・障害の報告・ツールアクセスの制限)は、公式ドキュメントが示す例に当てはめると具体的な形が見えてきます。

構造化された出力形式は、公式の例に具体的な形があります。コードレビュー担当は「重大な問題・警告・提案」の3段階で結果を返します。デバッグ担当は「根本原因・裏付けとなる根拠・具体的な修正・テスト方法・再発防止策」の5項目で返します。項目を固定することで、メインの会話側は要約を読むだけで判断できます。

障害の報告に対応する仕様は、API起因の失敗時にサブエージェントが処理を静かに打ち切るのではなく、失敗そのものをClaudeに報告する挙動です。v2.1.199以降、レート制限やサーバーエラーで応答が途中で切れると、動作は実行場所で分かれます。フォアグラウンドでは、その時点までの出力に「途中で打ち切られた」という注記を添えて返します。バックグラウンドでは失敗として扱いつつ、最後の出力を添えてメインの会話に伝えます。読み取り専用のサブエージェント例でも、書き込みを求められたときに「読み取り専用のためできない」と明示的に応答する設計が示されています。

ツールアクセスの制限は、toolsとdisallowedToolsのフロントマターに加え、PreToolUseフックでコマンドの内容そのものを検証する方法が公式ドキュメントに載っています。読み取り専用のデータベース分析担当の例が、この二重の守りを示しています。toolsにBashを許可しつつ、フック側のスクリプトでSQLの書き込み系コマンドを検知して拒否する構成です。フロントマターの許可リストだけでは足りない場面の実装例になっています。

「Using subagents effectively」— 使うべき場面と避けたい場面

コースの4番目のモジュールが扱う「いつ使うか、いつ使わないか」の判断基準は、公式ドキュメントにも同じ切り口でまとめられています。

頻繁なやり取りや反復的な調整が必要な作業、計画・実装・テストのように文脈を共有し続ける複数フェーズの作業、素早く的を絞った変更、レイテンシが重要な場面は、メインの会話で進める方が適しています。逆に、出力が大量で本筋には要らない作業、特定のツール制限や権限を強制したい作業、自己完結していて要約だけ返せばよい作業は、サブエージェントへの委任が向いています。

実務でよく使われる委任パターンは3つです。

• テスト実行やログ処理のように、出力量が多い操作を隔離する
• 認証・データベース・APIのように、独立した調査対象を並列で走らせる
• レビュー担当と修正担当のように、複数のサブエージェントを連鎖させる

並列調査の具体的な組み方はClaude Codeのサブエージェント完全活用にまとめています。

避けるべきアンチパターンとして公式ドキュメントが明示しているのは、詳細な結果を返すサブエージェントを多数同時に走らせる使い方です。サブエージェントが完了するとその結果はメインの会話に戻るため、数を増やすほどメインのコンテキストを圧迫します。既にメインの会話に含まれている内容についての質問であれば、サブエージェントではなく/btwを使う方が適切だという案内も、同じ「委任すべきか」の判断軸に含まれます。

このコースが向いている人と学び方

サブエージェントを毎日のように使っている開発者にとって、本コースの説明文が挙げる内容は、公式ドキュメントの仕様とかなり重なります。コース固有の価値は、新しい仕様を発見できることではなく、仕組み・作成・設計・使い分けの4段階を1つの流れとして順番に学べる構成そのものにあります。

サブエージェントを初めて使う人は本コースから入るのが適しています。フロントマターの全フィールドや権限まわりの細部まで確認したい人は、Claude Code Sub-agents完全ガイドから入る方が早く目的の情報に着きます。Anthropic Academy全体の中での本コースの扱いや、認定資格につながる学習ルートは、概要節で挙げた記事にまとめています。

まとめ

Introduction to Subagentsは、Claude Codeのサブエージェント機能を「仕組み」「作成」「設計」「使い分け」の4モジュールで学ぶ無料コースです。コース説明文が挙げる内容は公式ドキュメントの仕様と高い精度で対応しており、/agentsコマンドの案内のようにバージョンアップで挙動が変わった部分もあります。委任ワークフローを体系的に学びたい人はコースの流れに沿って進め、実装の細部を確認したい人は公式ドキュメントや関連記事を併読するのが実務的な進め方です。