إعداد hooks لـ Claude Code
يتكامل Failproof AI مع Claude Code عبر نظام hooks الخاص به. عند تشغيلfailproofai policies --install، يسجل أوامر hook في ملف settings.json الخاص بـ Claude Code التي تُشغّل عند كل استدعاء أداة.
1
تثبيت failproofai
2
تفعيل جميع السياسات المدمجة
3
التحقق من تسجيل hooks
PreToolUse و PostToolUse و Notification و Stop.4
تشغيل Claude Code
sudo rm -rf / - سيتم حظره.إعداد hooks لـ Agents SDK
إذا كنت تبني باستخدام Agents SDK، يمكنك استخدام نفس نظام hooks برمجياً.1
تثبيت failproofai في مشروعك
2
تكوين hooks في وكيلك
مرر أوامر hook عند إنشاء عملية الوكيل. تُشغّل الـ hooks بنفس الطريقة كما في Claude Code - عبر JSON في stdin/stdout:
3
كتابة سياسة مخصصة لوكيلك
4
تثبيت السياسة المخصصة
حظر الأوامر المدمرة
الإعداد الأكثر شيوعاً - منع الوكلاء من إلحاق الضرر الذي لا يمكن إرجاعه.block-sudo- يحظر جميع أوامرsudoblock-rm-rf- يحظر حذف الملفات العوديةblock-force-push- يحظرgit push --forceblock-curl-pipe-sh- يحظر توجيه النصوص البعيدة إلى shell
منع تسرب الأسرار
منع الوكلاء من رؤية أو تسرب بيانات اعتماد من مخرجات الأداة.PostToolUse - بعد تشغيل الأداة، تُنظّف المخرجات قبل أن يراها الوكيل.
الحصول على تنبيهات Slack عندما يحتاج الوكلاء إلى الاهتمام
استخدم hook الإشعار لإعادة توجيه تنبيهات عدم النشاط إلى Slack.الحفاظ على الوكلاء على فرع معين
منع الوكلاء من تبديل الفروع أو الدفع إلى الفروع المحمية.مطالبة الوكلاء بتشغيل الاختبارات قبل الالتزام
ذكّر الوكلاء بتشغيل الاختبارات قبل الالتزام.قفل مستودع الإنتاج
ألزم إعداد على مستوى المشروع حتى يحصل كل مطور في فريقك على نفس السياسات. أنشئ.failproofai/policies-config.json في مستودعك:
بناء معيار جودة على مستوى المنظمة باستخدام سياسات الاتفاقية
الإعداد الأكثر تأثيراً: ألزم.failproofai/policies/ في مستودعك مع سياسات مصممة خصيصاً لمشروعك. يحصل كل عضو في الفريق عليها تلقائياً — بدون أوامر تثبيت، بدون تغييرات في الإعدادات.
1
أنشئ المجلد وأضف السياسات
2
ألزم إلى git
3
استمر في التحسين
عندما يواجه فريقك أنماط فشل جديدة، أضف سياسات واضغط. يحصل الجميع على التحديث عند
git pull التالي. تصبح هذه السياسات معياراً للجودة يتطور مع فريقك.أمثلة إضافية
يحتوي دليلexamples/ في المستودع على:

