settings.json

hooks.SubagentStart

型array

サブエージェントが生成された際に実行されるフック。

使い方・用途

  • 特定の役割(Explore、Plan、カスタムエージェント等)を持つサブエージェントが起動する際に、専用の初期設定スクリプトを実行したりコンテキストを注入したりします。
英語原文(公式ドキュメントより)

Hooks that run when a subagent is spawned

関連ドキュメント

関連する変更履歴

v2.1.265(1件)

Fixed
エージェントのチームメイトや再開されたサブエージェントで、後のターンで SubagentStart フックのコンテキストやプリロードされたスキルがプロンプトのプレフィックスから外れ、プロンプトキャッシュ再利用が壊れる問題を修正した
英語原文を表示
Fixed agent teammates and resumed subagents moving SubagentStart hook context and preloaded skills out of the prompt prefix on later turns, which broke prompt-cache reuse

関連ドキュメント

v2.1.199(1件)

Fixed
SessionStart、Setup、およびSubagentStartフックが終了コード2で終了する際、標準エラー出力(stderr)を隠してしまう問題を修正し、内容がトランスクリプトに表示されるようにしました。
英語原文を表示
Fixed SessionStart, Setup, and SubagentStart hooks silently hiding stderr when exiting with code 2 — the error is now shown in the transcript

変更後

フックの設定やスクリプトに問題がある場合でも、迅速に原因を把握して修正できます。

関連ドキュメント

v2.1.142(1件)

Improved
特定のフックイベントで不適切なフックタイプを設定した場合のエラーメッセージを改善
英語原文を表示
Improved hook configuration error: configuring a prompt- or agent-type hook for SessionStart/Setup/SubagentStart now shows a clear "use a command-type hook instead" error

変更後

フック機能の高度なカスタマイズを行う際に、設定ミスを迅速に自己解決できるようになります。

関連ドキュメント

v2.0.43(1件)