CC逆引きリファレンス

エージェントチームメンバーのアイドル・タスク完了をフックしたい

11. フック

コマンド / 機能

TeammateIdle / TaskCompleted

エージェントチーム連携フック

概要

TeammateIdle はエージェントチームのメンバーがアイドル状態になりそうな時に発火し、TaskCompleted はタスクが完了としてマークされた時に発火します。エージェント間の協調動作に使います。

設定例

// .claude/settings.json
{
  "hooks": {
    "TeammateIdle": [
      {
        "type": "command",
        "command": ".claude/hooks/assign-next-task.sh"
      }
    ],
    "TaskCompleted": [
      {
        "type": "command",
        "command": ".claude/hooks/on-task-done.sh"
      }
    ]
  }
}

// TeammateIdle フックでタスクを割り当てる例
#!/bin/bash
# アイドルになったチームメンバーに次のタスクを割り当て
echo "[TaskQueue] Assigning next task to idle teammate" >> .claude/team.log
公式ドキュメントを見る

こんな時に使う

  • エージェントチームのワークフローを自動化したい時
  • タスク完了時に後続処理を実行したい時
  • エージェントのアイドル状態を活用したい時

使い方

  1. 1hooks.TeammateIdle でアイドル時の処理を定義
  2. 2hooks.TaskCompleted でタスク完了後の処理を定義
  3. 3エージェントチーム(Research Preview)使用時に有効

Tips

  • エージェントチーム機能(Research Preview)が必要
  • TeammateIdle でアイドルメンバーに新たなタスクを割り当て可能
  • TaskCompleted で成果物の検証や通知が実装できる