hook-scope-guide

フックスコープの選択ガイド

概要

このスキルでは、目的、対象ユーザー、永続性の要件に基づいて、Claude Code のフックを配置する場所を選択します。

使用しない場合

• フック自体を作成するとき（abstract:hook-authoring を使用）
• 既存のフックを評価するとき（abstract:hooks-eval を使用）

選択の枠組み

フックスコープは、対象ユーザー、バージョン管理の要否、永続させる期間という3つの質問で決まります。プラグインフック（プラグイン内の hooks/hooks.json）は、プラグインが有効な間、そのプラグインのユーザーに適用されます。プロジェクトフック（.claude/settings.json）はチームに適用され、コミットされます。グローバルフック（~/.claude/settings.json）は自分だけに適用され、すべてのセッションで有効になり、コミットされることはありません。

質問ツリー、スコープごとの設定と例、読み込みの優先順位、セキュリティ上の考慮事項、移行、トラブルシューティングについては、 plugins/abstract/skills/hook-authoring/modules/scope-selection.md にまとめて記載されています。選択する前にお読みください。エージェントを認識する SessionStart フックについては、abstract:hook-authoring の「フックイベントの種類」で説明しています。

関連スキル

• abstract:hook-authoring - フックのルール構文とパターンについて
• abstract:validate-plugin - フックを含むプラグイン構造の検証について

参考資料

• Claude Code フックのドキュメント
• 設定

完了基準

• 単一のスコープ（プラグイン／プロジェクト／グローバル）が選択され、その根拠が3つの選択質問（対象ユーザー、バージョン管理、永続性）のうち少なくとも2つに沿っている。
• 選択したスコープのファイルの場所（hooks/hooks.json、.claude/settings.json、または ~/.claude/settings.json）が存在することを確認するか、正しいパスに作成する。
• プラグインフックでは、plugin.json に "hooks": "./hooks/hooks.json" を追加しない（二重読み込み防止）。フックのデプロイ前に、この設定がないことを確認する。
• グローバルフックには、このマシン上のすべての Claude セッションに適用されることを確認するセキュリティ上の注意書きを付ける。