Claude Code Sub-agents

変更前

フック内で、現在実行中のアクションがメインスレッドによるものか、それとも特定のサブエージェントによるものかを判別して処理を分けることが困難でした。

変更後

フックハンドラーに渡される JSON にエージェントの情報が含まれるようになったため、「このエージェントが実行するときだけは特定の処理をスキップする」といったきめ細やかな制御が可能になりました。

ユーザーへの恩恵

サブエージェントを活用した複雑な自動化において、フックの挙動を意図通りに制御できるようになり、より高度な開発支援環境を構築できます。

変更前

サブエージェントを使用する長時間セッションで、プログレスメッセージのペイロードがメモリを圧迫し、メモリ使用量が増加していました。

変更後

コンテキスト圧縮時に重いプログレスメッセージペイロードが除去されるようになり、サブエージェント利用時のメモリ効率が向上しました。

ユーザーへの恩恵

長時間にわたるサブエージェントの使用におけるメモリ効率が大幅に改善され、パフォーマンスが向上します。

変更前

以前は、サブエージェントがコードベースに変更を加える際、メインの作業ディレクトリに直接変更が適用される可能性がありました。これにより、サブエージェントが意図しない変更を加えたり、実験的な作業が他の開発者の作業と衝突したりするリスクがありました。

変更後

サブエージェントの設定でisolation: "worktree"を指定することで、サブエージェントが独立したGitワークツリー内で作業を行うことができるようになりました。これにより、サブエージェントが行うすべての変更はそのワークツリー内に隔離され、メインのコードベースや他のサブエージェントの作業に影響を与えません。

ユーザーへの恩恵

サブエージェントを使用した大規模な変更や実験的なタスクを、より安全かつ独立して実行できるようになります。メインプロジェクトへの意図しない変更のリスクが低減され、サブエージェントは自信を持ってコードを変更・テストできるため、開発者は安心してAIにタスクを任せられるようになります。

変更前

以前は、.claude/agents/ディレクトリにエージェントではない通常のMarkdownファイルを配置すると、不必要な警告が表示されることがありました。これにより、ユーザーはこれらの警告に煩わされ、重要な情報を見落とす可能性がありました。

変更後

今回の修正により、.claude/agents/ディレクトリ内にあるMarkdownファイルがエージェントに関連しない場合でも、誤った警告が表示されなくなりました。システムは正しくエージェント関連ファイルとそれ以外のファイルを区別します。

ユーザーへの恩恵

ユーザーは、.claude/agents/ディレクトリをより柔軟に利用できるようになり、開発環境が警告で煩雑になることがなくなります。これにより、よりクリーンで集中しやすい作業環境が提供され、生産性が向上します。

変更前

以前は、エージェントがサブエージェントを起動する際に、どのサブエージェントタイプでも自由にスポーンできるため、特定のワークフローにおいて意図しないサブエージェントが起動される可能性がありました。これにより、セキュリティポリシーの適用や、特定のタスクに特化したエージェントの利用を強制することが困難でした。

変更後

今回、エージェントのツール設定においてAgent(agent_type)という構文を使用することで、メインスレッドとして実行されているエージェントがスポーンできるサブエージェントの種類を明示的に制限できるようになりました。例えば、tools: Agent(worker, researcher)と設定すれば、workerとresearcherサブエージェントのみが起動可能となり、その他のサブエージェントの起動は失敗します。

ユーザーへの恩恵

この機能により、サブエージェントの利用に関してより厳密な制御が可能になります。特定の役割を持つエージェントが、その役割に必要なサブエージェントのみを起動するように制限できるため、ワークフローの予測可能性とセキュリティが向上します。これにより、開発者はより安全で効率的なマルチエージェントシステムを構築できるようになります。

変更前

サブエージェントからSDK提供のMCPツールを利用しようとすると、ツールが利用できない、または同期されておらずアクセスできない問題が発生していました。

変更後

サブエージェントからSDK提供のMCPツールへアクセスできるよう、共有アプリケーションステートとの同期が修正されました。

ユーザーへの恩恵

サブエージェントがMCPツールをより効果的に利用できるようになり、機能拡張性が向上しました。

変更前

ローカルスラッシュコマンドを実行する際、/model や /theme などで、モデルやテーマの選択 UI が一瞬表示されて消えることがありました。

変更後

ローカルスラッシュコマンド実行時に、モデルやテーマの選択 UI が一瞬表示されて消える現象を修正しました。

ユーザーへの恩恵

コマンド実行時の UI のちらつきがなくなり、よりスムーズで快適な操作感を提供します。

変更前

/tasks でバックグラウンドタスクを管理している際、Web セッションへのリンクが壊れたり、ローカル端末へセッションを引き継ぐ(テレポートする)ことができない場合がありました。

変更後

/tasks コマンド経由でもリモート連携機能が正しく動作するようになり、Web と端末間のシームレスな行き来が可能になります。

ユーザーへの恩恵

複数のタスクを並行して進める際、場所や端末を選ばずスムーズに作業を再開できるようになり、開発の継続性が保たれます。

変更前

スキルやコマンドを実行するとメインの会話コンテキストに履歴が蓄積され、トークン消費の増大や、メインエージェントの思考へのノイズ発生が避けられませんでした。

変更後

実行環境を独立したサブエージェントとして切り出せるようになり、大量のファイル読み込みや複雑な調査をメインの履歴を汚さずに行えます。

ユーザーへの恩恵

メインの会話履歴(コンテキスト)を節約しつつ、特定のタスクのみを専門のワーカーに任せるような高度な自動化フローを構築できます。

変更前

メインセッションで設定したクロスリージョン推論のオプションが、新しく起動したサブエージェントに正しく引き継がれず、特定のリージョンに制限された権限環境でエラーになっていました。

変更後

すべてのサブエージェントが親セッションの推論設定を正しく共有するようになり、分散リージョン環境でも安定して動作します。

ユーザーへの恩恵

グローバルな AWS インフラを利用しているエンタープライズユーザーも、サブエージェント機能を確実に利用できます。