settings.json

hooks.SubagentStop

型array

サブエージェントが応答を終えた際に実行されるフック。

使い方・用途

  • サブエージェントの処理が完了したタイミングでクリーンアップスクリプトを実行したり、最終的な応答内容を解析して後続の処理に活かしたりします。
英語原文(公式ドキュメントより)

Hooks that run when subagents finish responding

関連ドキュメント

関連する変更履歴

v2.1.294(1件)

Improved
Stop および SubagentStop で「Carry on if the build is broken」のように指示として書かれた prompt フックの判定方法を改善し、Claude が早めに停止しにくくなった
英語原文を表示
Improved how prompt hooks on Stop and SubagentStop written as instructions (such as "Carry on if the build is broken") are judged, so Claude is less likely to stop early

変更後

「ビルドが壊れていたら作業を続ける」のような指示文として書かれた prompt フックを、Claude が正確に判定できるようになり、作業が未完了なのに早く止まってしまうのを防げる。

関連ドキュメント

v2.1.275(1件)

Fixed
agent type が空の終了中サブエージェントに対して、特定の matcher を持つ SubagentStop フックがすべて発火する問題を修正した。
英語原文を表示
Fixed SubagentStop hooks with a specific matcher firing for every stopping subagent whose agent type was empty

関連ドキュメント

v2.1.163(1件)

Added
フック：Stop および SubagentStop フックが hookSpecificOutput.additionalContext を返せるよう改善。エラー扱いせずに Claude へフィードバックを返し、ターンを継続可能
英語原文を表示
Hooks: Stop and SubagentStop hooks can now return hookSpecificOutput.additionalContext to give Claude feedback and keep the turn going without being labeled a hook error

変更後

特定のタスク終了時にカスタムの指示やフィードバックを自動で挿入できるため、より高度な自動化ワークフローが実現します。

関連ドキュメント

v2.1.145(1件)

Added
Stop および SubagentStop フックの入力データに background_tasks と session_crons フィールドを追加
英語原文を表示
Stop and SubagentStop hook input now includes background_tasks and session_crons fields

変更後

セッション終了時に未完了のタスクを確認して通知を送ったり、クリーンアップ処理を自動化したりするなど、より高度な自動化スクリプトが作成可能になります。

関連ドキュメント

v2.1.118(1件)

Fixed
エージェント型フックが Stop 等の特定のイベント以外で「メッセージが必要」というエラーで失敗する問題を修正
英語原文を表示
Fixed agent-type hooks failing with "Messages are required for agent hooks" when configured for events other than Stop or SubagentStop

変更後

特定のライフサイクルイベントにおいて、エージェントによる高度な自動検証を柔軟に組み込めるようになります。

関連ドキュメント

v2.1.98(1件)

Fixed
長時間セッションでのプロンプト型 Stop/SubagentStop フックの失敗、およびフック評価時の API エラーが不正確に表示される問題を修正しました。
英語原文を表示
Fixed prompt-type Stop/SubagentStop hooks failing on long sessions, and hook evaluator API errors showing "JSON validation failed" instead of the real message

変更後

ワークフローの自動化や検証をフックで行っている場合、その信頼性とメンテナンス性が大幅に向上します。

関連ドキュメント

v2.1.97(1件)

Fixed
長いセッションでプロンプトタイプのStop/SubagentStopフックが失敗する問題、およびフック評価時のAPIエラーが具体的なメッセージではなく「JSON validation failed」と表示される問題を修正しました。
英語原文を表示
Fixed prompt-type Stop/SubagentStop hooks failing on long sessions, and hook evaluator API errors displaying "JSON validation failed" instead of the actual message

変更後

自動化された後処理や通知が確実に実行されるようになり、開発ワークフローの信頼性が向上します。

関連ドキュメント

v2.1.47(1件)

Added
StopおよびSubagentStopフック入力に last_assistant_message フィールドを追加しました。これにより、フックはトランスクリプトファイルを解析することなく、最終的なアシスタントの応答テキストにアクセスできるようになります。
英語原文を表示
Added last_assistant_message field to Stop and SubagentStop hook inputs, providing the final assistant response text so hooks can access it without parsing transcript files.

変更後

フック開発者がアシスタントの最終応答に簡単にアクセスできるようになり、より効率的で堅牢なフックの作成が可能になりました。

関連ドキュメント

v2.0.42(1件)

v1.0.41(1件)

Changed
Hooks: Split Stop hook triggering into Stop and SubagentStop