"إذا كانت النماذج اللغوية الحديثة تستطيع التعامل مع 200 ألف رمز، لماذا لا نرسل فقط الفرق مع السياق المناسب وندع النموذج يفهم؟ ما الفائدة من كل تعقيد الوكلاء هذا؟"
الموجه يمكنه فقط رؤية ما ترسله. لمراجعة كود ذات معنى، تحتاج سياقاً من كامل قاعدة الكود — الواردات، التبعيات، الملفات المرتبطة، الاختبارات، الاتفاقيات.
البحث يثبت أن تفريغ المزيد من السياق في النماذج اللغوية يضر الأداء بشكل فعال. هذا يُسمى "تخفيف السياق".
10-20%
انخفاض الأداء من كثرة الوثائق
منحنى U
المعلومات في الوسط تضيع
60-80%
معدل الإيجابيات الكاذبة في أدوات تفريغ السياق
الوكلاء لا "يقرأون الموجهات بشكل أفضل" فقط. إنهم يحققون بنشاط في قاعدة كودك:
جلب الملفات ذات الصلة فقط عند الطلب، ليس تفريغ كل شيء مقدماً
"أشتبه بعدم تطابق أنواع" → البحث في المستدعين → التأكيد بالتحليل الثابت
متابعة الخيوط عبر الملفات، الحفر أعمق عند الشك
تشغيل محللات ومدققات أنواع ومحللات للتحقق من النتائج ببيانات حقيقية
الموجه يرى ما تعطيه.
الوكيل يجد ما يحتاجه.
الفرق بين المراجعة المفيدة والضوضاء ليس كم السياق لديك — إنه امتلاك السياق الصحيح
قبل بدء المراجعة، نبني خريطة لكيفية اتصال الملفات — الواردات، الصادرات، تعريفات الأنواع، وسلاسل الاستدعاء
كل وكيل يتلقى فقط السياق المناسب لمهمته — وكيل الأمان يحصل على تدفقات المصادقة، ليس تنسيق الواجهة
الوكلاء يجلبون سياقاً إضافياً فقط عند الحاجة — متابعة الخيوط بدون حمل زائد مقدم
السياق الأساسي (الفرق، الأنواع) يبقى مقيماً؛ السياق المحيط (المستدعون، الاختبارات) يُحمَّل عند الحاجة
200 ألف رمز من كل شيء — فرق، ملفات كاملة، تبعيات عشوائية...
أجزاء مركزة — فرق + تبعيات مباشرة + أنماط ذات صلة
استدعاء نموذج لغوي واحد لمراجعة الكود له قيود جوهرية
محدود بالفرق الذي تقدمه
لا تكرار أو تحقق
أعمى للتبعيات والسياق
لا طريقة للتحقق من الادعاءات
الانتباه موزع على كل المخاوف
"تأكد من تحديث المستدعين"
يتنقل في مشروعك بالكامل
يتابع الخيوط، يحفر أعمق
يفهم الواردات والتبعيات
يشغل محللات ثابتة للتأكيد
كل وكيل يتخصص في مجال واحد
"3 مواقع استدعاء بها عدم تطابق أنواع في السطور 45، 89، 112"
الفرق بين التخمين و التحقيق.
الوكيل هو نظام ذكاء اصطناعي يستطيع التفكير والتصرف والتحقق
قراءة الملفات، البحث في الكود، تشغيل المحللات الثابتة
اختيار ما يُحقق فيه بناءً على النتائج
متابعة الخيوط، التحقق من الفرضيات، الحفر أعمق
التحقق من المنطق مقابل البيانات الحقيقية
عندما يراجع diffray الPR الخاص بك، الوكلاء لا "ينظرون للفرق فقط"
متابعة الواردات لفهم كيف يؤثر الكود المتغير على النظام بأكمله
فحص الاختبارات والإعدادات والتوثيق للسياق
تشغيل تحليل ثابت للتأكد من أن المشاكل المشتبه بها موجودة فعلاً
البحث عن تعريفات الأنواع وعقود API والاتفاقيات
ضع في اعتبارك تغيير توقيع دالة في PR:
"هذا يغير نوع الإرجاع، تأكد من تحديث المستدعين"
نصيحة عامة. لا تفاصيل.
→ "وجد 3 تغييرات كسرية: src/api/users.ts:45، src/hooks/useAuth.ts:89، src/utils/validate.ts:112"
لفهم التغييرات حقاً، تحتاج لرؤية كيف تتناسب مع قاعدة الكود بالكامل
دالة جديدة formatUserName() أُضيفت
تبدو صحيحة قواعدياً
لا أخطاء واضحة في هذه الـ 20 سطر
الحكم: "LGTM" — لكن يفوت الصورة الأكبر تماماً
هذه الدالة تكرر utils/names.ts:formatName()
الدالة الموجودة تعالج حالات حدية تفوتها هذه
3 ملفات أخرى تستخدم بالفعل الأداة الموجودة
هذا يخالف اتفاقية التسمية في /docs/CONVENTIONS.md
الحكم: "فكر في استخدام formatName() الموجودة من utils/names.ts"
هل المطور يعيد اختراع العجلة؟ هل يوجد حل مشابه بالفعل في قاعدة الكود؟
هل هذه التغييرات تتبع الأنماط المعتمدة؟ أم تقدم نهجاً متعارضاً؟
كيف تؤثر هذه التغييرات على بقية النظام؟ ما الذي يعتمد على الكود المُعدَّل؟
هل يُتَّبع اتفاقيات الفريق والمعايير الموثقة؟
الفرق يظهر لك ما تغير. سياق قاعدة الكود الكامل يظهر لك إذا كان يجب أن يتغير.
أسس قوية تمكّن تعاون الوكلاء المتعددين الحقيقي
كل مراجعة تمر بخط أنابيب متعدد المراحل، كل مرحلة محسنة لغرضها
نسخ
جلب المستودع وتحقق PR
إعداد البيانات
بناء رسم التبعيات
تلخيص
النموذج اللغوي يلخص التغييرات
فرز
توجيه الملفات للوكلاء
قواعد
تحميل وتصفية القواعد
مراجعة
تحليل وكلاء متوازي
إزالة تكرار
دمج وإعادة تسجيل
تحقق
التحقق وإعادة التسجيل
تقرير
توليد تعليقات PR
نسخ
جلب المستودع وتحقق PR
إعداد البيانات
بناء رسم التبعيات
تلخيص
النموذج اللغوي يلخص التغييرات
فرز
توجيه الملفات للوكلاء
قواعد
تحميل وتصفية القواعد
مراجعة
تحليل وكلاء متوازي
إزالة تكرار
دمج وإعادة تسجيل
تحقق
التحقق وإعادة التسجيل
تقرير
توليد تعليقات PR
النتيجة
نظام متعدد الوكلاء يجمع بين تفكير الذكاء الاصطناعي وتحليل الكود الملموس — يقدم نتائج دقيقة ومُتحقق منها بدلاً من التخمين.
شاهد كيف يتفوق التحقيق على التخمين. جرب diffray مجاناً على PR القادم.