settings.json

hooks.TaskCreated

array

TaskCreateを介してタスクが作成される際に実行されるフックで、終了コード2を返すとタスク作成をロールバックできます。

使い方・用途

  • タスクの作成をトリガーに、外部のタスク管理システムとの自動同期やカスタムログの記録、CIの実行などのワークフローを自動化する場合に使用します。
  • AIエージェントによる無秩序なタスクの増殖を防ぎ、特定の条件下でのみタスク開始を許可するといった管理・統制を行いたい場合に有効です。
英語原文(公式ドキュメントより)

Hooks that run when a task is being created via TaskCreate. Exit code 2 rolls back task creation. Does not support matchers. See https://code.claude.com/docs/en/hooks#taskcreated

関連ドキュメント

関連する変更履歴

v2.1.89(1件)

Changed
TaskCreated フックイベントとそのブロッキング挙動をドキュメント化した。
英語原文を表示
Documented TaskCreated hook event and its blocking behavior

変更前

TaskCreated フックイベントがいつ発火するかが hooks のライフサイクル表に記載され、TaskCreate 経由でタスクが作成されるときに発火することがわかるようになった。さらに、decision 制御の早見表にもこのイベントが追加され、終了コード 2 または `decision:

変更後

TaskCreated フックイベントがいつ発火するかが hooks のライフサイクル表に記載されていなかった。また、このイベントがブロッキング(タスク作成のキャンセル)をどのように制御できるかも明記されていなかった。

ユーザーへの恩恵

ユーザーは TaskCreated フックを設定する際に、イベントの発火タイミングとブロックによるタスク作成キャンセルの挙動をドキュメントで確認できるようになる。

関連ドキュメント

v2.1.84(1件)

Added
タスク作成時に実行される TaskCreated フックを追加
英語原文を表示
Added TaskCreated hook that fires when a task is created via TaskCreate

変更前

Claudeが新しいタスクを作成した瞬間に外部ツールを連携させたり、カスタムログを記録したりする標準的なトリガーがありませんでした。

変更後

TaskCreate ツールによってタスクが作成されたときに発火する TaskCreated フックが実装されました。

ユーザーへの恩恵

タスク管理システムとの自動同期や、タスク開始時のCI実行など、開発ワークフローをよりきめ細かく自動化できます。

関連ドキュメント