settings.json

hooks.UserPromptSubmit

型array

ユーザーがプロンプトを送信した際に実行されるフック。

使い方・用途

  • プロンプトの送信直前に追加のコンテキストを注入したり、特定のキーワードに基づいてセッションタイトルを自動的に書き換えたりするために使用します。
英語原文(公式ドキュメントより)

Hooks that run when a user submits a prompt

関連ドキュメント

関連する変更履歴

v2.1.299(3件)

Fixed
Cowork および claude.ai クラウドセッションで、UserPromptSubmit フックや mod の prompt.submit フックの実行中に停止されたメッセージに対して Edit and Retry が失敗する問題を修正した（2.1.296 でのリグレッション）。
英語原文を表示
Fixed Edit and Retry in Cowork and claude.ai cloud sessions failing on a message stopped while its UserPromptSubmit or mod prompt.submit hooks were still running (regression in 2.1.296)
Changed
UserPromptSubmit フックが、スキルやカスタムスラッシュコマンドの展開前に実行されるように変更した。プロンプトをブロックするフックが、埋め込まれたシェルコマンドも停止できるようになる
英語原文を表示
Changed UserPromptSubmit hooks to run before a skill or custom slash command expands, so a hook that blocks the prompt now also stops its embedded shell commands

変更後

UserPromptSubmit フックでプロンプトをブロックした際に、スキルやカスタムスラッシュコマンド内に埋め込まれたシェルコマンドまで実行されてしまう問題が解消され、フックによるブロック確実に防止できる。

関連ドキュメント

Changed
スキル自身のフロントマターにある UserPromptSubmit フックが、スキルを呼び出したプロンプトの次のプロンプトに対して初めて実行されるように変更した
英語原文を表示
Changed a skill's own front-matter UserPromptSubmit hook to first run on the prompt after the one that invokes the skill

変更後

スキル自身のフロントマターに定義した UserPromptSubmit フックが、スキルを呼び出したプロンプトではなく、その次のユーザープロンプトに対して最初に実行されるようになり、スキル呼び出し直後の入力に対してフックでルールを確実に適用できるようになった。

関連ドキュメント

v2.1.296(1件)

Fixed
UserPromptSubmit フックや mod の prompt.submit フック中に Esc や割り込み操作が発生すると、headless セッションが終了したり、入力済みプロンプトが消えたり、未検証のプロンプトが通過してしまう問題を修正した
英語原文を表示
Fixed Esc or an interrupt during a UserPromptSubmit hook or a mod's prompt.submit hook ending headless sessions, clearing the typed prompt, or letting the unchecked prompt through

関連ドキュメント

v2.1.280(1件)

Improved
UserPromptSubmit フックのタイムアウト通知とデバッグログを改善し、どのフックコマンドがタイムアウトしたかを明示するようにした
英語原文を表示
Improved the UserPromptSubmit hook timeout notice and the debug log to name which hook command timed out

変更後

UserPromptSubmit フックがタイムアウトしたとき、どのコマンドがタイムアウトしたのかが通知とデバッグログで分かるようになり、問題のあるフックを素早く特定できる。

関連ドキュメント

v2.1.271(1件)

Improved
hook フィードバックを改善し、SessionStart、UserPromptSubmit、PreToolUse、SessionEnd の各 hook 実行中はスピナーが経過時間付きでその旨を表示し、Esc で SessionStart hook の待機中のプロンプトをキャンセルできるようになった
英語原文を表示
Improved hook feedback: while a SessionStart, UserPromptSubmit, PreToolUse or SessionEnd hook runs, the spinner says so with elapsed time, and Esc cancels a prompt waiting on a SessionStart hook

変更後

SessionStart、UserPromptSubmit、PreToolUse、SessionEnd フックの実行中に、どのフックが動いているのかと経過時間がスピナー表示で分かるようになり、フックが長引いたときの状況を把握しやすくなる。また、SessionStart フックで待たされているプロンプトを Esc キーでキャンセルできるようになる。

関連ドキュメント

v2.1.136(1件)

Fixed
キャッシュクリーンアップによって使用中のバージョンが削除された際、プラグインの Stop や UserPromptSubmit フックが失敗する問題を修正しました。
英語原文を表示
Fixed plugin Stop/UserPromptSubmit hooks failing when cache cleanup deletes a version still in use by a running session

変更後

バックグラウンドのメンテナンス処理を気にすることなく、安定してプラグインや自動化フックを利用し続けることができます。

関連ドキュメント

v2.1.94(1件)

Added
UserPromptSubmit フックに hookSpecificOutput.sessionTitle を追加し、フック経由でのセッションタイトルの設定に対応
英語原文を表示
Added hookSpecificOutput.sessionTitle to UserPromptSubmit hooks for setting the session title

変更後

独自の命名規則に従ってセッションを自動整理したり、特定のキーワードが含まれる場合にタイトルを即座に変更したりといった自動化が可能になります。

関連ドキュメント

v1.0.59(1件)

Added
Hooks: UserPromptSubmit now supports additionalContext in advanced JSON output

関連ドキュメント

v1.0.54(1件)

Changed
Hooks: Added UserPromptSubmit hook and the current working directory to hook inputs