الخطافات — اجعل الوكيل يطيع قواعدك

يمكنك طلب من الوكيل تشغيل المُنسِّق بعد كل تعديل. أو يمكنك ضمان ذلك. الخطافات هي أوامر shell يشغّلها Claude Code تلقائياً في نقاط محددة من حلقته — تحول "يرجى التذكر" إلى "دائماً".

الأحداث التي ستستخدمها فعلاً

• PostToolUse — بعد نجاح أداة. نسّق أو lint الملف المُعدَّل للتو.
• PreToolUse — قبل تشغيل أداة. افحص واحجب الاستدعاءات الخطرة.
• UserPromptSubmit — أدرج السياق قبل أن يرى النموذج موجزك.
• SessionStart / Stop — حمّل السياق عند البداية، أخبر عند النهاية.

توصيل واحد

الخطافات توجد تحت مفتاح hooks في settings.json. كل حدث يرسم إلى matchers (regex على اسم الأداة) وأوامر:

{
  "hooks": {
    "PostToolUse": [
      { "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "npx prettier --write \"$CLAUDE_FILE_PATHS\"" }] }
    ]
  }
}

رموز الخروج هي قناة التحكم

• 0 — نجاح؛ يستمر الوكيل.
• 2 — خطأ حجب؛ الإجراء يُمنع وstderr يُوجَّه مرة أخرى بحيث يمكن للوكيل أن يعدّل.
• رموز أخرى غير صفر — خطأ غير حجب، يُسجَّل.

الوصفات التي تدفع ثمنها

• تنسيق تلقائي عند التعديل — PostToolUse + Edit|Write.
• احجب rm -rf / force-push — PreToolUse + Bash، اخرج 2 عند المطابقة.
• مسح السر قبل الكتابة — PreToolUse + Write، احجب عند كشف المفاتيح.
• نقرة سطح المكتب عند الحاجة للإدخال — Notification.

الخطافات تفرض السلوك. بعد ذلك نُغلّف الغرض — سير عمل الفريق القابلة لإعادة الاستخدام — كأوامر شرطة مائلة مخصصة.