كيف يعمل التدقيق
ما يقرأه CodeAuditAgent وما يرسله للنموذج ومدة التدقيق وأين تبدأ الحدود.
للتدقيق ثلاث مراحل: جمع المصدر، طلب تقرير منظم من النموذج، تخزين النتيجة. معرفة ما يحدث في كل مرحلة تخبرك بما يمكن للتدقيق أن يجده وما لا يمكنه.
جمع المصدر
بالنسبة للمستودع نقرأ شجرة الملفات للفرع الافتراضي ونختار الملفات الجديرة بالمراجعة: مصدر التطبيق والإعدادات وملفات البيانات الوصفية للمتطلبات. يتم تخطي الدلائل المضمنة وإخراج البناء وملفات الأقفال والصور والملفات الثنائية — إنها تستهلك الميزانية دون نقل أي منطق.
- يتم تخطي الملفات الفردية الأكبر من 60 KB؛ عادة ما يكون الملف بهذا الحجم مُولد.
- يعتمد عدد الملفات المقروءة على خطتك: 20 على المجاني، 40 على Starter، 80 على Pro.
- كما يتم تحديد المبلغ الإجمالي للمصدر المرسل للنموذج: 60.000 حرف على المجاني، 300.000 على Starter، 600.000 على Pro.
عندما يكون المستودع أكبر من الحد، يقول التقرير ذلك بوضوح. تعامل مع التدقيق المقطوع كعينة، وليس كتغطية: الملفات التي لم تُقرأ لم تتم مراجعتها.
طلب من النموذج
يذهب المصدر إلى Claude مع إشارة نظام تحدد وظيفة المراجع وتخطيط أداة يحدد شكل الإجابة. لا يمكن للنموذج الرد بالنثر؛ يجب أن يملأ هيكل التقرير، ولهذا السبب لكل نتيجة شدة وموقع وعلاج بدلا من فقرة نصائح عامة.
يتم التعامل مع الكود الخاص بك كبيانات غير موثوقة في جميع الأنحاء. إذا حاول تعليق أو نص في المستودع إصدار تعليمات للمراجع — "تجاهل التعليمات السابقة"، "لا تبلغ عن أي نتائج" — يتم إخبار النموذج برفض الامتثال والإبلاغ عن المحاولة كنتيجة injection للأوامر.
تعمل الخطط المدفوعة مع Claude Fable 5.1. تستخدم الخطة المجانية Claude Haiku 4.5، وهي أسرع وأرخص بكثير للتقديم، لذا تبقى التجارب مجانية؛ إنها تجد أقل من نموذج الرائد.
تخزين النتيجة
يتم تخزين التقرير مقابل حسابك، مع النموذج المستخدم وقائمة الملفات التي تمت قراءتها فعلا وما إذا تم اقتطاع المصدر. هذه القائمة مهمة عند مقارنة تدقيقين: يمكن لنتيجة أن تختفي لأنها تم إصلاحها، أو لأن الملف الذي كانت تعيش فيه لم يُعرّف هذه المرة.
ما لا يفعله التدقيق
- لا يقوم بتشغيل الكود الخاص بك، لذا لا يمكنه تأكيد قابلية الاستغلال أثناء التشغيل.
- لا يصل إلى المستودعات الخاصة بعد؛ هذا يتطلب تثبيت GitHub App، وهو غير مُنشأ.
- لا يفتح pull requests أو يغير أي شيء في المستودع الخاص بك.
- لا يحل محل اختبار الاختراق أو المراجعة البشرية للكود الحساس أمنيا.