حظر الأوامر الخطرة باستخدام PreToolUse hook

الهدف

أضف فحص سياسة حتمياً قبل التنفيذ إلى حلقة أدوات الوكيل.

الخطوات

1. عرّف hook غير متزامن يستقبل input_data, tool_use_id, context وافحص حقول الأداة المستهدفة فقط. [hooks]
2. سجّل عبر ClaudeAgentOptions(hooks={"PreToolUse":[HookMatcher(matcher="Bash", hooks=[...])]}) وطابق اسم الأداة المقصودة. [hooks]
3. أعد hookEventName="PreToolUse" وpermissionDecision="deny" وسبباً؛ واختبر أمثلة محظورة ومسموحاً بها. [hooks]

طريقة التحقق

لا ينفذ الأمر المحظور ويعيد سبب الرفض؛ وتظل الأوامر الآمنة خاضعة لمعالجة الصلاحيات.

معالجة الأعطال

إذا لم يلتقط الفحص الحالة، فتحقق من الحدث والمطابق وشكل الإرجاع؛ ولا تعتمد فقط على مطابقة نصية هشة.