مقدمة

ما هو PRECC؟

PRECC (التصحيح التنبؤي للأخطاء لـ Claude Code) هو أداة Rust تعترض أوامر bash في Claude Code عبر آلية خطاف PreToolUse الرسمية. يصلح الأخطاء قبل حدوثها، يوفر الرموز ويزيل حلقات إعادة المحاولة.

مجاني لمستخدمي المجتمع.

المشكلة

يهدر Claude Code رموزاً كبيرة على أخطاء يمكن تجنبها:

• أخطاء المجلد – تشغيل cargo build بدون Cargo.toml
• حلقات إعادة المحاولة – أمر فاشل ينتج مخرجات مطولة
• مخرجات مطولة – أوامر مثل find أو ls -R تنتج آلاف الأسطر

الأركان الأربعة

إصلاح السياق (cd-prepend)

يكتشف عندما تعمل أوامر مثل cargo build أو npm test في المجلد الخطأ ويضيف cd /المسار/الصحيح && قبل التنفيذ.

تصحيح أخطاء GDB

يكتشف فرص ربط GDB لتصحيح أعمق.

تعدين الجلسات

يحلل سجلات جلسات Claude Code للعثور على أزواج الخطأ-الإصلاح.

مهارات الأتمتة

مكتبة من المهارات التي تطابق أنماط الأوامر وتعيد كتابتها.

كيف يعمل (نسخة 30 ثانية)

1. Claude Code على وشك تشغيل أمر bash.
2. يرسل خطاف PreToolUse الأمر كـ JSON.
3. يعالج precc-hook الأمر في أقل من 3 مللي ثانية.
4. يُعاد الأمر المصحح كـ JSON.
5. ينفذ Claude Code الأمر المصحح.

لا يرى Claude الخطأ أبداً.

الضغط التكيفي

إذا فشل أمر بعد الضغط، يتخطى PRECC الضغط تلقائياً في المحاولة التالية حتى يحصل Claude على المخرجات الكاملة غير المضغوطة لتصحيح الأخطاء.

إحصائيات الاستخدام المباشرة

الأرقام تقديرات. كل فشل تم منعه يتجنب دورة إعادة محاولة كاملة: مخرجات الخطأ، تفكير النموذج، وأمر إعادة المحاولة. تُحدّث هذه الأرقام تلقائياً من القياسات المجهولة.

روابط

• GitHub: https://github.com/peria-ai/precc-cc
• الموقع: https://peria.ai
• التوثيق: https://precc.cc