Blaze設定画面Hooksで処理を自動実行する

Hooksで処理を自動実行する

Hooks(フック)を使うと、メッセージの送信やBlazeの返答終了などのタイミングに合わせて、指定したコマンドを自動で実行できます。 たとえば「作業が終わったらSlackに通知する」「特定の操作の前に確認用のスクリプトを動かす」といった使い方ができます。

セキュリティに関する注意 Hooksのコマンドは、確認のダイアログなしに、お使いのパソコン上であなたのユーザー権限で直接実行されます。 安全性を確認できるコマンドやスクリプトのみを登録してください。

Hooksを追加する

Blazeとの会話を通して、自然な言葉で指示するだけでHooksを作成できます。

  1. 画面左下のプロフィールから 「設定」→「Hooks」 を開き、右上の 「追加」 を押します。

設定のHooks画面。追加ボタンと登録済みのHooksの一覧

  1. 設定画面が閉じ、チャットの入力欄に /hook-creator コマンドが自動入力されます。
  2. 続けて「いつ・何を実行したいか」を入力して送信します。
/hook-creator 返答が終わったらSlackに通知して
  1. Blazeが必要な定義ファイルとスクリプトを自動作成します(SlackのWebhook URLなど、必要な設定情報がある場合は会話の中でBlazeから確認されます)。
  2. 作成が完了すると、設定の 「Hooks」 一覧に登録されます。

実行できるタイミング(イベント)

Hooksは、Blazeの操作や状態変化(イベント)に連動して実行されます。

画面の表示実行されるタイミング
メッセージ送信時ユーザーがメッセージを送信した後、Blazeが処理を開始する前
ツール実行前Blazeがツール(コマンド実行やファイル編集など)を実行する直前
ツール実行後ツールの実行が成功した直後
ツール失敗時ツールの実行が失敗した直後
承認・回答待ち時Blazeがユーザーの承認や質問への回答を待っているとき
返答終了時Blazeが返答をすべて完了したとき
サブエージェント終了時サブエージェントが処理を完了したとき
エラー終了時返答がエラーによって終了したとき

注意点

  • HooksはBlazeアプリ内のイベントに連動して動作します。指定時刻(毎朝9時など)の定期実行や、外部サービスからの受信などをきっかけに実行することはできません。
  • Blazeアプリを閉じている間は動作しません。

登録したHooksを管理する

「設定」→「Hooks」 の一覧でHooksをクリックすると、実行コマンドや定義ファイル名などの詳細を確認できます。

操作手順・動作
オン・オフの切り替え各行の右側にあるスイッチを使います(オフにしたHooksは実行されません)。
内容の確認詳細を開いて 「開く」 を押すと、定義ファイルがアプリ内ブラウザに表示されます。
内容の変更変更したい内容をBlazeとの会話で依頼するか、定義ファイルを直接編集します。

終了コードで処理を制御する(中断・差し戻し)

Hooksのコマンドが終了コード 2 で終了した場合、Blazeの処理を中断させたり、標準エラー出力(stderr)に書き出したテキストを理由としてBlazeにフィードバックしたりできます。

タイミング終了コード 2 のときの動作
メッセージ送信時AIへの送信を中止し、標準エラー出力の内容を理由として画面に表示します
ツール実行前ツールの実行を中止し、その理由をBlazeに伝えます
ツール実行後 / ツール失敗時ツールの実行結果に理由を追加してBlazeに伝えます
返答終了時 / サブエージェント終了時理由をBlazeにフィードバックし、追加で作業を継続させます(最大8回まで)
  • その他の終了コード: 終了コードが 0(正常終了)および 2 以外の場合、または起動失敗や制限時間超過のときは、Blazeの処理を中断せずにそのまま続行します。
  • 制限時間(タイムアウト): 個別の指定がない場合の制限時間は 600秒 です。

定義ファイルを直接編集する

高度なカスタマイズを行いたい場合は、定義ファイル(JSON)を直接作成・編集できます。

保存場所とフォーマット

定義ファイルは ~/.blaze/hooks ディレクトリに、Hooksごとに1つのJSONファイルとして保存します。Blazeが対応しているのは command タイプのHooksです。

{
  "description": "返答が終わったら通知する",
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/notify.js\"",
            "timeout": 30
          }
        ]
      }
    ]
  }
}
  • ${CLAUDE_PLUGIN_ROOT}: Hooksディレクトリ(~/.blaze/hooks)のパスを表す組み込み環境変数です。スクリプトのパス指定などに利用できます。
  • 自動再読み込み: 定義ファイルはイベントが発生するたびに自動で読み直されるため、ファイルを保存すれば次回実行時から即座に変更が反映されます。

イベント名の対応表

JSONファイル内では、実行タイミングを以下のイベント名で指定します。

画面の表示定義ファイルに記述する名前
メッセージ送信時UserPromptSubmit
ツール実行前PreToolUse
ツール実行後PostToolUse
ツール失敗時PostToolUseFailure
承認・回答待ち時Notification
返答終了時Stop
サブエージェント終了時SubagentStop
エラー終了時StopFailure

うまくいかないとき

Hooksの設定に問題がある場合、一覧画面にエラーが表示され、修正するまでそのHooksは実行されません。エラーメッセージに合わせて以下の対処を行ってください。

エラー表示原因と対処方法
Invalid JSON定義ファイルが正しいJSON形式になっていません。行を開いて 「開く」 を押し、カンマの過不足や波括弧 { } の対応を確認してください。
“hooks” must be an object定義ファイルに "hooks" キーがないか、オブジェクト形式になっていません。上記のJSON例と同じ構造に修正してください。
Blazeが対応していないタイミングだけが書かれています定義ファイルに未対応のイベント名が指定されています。上の対応表にあるイベント名に修正してください。