المهارات Hook Development
📦
Hook Development
v0.1.0 مراجعة المحتوى r1 مخاطر عالية ⚙️ الأوامر الخارجية📁 الوصول إلى نظام الملفات🔑 متغيرات البيئة🌐 الوصول إلى الشبكة
بناء خطافات Claude Code بأمان
تحتاج الفرق إلى خطافات موثوقة للتحقق من استخدام الأدوات وفرض قواعد سير العمل. توجه هذه المهارة مستخدمي Claude وCodex وClaude Code عبر أنماط تصميم الخطافات واختبارها وترحيلها.
يدعم: Claude Codex Code(CC)
توقف واطلب التأكيد قبل التثبيت.
راجع الخطة واحصل على موافقة صريحة من المستخدم قبل تغيير الملفات.
التثبيت باستخدام Agent لدي
انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.
طلب الوكيل
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.يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.
موارد مهيّأة لـ Agents
استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.
اختبرها
جارٍ استخدام "Hook Development". يطلب المستخدم إضافة خطاف يحظر عمليات كتابة الملفات غير الآمنة.
النتيجة المتوقعة:
تعيد المهارة تصميم PreToolUse مع خيارات المطابقة ومعايير الأمان وإرشادات المهلة الزمنية وخطوات الاختبار.
جارٍ استخدام "Hook Development". يشارك المستخدم خطاف تحقق Bash حاليًا.
النتيجة المتوقعة:
تقدم المهارة خطة ترحيل تفصل فحوصات shell السريعة عن القرارات السياقية القائمة على المطالبات.
جارٍ استخدام "Hook Development". يريد المستخدم اختبار الخطافات قبل الإصدار.
النتيجة المتوقعة:
تقترح المهارة التحقق من المخطط، ومدخلات نموذجية، وفحوصات وضع التصحيح، ومراجعة linter قبل النشر.
التدقيق الأمني
مخاطر عاليةv10 • ١٩/٧/٢٠٢٦ فتح التقرير المرتبط بالإصدار
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 الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.
نسخ رابط التقرير
https://skillstore.io/skills/hook-development/audits/10?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportشارة Markdown
[](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/10اقتباس BibTeX
@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 تم التحديث
hook-development
تقييم Skillstore 38
موثوقية الأدلة متوسط
استخدام Skillstore 20
تم التحديث
2026-09-09
anthropics-hook-development
تقييم Skillstore 38
موثوقية الأدلة متوسط
استخدام Skillstore 16
تم التحديث
2026-09-09
davila7-hook-development
تقييم Skillstore 38
موثوقية الأدلة متوسط
استخدام Skillstore 13
تم التحديث
2026-09-09
تقييم Skillstore
سبب هذا التقييم موثوقية الأدلة: متوسط 68
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
71
المجتمع
65
الامتثال للمواصفات
ما الذي يمكنك بناؤه
إضافة خطافات أمان الملفات
أنشئ خطافات PreToolUse تراجع مسارات الكتابة والملفات الحساسة واجتياز المسارات قبل تشغيل الأدوات.
فرض إكمال سير العمل
صمم خطافات Stop تتحقق من الاختبارات والبناء والأسئلة غير المجاب عنها قبل أن ينهي الوكيل العمل.
ترحيل منطق الخطافات
انقل فحوصات shell الهشة إلى خطافات قائمة على المطالبات مع إبقاء الفحوصات الحتمية السريعة حيث تكون مفيدة.
جرّب هذه الموجّهات
إنشاء خطاف أساسي
أنشئ خطاف PreToolUse لـ Write وEdit. يجب أن يحظر مسارات النظام وملفات بيانات الاعتماد واجتياز المسارات.
إضافة سياق الجلسة
صمم خطاف SessionStart يكتشف نوع مشروعي. خزّن فقط قيم البيئة الآمنة للخطافات اللاحقة.
ترحيل فحوصات Bash
راجع خطاف الأوامر الحالي هذا. أوصِ بأي الفحوصات يجب أن تصبح قائمة على المطالبات وأيها يجب أن تبقى حتمية.
تخطيط مجموعة خطافات
صمم استراتيجية خطافات لإضافتي. ضمّن PreToolUse وPostToolUse وStop وخطوات الاختبار وقواعد التسجيل الآمن.
أفضل الممارسات
- فضّل الخطافات القائمة على المطالبات للقرارات السياقية وخطافات الأوامر للفحوصات الحتمية السريعة.
- تحقق من جميع مدخلات خطافات الأوامر واقتبسها قبل استخدام المسارات أو الأوامر أو قيم البيئة.
- اختبر الخطافات باستخدام مدخلات نموذجية، والتحقق من المخطط، ووضع التصحيح، وحالات الفشل قبل النشر.
تجنب
- الثقة بمدخلات الأداة الخام دون تحقق أو JSON escaping.
- تسجيل حمولات الخطافات الكاملة في أنظمة خارجية أو ملفات تدقيق دائمة.
- الاعتماد على ترتيب تنفيذ الخطافات أو توقع أن تعيد الجلسات الحالية تحميل الخطافات المتغيرة.
الأسئلة المتكررة
ما الذي تساعدني هذه المهارة على بنائه؟
تساعد في إنشاء خطافات Claude Code تتحقق من استخدام الأدوات، وتحمل السياق، وتفرض السياسات، وتختبر سلوك الخطافات.
هل تدعم الخطافات القائمة على المطالبات؟
نعم. تركز على الخطافات القائمة على المطالبات لسير عمل PreToolUse وStop وSubagentStop وUserPromptSubmit.
هل ما زال بإمكاني استخدام خطافات الأوامر؟
نعم. تشرح المهارة خطافات الأوامر للفحوصات الحتمية، والأدوات الخارجية، والمنطق الحساس للأداء.
هل تتضمن أمثلة قابلة للتشغيل؟
نعم. تتضمن أمثلة لخطافات shell وسكربتات مساعدة، لكنها تتطلب مراجعة أمنية محلية قبل استخدامها في الإنتاج.
هل ستُطبق تعديلات الخطافات فورًا؟
عادة لا. يحمل Claude Code إعدادات الخطافات عند بدء الجلسة، لذلك تتطلب التغييرات عادة إعادة التشغيل.
هل هذا مخصص لـ Claude Code فقط؟
مفاهيم الخطافات مخصصة لإضافات Claude Code. كما تساعد بيانات marketplace الوصفية مستخدمي Claude وCodex في العثور عليها.
تفاصيل المطور
المؤلف
anthropicsالترخيص
MIT
إصدار المؤلف
v0.1.0
مراجعة Skillstore
r1
المستودع
https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev/skills/hook-developmentمرجع
6e2dddf587274c5f8c929a916ca092529545819b
حداثة الصيانة
٢١/٧/٢٠٢٦
الاستخدام
17 تنزيلات · 259 مشاهدات
بنية الملفات