スキル Hook Development
📦
Hook Development
v0.1.0 コンテンツリビジョン r1 高リスク ⚙️ 外部コマンド📁 ファイルシステムへのアクセス🔑 環境変数🌐 ネットワークアクセス
Claude Code フックを安全に構築する
チームには、ツール使用を検証し、ワークフロールールを適用するための信頼性の高いフックが必要です。このスキルは、Claude、Codex、Claude Code ユーザーに対して、フックの設計、テスト、移行パターンを案内します。
対応: Claude Codex Code(CC)
インストール前に停止して確認を求めてください。
計画を確認し、ファイルを変更する前にユーザーの明示的な同意を得てください。
自分のエージェントでインストール
このリクエストをエージェントにコピーしてください。正規の Skill ページとマニフェストが含まれています。
エージェントリクエスト
Review the Skillstore skill "Hook Development" from https://skillstore.io/skills/hook-development.md and its manifest at https://skillstore.io/api/skills/hook-development/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.エージェントは引き続き計画を提示し、セキュリティポリシーで必要な確認を求める必要があります。
エージェントが読めるリソース
AI エージェント、クローラー、スクリプトがページ全体ではなく整理されたコンテキストを必要とする場合は、これらのリンクを使ってください。
テストする
「Hook Development」を使用しています。 ユーザーが、安全でないファイル書き込みをブロックするフックの追加を依頼する。
期待される結果:
このスキルは、マッチャーの選択、安全基準、タイムアウトの指針、テスト手順を含む PreToolUse 設計を返します。
「Hook Development」を使用しています。 ユーザーが既存の Bash 検証フックを共有する。
期待される結果:
このスキルは、高速なシェルチェックとコンテキストに基づくプロンプトベースの判断を分離する移行計画を提供します。
「Hook Development」を使用しています。 ユーザーがリリース前にフックをテストしたい。
期待される結果:
このスキルは、デプロイ前にスキーマ検証、サンプル入力、デバッグモードチェック、リンターレビューを提案します。
セキュリティ監査
高リスクv10 • 2026/7/19 バージョン別レポートを開く
Most static alerts are false positives caused by Markdown formatting, shebangs, defensive deny checks, and test fixtures. Confirmed risks include shell injection in the test runner, unsafe jq filter construction, and predictable temporary files. Semantic review also found prompt-injection exposure, fail-open validators, SQL injection, sensitive logging, and unpinned package execution.
11
スキャンされたファイル
2,781
解析済み行数
21
レビュー項目
0
誤検知を無視
確認済みのセキュリティ上の懸念 (6)
高
Prompt-Based Authorization Is Injection-Prone
Security prompts interpolate untrusted tool commands and input directly into authorization instructions. Crafted tool input can instruct the model to ignore policy and approve a dangerous operation.
The examples directly place $TOOL_INPUT.command or $TOOL_INPUT inside prompts that return permission decisions, without isolation or injection-resistant handling.
高
Command Validator Fails Open on Deny-List Bypasses
The Bash validator blocks a few literal substrings and approves every unmatched command. Equivalent destructive syntax, wrappers, aliases, and encoded commands can bypass the checks.
The code contains only three narrow checks and ends with unconditional approval, while the documented security goal is to block dangerous commands.
高
Write Validator Does Not Resolve Effective Paths
The write validator checks raw path substrings but never canonicalizes paths or resolves symlinks. A permitted path can still target a protected or sensitive file.
The implementation compares the supplied string directly and then approves it; no realpath, directory boundary, or symlink check is present.
高
Untrusted Hook Input Is Concatenated into SQL
The database logging example places raw hook input inside a quoted INSERT statement. A single quote in input can alter the SQL and execute unintended database operations.
The psql command constructs SQL by directly interpolating the complete stdin value, with no parameter binding or escaping.
高
Audit Example Persists Raw Potentially Sensitive Input
The audit example appends complete hook input to a persistent home-directory log. Tool input can contain source code, prompts, credentials, or other sensitive values.
The example writes the full input value without redaction, filtering, retention controls, or explicit restrictive file permissions.
中
Automatic Hook Runs an Unpinned Package Command
The quality hook invokes npx eslint automatically after file edits. Dependency resolution can execute untrusted project binaries or fetch package code outside a pinned toolchain.
The documented PostToolUse pattern runs npx from the active project without pinning the executable or requiring an installed trusted binary.
機能レビュー項目 (21)
これらは、このスキルに期待される可能性のある実際のローカル機能であるため、レビューが必要ですが、確認済みの悪意ある動作としてはカウントされません。
高
Shell command substitution
output=$(timeout "$TIMEOUT" bash -c "cat '$TEST_INPUT' | $HOOK_SCRIPT" 2>&1)
The script inserts caller-controlled file paths into a bash -c command string. A crafted existing filename can break quoting and execute additional shell commands.
中
Temp directory access
echo "$risk_level" > /tmp/hook-state-$$
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
中
Temp directory access
risk_level=$(cat /tmp/hook-state-$$ 2>/dev/null || echo "unknown")
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
中
Temp directory access
cache_file="/tmp/hook-cache-$cache_key"
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
中
Temp directory access
echo "0" > /tmp/test-count-$$
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
中
Temp directory access
echo "0" > /tmp/build-count-$$
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
中
Temp directory access
count=$(cat /tmp/test-count-$$ 2>/dev/null || echo "0")
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
中
Temp directory access
echo $((count + 1)) > /tmp/test-count-$$
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
中
Temp directory access
test_count=$(cat /tmp/test-count-$$ 2>/dev/null || echo "0")
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
中
Temp directory access
rate_file="/tmp/hook-rate-$$"
The example uses a predictable shared /tmp pathname for mutable hook state. Another local process can precreate or replace it, enabling state tampering or symlink-based file clobbering.
中
Temp directory access
export CLAUDE_ENV_FILE="${CLAUDE_ENV_FILE:-/tmp/test-env-$$}"
The default environment file uses a predictable PID-based path in shared /tmp. A local attacker can race or precreate a symlink before the tested hook writes to it.
中
Shell command substitution
for event in $(jq -r 'keys[]' "$HOOKS_FILE"); do
Event names from the supplied JSON are iterated through unquoted command substitution. Whitespace and glob characters can split or alter names, causing validation bypasses.
中
Shell command substitution
for event in $(jq -r 'keys[]' "$HOOKS_FILE"); do
Event names from the supplied JSON are iterated through unquoted command substitution. Whitespace and glob characters can split or alter names, causing validation bypasses.
中
Shell command substitution
hook_count=$(jq -r ".\"$event\" | length" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
中
Shell command substitution
matcher=$(jq -r ".\"$event\"[$i].matcher // empty" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
中
Shell command substitution
hooks=$(jq -r ".\"$event\"[$i].hooks // empty" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
中
Shell command substitution
hook_array_count=$(jq -r ".\"$event\"[$i].hooks | length" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
中
Shell command substitution
hook_type=$(jq -r ".\"$event\"[$i].hooks[$j].type // empty" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
中
Shell command substitution
command=$(jq -r ".\"$event\"[$i].hooks[$j].command // empty" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
中
Shell command substitution
prompt=$(jq -r ".\"$event\"[$i].hooks[$j].prompt // empty" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
中
Shell command substitution
timeout=$(jq -r ".\"$event\"[$i].hooks[$j].timeout // empty" "$HOOKS_FILE")
The untrusted event name is interpolated into jq source code instead of passed with --arg. Crafted keys can change the jq filter and corrupt validation results.
リスク要因
⚙️ 外部コマンド (50)
examples/load-context.sh:1 examples/validate-bash.sh:8 examples/validate-bash.sh:11 examples/validate-bash.sh:1 examples/validate-write.sh:8 examples/validate-write.sh:11 examples/validate-write.sh:1 references/advanced.md:36 references/advanced.md:37 references/advanced.md:63 references/advanced.md:81 references/advanced.md:92 references/advanced.md:93 references/advanced.md:96 references/advanced.md:105 references/advanced.md:125 references/advanced.md:174 references/advanced.md:175 references/advanced.md:176 references/advanced.md:181 references/advanced.md:244 references/advanced.md:245 references/advanced.md:248 references/advanced.md:250 references/advanced.md:251 references/advanced.md:259 references/advanced.md:273 references/advanced.md:274 references/advanced.md:291 references/advanced.md:304 references/advanced.md:305 references/advanced.md:319 references/advanced.md:320 references/advanced.md:324 references/advanced.md:327 references/advanced.md:328 references/advanced.md:335 references/advanced.md:353 references/advanced.md:354 references/advanced.md:355 references/advanced.md:367 references/advanced.md:368 references/advanced.md:388 references/advanced.md:396 references/advanced.md:414 references/advanced.md:462 references/advanced.md:470 references/advanced.md:35 references/advanced.md:55 references/advanced.md:74
📁 ファイルシステムへのアクセス (45)
examples/validate-bash.sh:31 examples/validate-write.sh:26 references/advanced.md:358 references/advanced.md:358 references/advanced.md:105 references/advanced.md:181 references/advanced.md:250 references/advanced.md:259 references/advanced.md:281 references/advanced.md:295 references/advanced.md:97 references/advanced.md:105 references/advanced.md:177 references/advanced.md:237 references/advanced.md:238 references/advanced.md:250 references/advanced.md:251 references/advanced.md:259 references/advanced.md:323 references/advanced.md:413 references/advanced.md:419 references/migration.md:117 references/migration.md:165 references/patterns.md:268 references/patterns.md:306 scripts/README.md:86 scripts/README.md:89 scripts/test-hook.sh:155 scripts/test-hook.sh:227 scripts/test-hook.sh:34 scripts/test-hook.sh:35 scripts/test-hook.sh:40 scripts/test-hook.sh:50 scripts/test-hook.sh:51 scripts/test-hook.sh:63 scripts/test-hook.sh:64 scripts/test-hook.sh:75 scripts/test-hook.sh:76 scripts/test-hook.sh:87 scripts/test-hook.sh:88 scripts/test-hook.sh:171 scripts/test-hook.sh:173 scripts/validate-hook-schema.sh:32 SKILL.md:534 SKILL.md:550
🔑 環境変数 (1)
🌐 ネットワークアクセス (1)
監査者: codex 監査履歴を表示 →
このレポートを共有・引用
バージョン付き評価レポート、中立的なバッジ、埋め込みカード、引用を共有できます。Skillstore は証拠を報告しますが、この Skill が安全かどうかは判断しません。
レポートリンクをコピー
https://skillstore.io/skills/hook-development/audits/10?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdownバッジ
[](https://skillstore.io/skills/hook-development?utm_source=security_passport_badge)HTMLバッジ
<a href="https://skillstore.io/skills/hook-development?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/hook-development/security.svg" alt="Skillstore security assessment" loading="lazy"></a>埋め込みカード
<iframe src="https://skillstore.io/embed/skills/hook-development.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>学術引用 (APA · BibTeX · CFF)
APA形式の引用
anthropics. (2026). Hook Development security audit report (audit version 10) [Author version 0.1.0]. Skillstore. https://skillstore.io/skills/hook-development/audits/10BibTeX形式の引用
@techreport{anthropics-hook-development-2026,
author = {anthropics},
title = {Hook Development security audit report (audit version 10)},
institution = {Skillstore},
year = {2026},
number = {10},
url = {https://skillstore.io/skills/hook-development/audits/10},
note = {Author version 0.1.0}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "Hook Development security audit report (audit version 10)"
version: "0.1.0"
type: report
authors:
- name: "anthropics"
date-released: "2026-07-19"
url: "https://skillstore.io/skills/hook-development/audits/10"
identifiers:
- type: other
value: "skillstore:hook-development:audit:10"
description: "Skillstore immutable audit report identifier"
バリアントを比較
インストール可能なバリアント 3 件各作者のスキルは個別のインストール項目として維持されます。推奨バリアントは Skillstore の証拠で順位付けされます。
このバリアントが首位の理由
Skillstore での利用が多い
作者 / ソース Skillstore スコア 証拠の信頼度 Skillstore 利用状況 更新済み
anthropics-hook-development
Skillstore スコア 38
証拠の信頼度 中
Skillstore 利用状況 16
更新済み
2026-09-09
Skillstore スコア
このスコアの理由 証拠の信頼度: 中 68
アーキテクチャ
100
保守性
87
コンテンツ
71
コミュニティ
65
仕様準拠
作成できるもの
ファイル安全性フックを追加する
ツール実行前に書き込みパス、機密ファイル、パストラバーサルを確認する PreToolUse フックを作成します。
ワークフロー完了を強制する
エージェントが作業を終了する前に、テスト、ビルド、未回答の質問を確認する Stop フックを設計します。
フックロジックを移行する
壊れやすいシェルチェックをプロンプトベースのフックへ移行しつつ、有用な場面では高速で決定的なチェックを維持します。
これらのプロンプトを試す
基本的なフックを作成する
Write と Edit 用の PreToolUse フックを作成してください。システムパス、認証情報ファイル、パストラバーサルをブロックする必要があります。
セッションコンテキストを追加する
自分のプロジェクトタイプを検出する SessionStart フックを設計してください。後続のフック用には安全な環境値のみを保存してください。
Bash チェックを移行する
この既存のコマンドフックをレビューしてください。どのチェックをプロンプトベースにすべきか、どのチェックを決定的なままにすべきかを推奨してください。
フックスイートを計画する
自分のプラグイン向けのフック戦略を設計してください。PreToolUse、PostToolUse、Stop、テスト手順、安全なログ記録ルールを含めてください。
ベストプラクティス
- コンテキストに基づく判断にはプロンプトベースのフックを、高速で決定的なチェックにはコマンドフックを優先します。
- パス、コマンド、環境値を使用する前に、すべてのコマンドフック入力を検証し、クォートします。
- デプロイ前に、サンプル入力、スキーマ検証、デバッグモード、失敗ケースでフックをテストします。
回避
- 検証や JSON エスケープなしに、生のツール入力を信頼すること。
- 完全なフックペイロードを外部システムや永続的な監査ファイルに記録すること。
- フックの実行順序に依存したり、現在のセッションが変更済みフックを再読み込みすると期待したりすること。
よくある質問
このスキルは何の構築を支援しますか？
ツール使用を検証し、コンテキストを読み込み、ポリシーを適用し、フックの動作をテストする Claude Code フックの作成を支援します。
プロンプトベースのフックをサポートしていますか？
はい。PreToolUse、Stop、SubagentStop、UserPromptSubmit ワークフロー向けのプロンプトベースのフックに重点を置いています。
引き続きコマンドフックを使用できますか？
はい。このスキルは、決定的なチェック、外部ツール、パフォーマンスが重要なロジックのためのコマンドフックを説明します。
実行可能な例は含まれていますか？
はい。サンプルのシェルフックとユーティリティスクリプトを含みますが、本番利用前にローカルでのセキュリティレビューが必要です。
フックの編集はすぐに適用されますか？
通常はいいえ。Claude Code はセッション開始時にフック設定を読み込むため、変更には通常再起動が必要です。
これは Claude Code 専用ですか？
フックの概念は Claude Code プラグイン向けです。マーケットプレイスのメタデータは、Claude と Codex ユーザーがこのスキルを見つけるのにも役立ちます。
開発者情報
作成者
anthropicsライセンス
MIT
作者バージョン
v0.1.0
Skillstore リビジョン
r1
リポジトリ
https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev/skills/hook-development参照
6e2dddf587274c5f8c929a916ca092529545819b
メンテナンスの新しさ
2026/7/21
利用状況
17 ダウンロード · 259 閲覧
ファイル構成