hooks-management
Создание и управление хуками Claude Code
Управление хуками Claude Code требует понимания шаблонов событийно‑ориентированной автоматизации. Этот навык предоставляет пошаговые рабочие процессы и подробную документацию по созданию, обновлению, настройке и устранению неполадок хуков для любого типа событий.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "hooks-management". Create a new hook that validates JSON input on the PreToolUse event
النتيجة المتوقعة:
- Hook created at: .claude/hooks/validate-json.py
- Configuration to add to .claude/settings.local.json:
- {
- "hooks": {
- "PreToolUse": [
- {
- "matcher": "*",
- "hooks": [
- { "type": "command", "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/validate-json.py" }
- ]
- }
- ]
- }
- }
- Test command: echo '{"tool_name": "Write", "tool_input": {}}' | python .claude/hooks/validate-json.py
استخدام "hooks-management". Why is my hook not executing on the UserPromptSubmit event?
النتيجة المتوقعة:
- Checking hook configuration...
- 1. Verify the hook is registered in .claude/settings.local.json
- 2. Ensure the event name matches exactly: "UserPromptSubmit"
- 3. Test with echo: echo '{"prompt": "/test"}' | python .claude/hooks/your-hook.py
- 4. Check that the script has execute permissions
- 5. Verify exit code is 0 for successful execution
التدقيق الأمني
آمنStatic scanner flagged patterns in documentation markdown files. After manual review, all findings are FALSE POSITIVES. The skill contains only documentation, task workflows, and reference materials for legitimate Claude Code hooks. No actual malicious code or exploit patterns exist.
عوامل الخطر
⚙️ الأوامر الخارجية (3)
📁 الوصول إلى نظام الملفات (2)
🔑 متغيرات البيئة (1)
درجة الجودة
ماذا يمكنك بناءه
Создание пользовательских обработчиков событий
Создавайте хуки, которые реагируют на конкретные события Claude Code, такие как PreToolUse, PostToolUse, Stop или UserPromptSubmit. Автоматизируйте валидацию, логирование или контроль соблюдения проектных политик.
Реализация хуков безопасности и валидации
Создавайте хуки, которые проверяют команды перед выполнением, блокируют опасные операции, логируют события безопасности и автоматически обеспечивают соблюдение проектных политик безопасности.
Обеспечение соблюдения рабочих процессов разработки
Создавайте хуки, которые обеспечивают соблюдение TDD‑процессов, отслеживают завершение этапов, проверяют планы перед реализацией и обеспечивают единые практики разработки в командах.
جرّب هذه الموجهات
Create a new Claude Code hook that runs on the Stop event. The hook should validate that all tasks in the plan are complete before allowing Claude to stop.
Update the session_start.py hook to also load user preferences from a config file and set them in the shared cache.
The post_tool_use hook is not executing correctly. Test it using the echo method to diagnose the issue.
Add a security validation module to the pre_tool_use hook that blocks commands containing dangerous patterns like rm -rf or direct path access to /etc.
أفضل الممارسات
- Всегда тестируйте хуки, передавая echo в stdin перед развертыванием — никогда не создавайте временные тестовые файлы
- По возможности используйте Python вместо shell‑скриптов для лучшей обработки ошибок и кроссплатформенной совместимости
- Реализуйте идемпотентные операции, чтобы многократный запуск хуков давал одинаковый результат
- Возвращайте корректные коды завершения: 0 — разрешить, 2 — заблокировать, другие ненулевые — ошибки без блокировки
تجنب
- Никогда не хардкодьте учетные данные или секреты в скриптах хуков
- Никогда не создавайте хуки, которые могут вызывать бесконечные циклы или зависать навсегда
- Никогда не обходите проверки безопасности или контроль доступа
- Никогда не пишите сложную логику в хуках — держите их простыми и сфокусированными на одной ответственности