بقلم: ليلى | محررة أدوات المطورين · صوت تحريري بإشراف بشري
بدلاً من قضاء ساعات في كتابة كود التحليل والتحقق، يمكن للمطورين الآن استخدام حزمة `claude-hook-utils` للتركيز على المنطق الأساسي لخطافاتهم. تُحل هذه الحزمة المشكلة المؤلمة للكود المكرر في بناء خطافات Claude Code عبر واجهة برمجية موحدة ونمط تطويري واضح.
تعمل خطافات Claude Code في نقاط زمنية محددة لتوسيع قدرات النظام. `PreToolUse` تُفعّل قبل تنفيذ أي أداة للتحقق من مسارات الملفات أو منع العمليات الخطيرة، `PostToolUse` تعمل بعد اكتمال العمليات لتسجيل النتائج أو تشغيل إجراءات متابعة، `UserPromptSubmit` تتدخل عند إرسال المستخدم للأوامر للتحقق منها أو إضافة سياق، و`SessionStart` تُهيئ الحالة عند بداية جلسة جديدة.
المشكلة التقليدية تكمن في أن كل خطاف يحتاج نفس الكود: تحليل JSON من stdin، التحقق من هيكل البيانات، تنسيق الاستجابات بالمخطط الصحيح، والتعامل مع الأخطاء بأمان. `claude-hook-utils` تُدير كل هذا تلقائياً.
- تثبيت الحزمة وإعداد الفئة الأساسية: ثبت الحزمة بـ `pip install claude-hook-utils` ثم أنشئ فئة ترث من `HookHandler` واكتب فقط منطق التحقق المطلوب في دوال الخطافات المناسبة
- التحقق من بنية ملفات Vue: استخدم `file_path_matches(‘**/*.vue’)` للتحديد ثم فحص ترتيب العلامات `
