| name | hooks-creator |
| description | VS Code の Agent hooks（ライフサイクルフック）を設計・作成・レビューする。.github/hooks/*.json、hook、PreToolUse、PostToolUse、SessionStart、Stop、UserPromptSubmit、PreCompact、SubagentStart、SubagentStop、ライフサイクル自動化、セキュリティポリシー、コード品質自動化に言及したときに使用する。 |
Agent Hooks 作成スキル（VS Code / GitHub Copilot）
このSkillは、VS Code の Agent hooks を設計し、ワークスペースへ追加する。Hooksはエージェントセッションのライフサイクルポイントでシェルコマンドを確定的に実行し、セキュリティ強制・コード品質自動化・監査ログなどを実現する。
まず決める
- 目的: 何を自動化するか（セキュリティ制御、フォーマット、ログ、コンテキスト注入、承認制御）
- イベント: どのライフサイクルポイントで発火するか
- スクリプト: 実行するコマンドまたはスクリプト
ライフサイクルイベント一覧
| イベント | タイミング | 主な用途 |
|---|
SessionStart | 新しいセッション開始時 | リソース初期化、プロジェクトコンテキスト注入 |
UserPromptSubmit | ユーザーがプロンプト送信時 | リクエスト監査、システムコンテキスト注入 |
PreToolUse | ツール実行前 | 危険操作のブロック、承認制御、入力変更 |
PostToolUse | ツール実行後 | フォーマッタ実行、結果ログ、追加アクション |
PreCompact | コンテキスト圧縮前 | 重要コンテキストの退避 |
SubagentStart | サブエージェント生成時 | サブエージェントの追跡・初期化 |
SubagentStop | サブエージェント完了時 | 結果集約、クリーンアップ |
Stop | セッション終了時 | レポート生成、リソース後処理 |
作成フロー
1) 配置場所を決める
| スコープ | パス |
|---|
| ワークスペース（チーム共有） | .github/hooks/*.json |
| ワークスペース（Claude 互換） | .claude/settings.local.json, .claude/settings.json |
| ユーザー全体 | ~/.copilot/hooks, ~/.claude/settings.json |
| Custom Agent 単位 | .agent.md frontmatter の hooks |
ワークスペース hooks がユーザー hooks より優先される。通常は .github/hooks/ に JSON ファイルを作成する。追加の探索場所は chat.hookFilesLocations で制御できる。
2) フック設定ファイルを書く
JSON 形式で hooks オブジェクトを記述する。VS Code は Claude Code / Copilot CLI の hook format と互換のある JSON を読み込める:
{
"hooks": {
"<イベント名>": [
{
"type": "command",
"command": "./scripts/my-hook.sh",
"timeout": 15
}
]
}
}
3) コマンドプロパティを設定する
| プロパティ | 型 | 説明 |
|---|
type | string | 必須。"command" 固定 |
command | string | 実行コマンド（クロスプラットフォームデフォルト） |
windows | string | Windows 固有コマンド |
linux | string | Linux 固有コマンド |
osx | string | macOS 固有コマンド |
cwd | string | 作業ディレクトリ（リポジトリルートからの相対パス） |
env | object | 追加の環境変数 |
timeout | number | タイムアウト秒数（デフォルト: 30） |
OS固有コマンドが定義されていない場合、command にフォールバックする。
4) フックスクリプトを作成する
フックは stdin で JSON を受け取り、stdout で JSON を返す。
共通入力フィールド:
{
"timestamp": "2026-02-09T10:30:00.000Z",
"cwd": "/path/to/workspace",
"sessionId": "session-identifier",
"hookEventName": "PreToolUse",
"transcript_path": "/path/to/transcript.json"
}
共通出力フィールド:
{
"continue": true,
"stopReason": "理由（モデルに表示）",
"systemMessage": "ユーザーに表示するメッセージ"
}
終了コード:
| コード | 意味 |
|---|
0 | 成功: stdout を JSON としてパース |
2 | ブロッキングエラー: 処理を停止しエラーをモデルに表示 |
| その他 | 非ブロッキング警告: 警告を表示し処理を続行 |
5) テストとデバッグ
/hooks コマンドで対話的にフック設定を管理できる/create-hook を使うとイベント種別と雛形を含む初期設定を生成できる- Chat Customizations editor（Preview）から hooks の一覧と編集を確認できる
- 出力パネルで GitHub Copilot Chat Hooks チャンネルを確認する
- Chat ビューを右クリック → Diagnostics でフックの読み込み状態を確認する
- スクリプトに実行権限があるか確認する（
chmod +x）
- agent-scoped hooks を使う場合は
chat.useCustomAgentHooks が有効か確認する
イベント別の入出力詳細
詳細な入出力仕様は references/EVENTS.md を参照。
よくあるパターン
テンプレートと実装例は references/TEMPLATES.md を参照。
セキュリティ上の注意
- フックはVS Codeと同じ権限でシェルコマンドを実行する
- 共有リポジトリのフックスクリプトは使用前に必ずレビューする
- スクリプト内にシークレットをハードコードしない（環境変数やセキュアストレージを使う）
- stdin からの入力を必ずバリデーション・サニタイズする（インジェクション防止）
chat.tools.edits.autoApprove 設定でフックスクリプトの自動編集を禁止することを推奨する- Claude 形式の matcher は VS Code では現在無視されるため、対象ツールの絞り込みはスクリプト内で判断する
期待する出力
.github/hooks/<name>.json の新規作成、または既存フック設定の改善- 必要に応じてフックスクリプト（
.github/hooks/scripts/ 等）を作成する
- 変更時は「何をどう変えたか（イベント/コマンド/セキュリティ影響）」を短く添える
参照
