مقدمة
ما هو PRECC؟
PRECC (التصحيح التنبؤي للأخطاء لـ Claude Code) هو أداة Rust تعترض أوامر bash الخاصة بـ Claude Code عبر آلية PreToolUse hook الرسمية. يصلح الأخطاء قبل أن تحدث، مما يوفر الرموز ويلغي حلقات إعادة المحاولة.
مجاني لمستخدمي المجتمع.
المشكلة
يهدر Claude Code رموزاً كثيرة على أخطاء يمكن تجنبها:
- أخطاء المجلد الخاطئ – تشغيل
cargo buildفي مجلد أب لا يحتوي علىCargo.toml، ثم إعادة المحاولة بعد قراءة الخطأ. - حلقات إعادة المحاولة – ينتج عن الأمر الفاشل مخرجات مطولة، يقرأها Claude ويحللها ويعيد المحاولة. كل دورة تستهلك مئات الرموز.
- المخرجات المطولة – أوامر مثل
findأوls -Rتطبع آلاف الأسطر التي يجب على Claude معالجتها.
الركائز الأربع
إصلاح السياق (cd-prepend)
يكتشف عندما تعمل أوامر مثل cargo build أو npm test في المجلد الخطأ ويضيف cd /المسار/الصحيح && قبل التنفيذ.
تصحيح GDB
يكتشف فرص إرفاق GDB للتصحيح الأعمق لأعطال segfault والانهيارات، ويقدم معلومات تصحيح منظمة بدلاً من نتائج core dump الخام.
تعدين الجلسات
يستخرج أزواج الفشل-الإصلاح من سجلات جلسات Claude Code. عندما يتكرر الخطأ نفسه، يعرف PRECC الإصلاح ويطبقه تلقائياً.
مهارات الأتمتة
مكتبة من المهارات المضمنة والمستخرجة التي تطابق أنماط الأوامر وتعيد كتابتها. تُعرَّف المهارات كملفات TOML أو صفوف SQLite، مما يسهل فحصها وتحريرها ومشاركتها.
كيف يعمل (نسخة الـ 30 ثانية)
- Claude Code على وشك تشغيل أمر bash.
- يرسل PreToolUse hook الأمر إلى
precc-hookبصيغة JSON عبر stdin. - يعالج
precc-hookالأمر عبر المسار (المهارات، تصحيح المجلد، الضغط) في أقل من 3 ميلي ثانية. - يعود الأمر المصحح بصيغة JSON عبر stdout.
- ينفذ Claude Code الأمر المصحح بدلاً من الأصلي.
تُختصر الأخطاء التافهة؛ ويُرفق سبب إعادة الكتابة في استجابة الـ hook، بحيث يمكن مراجعة كل تصحيح بدلاً من أن يكون صامتاً.
حدود الأمان
لا يعيد PRECC الكتابة إلا عندما يكون التكافؤ الدلالي محفوظاً بشكل قابل للإثبات أو قابلاً للتحقق من قبل المستخدم. الأوامر المدمرة (rm، git push --force، git reset --hard) لا يُعاد كتابتها أبداً حتى لو تطابقت مهارة. يجب أن تكون كل عملية تغيير محدودة — يجب أن يحتوي الأمر المعاد كتابته على الرموز الأساسية للأمر الأصلي. تُعاد العمليات غير المحدودة تلقائياً. كل عملية إعادة كتابة مُطبَّقة تُسجَّل وتُعرَض لتتمكن من مراجعتها أو تعطيلها أو التراجع عنها.
الضغط التكيفي
إذا فشل أمر بعد الضغط، يتخطى PRECC الضغط تلقائياً في المحاولة التالية حتى يحصل Claude على المخرجات الكاملة غير المضغوطة لتصحيح الأخطاء.
إحصاءات الاستخدام المباشرة
الإصدار الحالي –:
| المقياس | القيمة |
|---|---|
| استدعاءات الـ hook | – |
| الرموز الموفرة | – |
| نسبة التوفير | –% |
| إعادة كتابات RTK | – |
| تصحيحات CD | – |
| زمن استجابة الـ hook | – ms (p50) |
| المستخدمون | – |
التوفير المقاس (بيانات حقيقية)
التوفير حسب الإصدار
تتحدث هذه الأرقام تلقائياً من بيانات القياس عن بُعد المجهولة الهوية.
روابط
- GitHub: https://github.com/peria-ai/precc-cc
- الموقع: https://peria.ai
- التوثيق: https://precc.cc