settings.json

hooks.TeammateIdle

型array

エージェントチームのメンバーがアイドル状態になる直前に実行されるフック。

使い方・用途

  • チームメイトが作業を終えて待機状態になる前に、追加のフィードバックを与えて作業を継続させたり、特定の条件で強制終了させたりしてワークフローを制御します。
英語原文(公式ドキュメントより)

Hooks that run when an agent team teammate is about to go idle. Exit code 2 sends feedback and keeps the teammate working. Does not support matchers. Agent teams are experimental. See https://code.claude.com/docs/en/hooks#teammateidle

関連ドキュメント

関連する変更履歴

v2.1.290(1件)

Changed
Agent の結果におけるインプロセスのチームメイトの agent_id をそのエージェント ID に変更した(name@team アドレスは引き続き teammate_id に残る);TeammateIdle フックがそのサブエージェントやフォークから発火しなくなった。
英語原文を表示
Changed an in-process teammate's agent_id in Agent results to its agent ID (its name@team address stays in teammate_id); TeammateIdle hooks no longer fire from its subagents or forks

変更後

Agent 結果内の in-process teammate は agent_id で一意に識別できるようになり、TeammateIdle フックが teammate の subagent や fork から誤って発火しなくなる。

v2.1.69(1件)

Fixed
Fixed TeammateIdle and TaskCompleted hooks to support {"continue": false, "stopReason": "..."} to stop the teammate, matching Stop hook behavior

関連ドキュメント

v2.1.64(1件)

Fixed
TeammateIdle および TaskCompleted フックにおいて、Stop フックと同様の {"continue": false, "stopReason": "..."} 形式によるチームメイトの停止をサポートしました。
英語原文を表示
Fixed TeammateIdle and TaskCompleted hooks to support {"continue": false, "stopReason": "..."} to stop the teammate, matching Stop hook behavior

変更後

チームメイトの無駄な待機時間を削減し、特定の状況下での自動化フローの制御がより正確に行えるようになります。

関連ドキュメント

v2.1.33(1件)

Added
マルチエージェントワークフロー向けに、TeammateIdleとTaskCompletedのフックイベントが追加されました。
英語原文を表示
Added TeammateIdle and TaskCompleted hook events for multi-agent workflows

変更後

これらの新しいフックイベントにより、マルチエージェントワークフローの自動化と制御が大幅に強化されます。チームメイトの振る舞いやタスクの完了プロセスをより細かくカスタマイズできるため、複雑なプロジェクト管理や品質保証のシナリオにおいて、より堅牢でインテリジェントなエージェントチームを構築できます。これにより、開発者はワークフローの柔軟性が向上し、生産性が高まることを実感できます。

関連ドキュメント