Create Hook
プラグインに新しいフックを作成します。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/hook-create - Create Hook
概要:
プラグインに新しいフックを作成します。
使用方法:
/hook-create [オプション]
オプション:
--help このヘルプを表示
ワークフロー
1. 情報収集
ユーザーに以下を聞く:
対象プラグイン - どのプラグインにフックを追加するか
plugins/ディレクトリから既存プラグインを一覧表示
イベント - いつ実行するか
PreToolUse: ツール実行前(ブロック可能、matcher 必須)PostToolUse: ツール実行後(matcher 必須)UserPromptSubmit: ユーザープロンプト送信時Notification: 通知時Stop: レスポンス完了時SubagentStop: サブエージェント完了時PreCompact: Compact 操作前SessionStart: セッション開始時SessionEnd: セッション終了時
マッチャー(PreToolUse / PostToolUse の場合のみ)
- 例:
Bash,Write,Edit|Write,*(すべて)
- 例:
フックタイプ
command: Bash コマンドを実行prompt: LLM(Haiku)で評価
実行するコマンド(type: command の場合)
- 例:
npm run lint,echo "完了"
- 例:
2. 検証
- プラグインが存在するか確認
- イベントが有効か確認
- PreToolUse / PostToolUse の場合、マッチャーが指定されているか確認
イベント一覧
| イベント | matcher | 説明 |
|---|---|---|
PreToolUse |
必須 | ツール実行前(ブロック可能) |
PostToolUse |
必須 | ツール実行後 |
UserPromptSubmit |
不要 | ユーザープロンプト送信時 |
Notification |
不要 | 通知時 |
Stop |
不要 | レスポンス完了時 |
SubagentStop |
不要 | サブエージェント完了時 |
PreCompact |
不要 | Compact 操作前 |
SessionStart |
不要 | セッション開始時 |
SessionEnd |
不要 | セッション終了時 |
3. settings.json の hooks セクションを更新
plugins/{plugin-name}/.claude/settings.json の hooks セクションを更新(ファイルがなければ作成):
PreToolUse / PostToolUse の場合(matcher 必須):
{
"hooks": {
"{イベント}": [
{
"matcher": "{マッチャー}",
"hooks": [
{
"type": "command",
"command": "{コマンド}"
}
]
}
]
}
}
その他のイベントの場合(matcher 不要):
{
"hooks": {
"{イベント}": [
{
"hooks": [
{
"type": "command",
"command": "{コマンド}"
}
]
}
]
}
}
既存の hooks セクションがある場合は、適切なイベントに追加する。
4. プラグイン README を更新
plugins/{plugin-name}/README.md のフックセクションにフックを追加。
5. 報告
作成されたファイルと次のステップを表示:
フックを作成しました: {イベント} {マッチャー(あれば)}
更新:
- plugins/{plugin-name}/.claude/settings.json
- plugins/{plugin-name}/README.md
次のステップ:
- /create-hook で別のフックを追加
- /create-command でコマンドを追加
- /create-skill でスキルを追加
- /create-subagent でサブエージェントを追加
重要な注意事項
- ✅ PreToolUse / PostToolUse には必ず matcher を指定
- ✅ settings.json の hooks セクションに設定
- ❌ matcher が必要なイベントで matcher を省略しない