الانتقال إلى المحتوى الرئيسي
أمثلة جاهزة للاستخدام لسيناريوهات شائعة. يوضح كل منها كيفية التثبيت وما يمكن توقعه.

إعداد hooks لـ Claude Code

يتكامل Failproof AI مع Claude Code عبر نظام hooks الخاص به. عند تشغيل failproofai policies --install، يسجل أوامر hook في ملف settings.json الخاص بـ Claude Code التي تُشغّل عند كل استدعاء أداة.
1

تثبيت failproofai

2

تفعيل جميع السياسات المدمجة

3

التحقق من تسجيل hooks

يجب أن ترى إدخالات hook لأحداث PreToolUse و PostToolUse و Notification و Stop.
4

تشغيل Claude Code

تعمل السياسات الآن تلقائياً عند كل استدعاء أداة. جرب طلب Claude بتشغيل sudo rm -rf / - سيتم حظره.

إعداد hooks لـ Agents SDK

إذا كنت تبني باستخدام Agents SDK، يمكنك استخدام نفس نظام hooks برمجياً.
1

تثبيت failproofai في مشروعك

2

تكوين hooks في وكيلك

مرر أوامر hook عند إنشاء عملية الوكيل. تُشغّل الـ hooks بنفس الطريقة كما في Claude Code - عبر JSON في stdin/stdout:
3

كتابة سياسة مخصصة لوكيلك

4

تثبيت السياسة المخصصة


حظر الأوامر المدمرة

الإعداد الأكثر شيوعاً - منع الوكلاء من إلحاق الضرر الذي لا يمكن إرجاعه.
ما تفعله:
  • block-sudo - يحظر جميع أوامر sudo
  • block-rm-rf - يحظر حذف الملفات العودية
  • block-force-push - يحظر git push --force
  • block-curl-pipe-sh - يحظر توجيه النصوص البعيدة إلى shell

منع تسرب الأسرار

منع الوكلاء من رؤية أو تسرب بيانات اعتماد من مخرجات الأداة.
تُشغّل على PostToolUse - بعد تشغيل الأداة، تُنظّف المخرجات قبل أن يراها الوكيل.

الحصول على تنبيهات Slack عندما يحتاج الوكلاء إلى الاهتمام

استخدم hook الإشعار لإعادة توجيه تنبيهات عدم النشاط إلى Slack.
ثبته:

الحفاظ على الوكلاء على فرع معين

منع الوكلاء من تبديل الفروع أو الدفع إلى الفروع المحمية.

مطالبة الوكلاء بتشغيل الاختبارات قبل الالتزام

ذكّر الوكلاء بتشغيل الاختبارات قبل الالتزام.

قفل مستودع الإنتاج

ألزم إعداد على مستوى المشروع حتى يحصل كل مطور في فريقك على نفس السياسات. أنشئ .failproofai/policies-config.json في مستودعك:
ثم ألزمه:
كل عضو في الفريق لديه failproofai مثبت سيختار هذه القواعد تلقائياً.

بناء معيار جودة على مستوى المنظمة باستخدام سياسات الاتفاقية

الإعداد الأكثر تأثيراً: ألزم .failproofai/policies/ في مستودعك مع سياسات مصممة خصيصاً لمشروعك. يحصل كل عضو في الفريق عليها تلقائياً — بدون أوامر تثبيت، بدون تغييرات في الإعدادات.
1

أنشئ المجلد وأضف السياسات

2

ألزم إلى git

3

استمر في التحسين

عندما يواجه فريقك أنماط فشل جديدة، أضف سياسات واضغط. يحصل الجميع على التحديث عند git pull التالي. تصبح هذه السياسات معياراً للجودة يتطور مع فريقك.

أمثلة إضافية

يحتوي دليل examples/ في المستودع على: