npx claudepluginhub kentanakae/claude-code-plugins --plugin coreThis skill is limited to using the following tools:
references/hooks.mdStep 0: プランモード解除
プランモードが有効な場合は、ExitPlanMode ツールを呼び出して解除してください。 プランモードでない場合はこのステップをスキップしてください。
Step 1: サブコマンド判定
$ARGUMENTS[0]がcreate→ Step 3（新規作成フロー）へ$ARGUMENTS[0]がupdate→ Step 4（更新フロー）へ- 未指定 or 上記以外 → AskUserQuestion で create / update を選択させてから対応する Step へ
Step 2: ドキュメント確認と差分チェック
WebFetchで https://code.claude.com/docs/ja/hooks.md を取得し、フックイベント一覧テーブルから全イベント名を抽出する。以下の既知イベント一覧と比較し、差分があれば警告してこのスキル（edit-hook）のアップデートが必要な旨を伝える。差分がなければ次の Step に進む。
既知イベント: SessionStart, UserPromptSubmit, PreToolUse, PermissionRequest, PostToolUse, PostToolUseFailure, Notification, SubagentStart, SubagentStop, Stop, TeammateIdle, TaskCompleted, InstructionsLoaded, ConfigChange, WorktreeCreate, WorktreeRemove, PreCompact, SessionEnd
既知ハンドラータイプ: command, http, prompt, agent
Step 3: 新規作成フロー
Step 3-1: フック設計インタビュー
ユーザーに以下を確認する（AskUserQuestionを使用）:
-
フックの目的: 何を自動化・制御したいか（自由記述で確認）
-
フックイベント: どのライフサイクルポイントで発火するか
- 詳細は ./references/hooks.md の「フックイベント一覧」を参照
-
マッチャー: イベントのフィルタリング条件（該当イベントがマッチャーをサポートする場合）
- 詳細は ./references/hooks.md の「マッチャーパターン」を参照
-
ハンドラータイプ: 実行するハンドラーの種類
command: シェルコマンド実行（最も一般的）http: HTTP POSTリクエスト送信prompt: LLMプロンプト評価（単一ターン）agent: サブエージェント起動（ツール使用可能）
-
ハンドラー詳細: タイプに応じた設定
- command: 実行するコマンド、非同期実行の有無
- http: URL、ヘッダー、許可する環境変数
- prompt/agent: プロンプトテキスト、モデル指定
- 共通: タイムアウト、ステータスメッセージ
-
設定ファイルの場所:
- ユーザー設定（
~/.claude/settings.json）- 全プロジェクトに適用 - プロジェクト設定（
.claude/settings.json）- このプロジェクトのみ、リポジトリにコミット可能 - ローカル設定（
.claude/settings.local.json）- このプロジェクトのみ、gitignored
- ユーザー設定（
-
フックスクリプトが必要か: コマンドハンドラーの場合、インラインコマンドか外部スクリプトか
- インライン: 単純なワンライナー（
echo,jq等） - 外部スクリプト: 複雑なロジック →
.claude/hooks/にスクリプトファイルを作成
- インライン: 単純なワンライナー（
Step 3-2: フックスクリプト作成（必要な場合）
外部スクリプトが必要な場合:
.claude/hooks/ディレクトリにスクリプトファイルを作成- スクリプトの内容:
- stdin から JSON 入力を読み取る（
jq等で解析） - 必要なロジックを実行
- 必要に応じて stdout に JSON 出力を返す
- 適切な終了コードを返す（0: 成功、2: ブロック）
- stdin から JSON 入力を読み取る（
- 実行権限を付与（
chmod +x）
スクリプト作成時の参照情報:
- JSON入力フィールドは ./references/hooks.md の「共通入力フィールド」と各イベントの入力セクションを参照
- JSON出力形式は ./references/hooks.md の「JSON出力」セクションを参照
- 終了コードの動作は ./references/hooks.md の「終了コード」セクションを参照
Step 3-3: 設定ファイルへの登録
- 対象の settings.json を Read で読み込む（存在しない場合は新規作成）
hooksキー配下に新しいフック設定を追加- 既存の hooks 設定がある場合はマージ（既存設定を壊さない）
- Edit または Write で settings.json を更新
設定構造:
{
"hooks": {
"<EventName>": [
{
"matcher": "<pattern>",
"hooks": [
{
"type": "command",
"command": "<command-or-script-path>",
"timeout": 60
}
]
}
]
}
}
Step 3-4: 動作確認案内
作成完了後、以下を案内する:
- フックは次回のセッション開始時から有効になる（セッション中の変更は
/hooksメニューでレビューが必要） /hooksメニューでフックの確認・管理が可能- 詳細モード（
Ctrl+O）でフック実行ログを確認可能
Step 4: 更新フロー
Step 4-1: 対象フックの特定
以下の設定ファイルを Glob と Read で検索し、既存の hooks 設定を収集する:
~/.claude/settings.json.claude/settings.json.claude/settings.local.json
全ての設定ファイルから hooks セクションを読み取り、登録されているフック一覧を表示する。AskUserQuestion で更新対象を選択させる。
Step 4-2: 現在の設定の読み込みと表示
対象フックについて以下を整理して表示する:
- 設定ファイル: どのファイルに定義されているか
- イベント: フックイベント名
- マッチャー: フィルタリング条件
- ハンドラー一覧: 各ハンドラーのタイプ・コマンド・設定
- 関連スクリプト: 外部スクリプトがある場合はその内容も表示
Step 4-3: 更新箇所の選択
AskUserQuestion（multiSelect: true）で更新したい箇所を選択させる:
- イベント・マッチャー: フックイベントやマッチャーパターンの変更
- ハンドラー設定: コマンド、URL、タイムアウト等の変更
- フックスクリプト: 外部スクリプトの内容変更
- フックの追加: 同じイベントに新しいハンドラーを追加
- フックの削除: 既存ハンドラーの削除
Step 4-4: 選択項目の更新インタビュー
選択された項目について、現在の値を表示しながら変更内容を確認する。
Step 4-5: 更新実行
- 変更内容のプレビューを表示（変更前 → 変更後の diff 形式）
- AskUserQuestion で適用確認
- 変更を反映:
- settings.json の変更 → Edit で部分更新
- スクリプトの変更 → Edit で部分更新、大幅変更は Write
- 更新結果を表示
フックイベントクイックリファレンス
| イベント | 発火タイミング | マッチャー |
|---|---|---|
PreToolUse | ツール実行前 | ツール名 |
PostToolUse | ツール成功後 | ツール名 |
PostToolUseFailure | ツール失敗後 | ツール名 |
PermissionRequest | 権限ダイアログ表示時 | ツール名 |
UserPromptSubmit | プロンプト送信時 | なし |
Stop | Claude応答完了時 | なし |
SessionStart | セッション開始時 | startup/resume/clear/compact |
SessionEnd | セッション終了時 | clear/logout/prompt_input_exit/other |
SubagentStart | サブエージェント起動時 | エージェントタイプ |
SubagentStop | サブエージェント完了時 | エージェントタイプ |
Notification | 通知送信時 | 通知タイプ |
TeammateIdle | チームメイトアイドル時 | なし |
TaskCompleted | タスク完了時 | なし |
InstructionsLoaded | CLAUDE.md読込時 | なし |
ConfigChange | 設定変更時 | 設定ソース |
WorktreeCreate | ワークツリー作成時 | なし |
WorktreeRemove | ワークツリー削除時 | なし |
PreCompact | コンパクション前 | manual/auto |
詳細なリファレンス情報は ./references/hooks.md を参照。
引数
/edit-hook create: 新しいフックを作成/edit-hook update: 既存フックを更新/edit-hook: サブコマンド選択から開始