مُراجع الشيفرة من علي بابا يشغّل القواعد الحتمية أولاً ويسأل النموذج بعدها

الوكيل البرمجي العام الذي يُطلب منه مراجعة تغييرات كبيرة يتصرف كمن طُلب منه تدقيق كتاب قبل الجمعة. يبدأ بمثابرة، يجد إيقاعه، ثم يبدأ في التصفح السريع عند الفصل الرابع. النتيجة مراجعة تغطي الثلث الأول من الـ diff بعناية، وتذكر أمرين في الوسط، وتعلن أن الباقي نظيف.
مشروع Open Code Review من علي بابا، الذي صدر مفتوح المصدر هذا الشهر بعد عامين كأداة داخلية ويقترب من 51,000 نجمة على GitHub، مبني على ملاحظة واحدة: هذا الإخفاق معماري، وتعديل الـ prompt لا يصلحه.
ثلاثة إخفاقات يسميها الفريق
ملف README صريح على نحو غير معتاد بشأن ما يخطئ في نهج الوكيل العام.
التغطية الناقصة تأتي أولاً. في التغييرات الكبيرة يختار الوكلاء بعض الملفات ويفوتون غيرها، ولا توجد في حلقة تقودها اللغة أي آلية تضمن أن كل ملف سيُفحص.
انحراف الموضع يأتي ثانياً. المشكلات المبلّغ عنها كثيراً لا تطابق موضع الشيفرة الفعلي، فتزحف أرقام الأسطر ومراجع الملفات عن الهدف. من جرّب تطبيق تعليقات وكيل يعرف هذا: التعليق محق في العلة ومخطئ في المكان.
الجودة غير المستقرة تأتي ثالثاً. المهارات المكتوبة بلغة طبيعية يصعب تنقيحها، وجودة المراجعة تتغير كثيراً مع تغييرات صغيرة في الـ prompt. لذلك تصبح الأداة غير قابلة للاعتماد وصعبة الثقة داخل بوابة.
التشخيص في جملة واحدة: البنية المدفوعة باللغة وحدها لا تفرض قيوداً صلبة على العملية.
ما أخرجه من النموذج
التصميم يقسّم العمل. كل ما لا يجوز أن يخطئ تتولاه شيفرة عادية. وكل ما يحتاج حكماً يذهب إلى الوكيل.
اختيار الملفات حتمي. الشيفرة تقرر أي الملفات يدخل النطاق وأيها يُستبعد، فلا يُقفز عن شيء مهم لأسباب لا يستطيع النموذج تفسيرها.
التجميع حتمي. الملفات المترابطة تُضم إلى وحدة مراجعة واحدة، ومثال README هو المفيد: `message_en.properties` و `message_zh.properties` يجب أن يكونا معاً، لأن مفتاحاً يُضاف في أحدهما ويُنسى في الآخر هو بالضبط العلة التي يفوّتها المراجع ملفاً بملف. كل حزمة تعمل كـ sub-agent بسياق معزول، وهكذا تبقى الأداة مستقرة على التغييرات الضخمة، ولهذا تتوازى دون تنسيق.
مطابقة القواعد حتمية. تُطابق القواعد مع خصائص كل ملف عبر محرك قوالب، بدل وصفها في نص نثري وانتظار أن يتذكرها النموذج. الفائدة المعلنة أن انتباه النموذج يبقى على القواعد السارية دون قراءة دليل قواعد كامل.
وحدتان تقعان خارج الوكيل تماماً: واحدة تضع التعليقات، وأخرى تعيد النظر فيها. وجودهما لأن النموذج الذي يكتب تعليقاً ليس موثوقاً في مكان وضع ذلك التعليق، وطلب التحقق من الموضع منه يعمل أفضل كمرور منفصل لا كتعليمة داخل الـ prompt الرئيسي.
يحتفظ الوكيل بالأجزاء التي تحتاج قراراً: أي سياق يُجلب، وأي الأدوات تُستدعى، وكيف تُصاغ الملاحظة. مجموعة أدواته مُستخلصة من آثار الاستدعاء في بيئة الإنتاج لدى علي بابا، بما فيها توزيعات التكرار وكم مرة تكررت كل أداة، وهي أساس تجريبي أكثر من التخمين المعتاد لما قد يحتاجه المراجع.
الأرقام والمقايضة المدفونة فيها
اسم المعيار AACR-Bench: خمسون مستودعاً مفتوح المصدر شائعاً، ومئتا pull request حقيقية، وعشر لغات برمجة، وأكثر من ثمانين مهندساً خبيراً، و1,505 مشكلات موثقة كمرجع.
مقابل وكيل عام يستخدم النموذج الأساسي نفسه، تعلن علي بابا دقة وF1 أعلى بكثير، وقرابة تسع مرة أقل من الرموز، وإنجازاً أسرع. والاستدعاء أقل.
تلك العبارة الأخيرة أصدق جملة في README، وهي تغيّر من ينبغي أن يستخدم الأداة.
الدقة هي نسبة المشكلات المبلّغ عنها التي هي حقيقية. والاستدعاء هو نسبة العيوب الحقيقية التي تُكتشف. المراجع المضبوط على الدقة قليل الكلام وغالباً محق. والمضبوط على الاستدعاء كثير الضجيج وغالباً يجد أكثر.
لبوابة CI في مستودع مزدحم، الدقة هي الهدف الصحيح. روبوت يعلّق أربعين مرة على pull request فيها أحد عشر مشكلة حقيقية سيُكتم خلال أسبوع، والروبوت المكتوم استدعاؤه صفر مهما كانت نتيجته في المعيار. الفريق اختار المقايضة التي تُبقي الأداة مشتغلة.
لتدقيق أمني على شيفرة غير مألوفة، المقايضة خاطئة. أنت تريد المراجع كثير الضجيج. لهذا يوجد `ocr scan` كنمط منفصل يراجع ملفات كاملة لا diff، ولهذا ينبغي قراءة أولوية الدقة كقول عن pull requests، لا كحكم على مراجعة الشيفرة عموماً.
التثبيت
الأداة هي CLI اسمها `ocr`.
npm install -g @alibaba-group/open-code-review
ocr config provider
ocr config model
يمرّ الإعداد باختيار المزوّد وإدخال المفتاح واختبار اتصال. ثم من داخل مستودع:
ocr review # staged, unstaged, untracked
ocr review --from main --to feature-branch # merge-base range
ocr review --commit abc123
ocr scan --path internal/agent # whole files, no git history needed
ocr review --format json --output result.json
يمكن قطع المراجعات الطويلة واستئنافها بـ `ocr session list` و `--resume`، وهذا يهم حين توجّه الأداة إلى monorepo. وهناك عارض جلسات في المتصفح لإعادة تشغيل مراجعة وتعليم التعليقات كمصلحة أو متجاهلة.
قرار التصميم الأكثر إثارة بالنسبة لي هو نمط delegation. في النمط الافتراضي يستدعي OCR النموذج بنفسه بإعداد المزوّد الخاص به، منفصلاً عن اشتراكك في Claude Code. وفي نمط delegation يظل OCR مسؤولاً عن اختيار الملفات وحل القواعد، ويسلّم المراجعة الفعلية إلى نموذج وكيل الشيفرة ومصادقته. دون مفتاح API منفصل.
هذه قراءة حادة لموضع القيمة. السقالة هي المنتج. والنموذج سلعة قد تكون تدفع ثمنها بالفعل.
لماذا يهم هذا خارج مراجعة الشيفرة
انزع الخصوصية وستجد البنية جواباً عاماً لمشكلة عامة: النماذج اللغوية غير موثوقة في العمل الشامل الذي يحفظ الترتيب ودقة الموضع على مدخلات كبيرة، وموثوقة في الحكم داخل سياق محدود.
كل خط محتوى رأيته يفشل فشل بالطريقة نفسها. يُطلب من وكيل فحص عشرين صورة منتج من حيث التزام العلامة، فيفحص إحدى عشرة ويكتب ملخصاً واثقاً. ويُطلب من وكيل تعريب أربعين نصاً، فيتجاوز أربعة ويعلن النجاح. الخلل في التغطية، والتغطية هي بالضبط ما تقدمه طبقة حتمية.
النمط الجدير بالنسخ هو التقسيم: عدّد في الشيفرة، واحكم في النموذج، ثم تحقق من موضع المخرجات في الشيفرة مرة أخرى. طبّقت علي بابا ذلك على diffs. والخطوات الثلاث نفسها تنطبق على مجلد أصول مولّدة، أو دفعة صفحات مترجمة، أو جدول مطالبات.
هناك كلفة، وهي سبب عدم قيام معظم الفرق بهذا. السقالة الحتمية تُكتب لكل مجال على حدة. قواعد تجميع ملفات properties في Java لا قيمة لها في مجلد صور منتجات، ووحدة إعادة النظر التي تصحح موضع التعليقات لا نظير لها في خط ترجمة. الهندسة لا تنتقل. النمط ينتقل.
ما سأراقبه
أمران في الربع القادم.
هل تبقى مجموعة القواعد محدثة. محرك قواعد بمطابقة قوالب مستقر لأنه صريح، والقواعد الصريحة تتقادم. القاعدة التي تلتقط نمط NPE في شيفرة Java 17 قد تكون ضجيجاً في شيفرة Java 25. والاستقرار المشترى بالترميز الصلب تأتي معه فاتورة صيانة.
وهل تصمد أولوية الدقة خارج قاعدة شيفرة علي بابا. المراجع المضبوط على عقد من الأعراف الداخلية سيبدو حاداً على تلك الأعراف. السؤال المفتوح، والذي سيجيب عنه المجتمع سريعاً، هو كيف يتصرف على شيفرة كتبها أشخاص لم يقرؤوا الدليل الأسلوبي نفسه.
مقالات ذات صلة
AMD ربحت 19% لمجرد أنها الخيار الآخر
المال لم يخرج من الذكاء الاصطناعي. خرج من الاسم الوحيد الذي واجه مشكلة حوكمة، وذهب إلى الاسمين الذين لم يواجها.
عشر تخفيضات في أربع جلسات، ولا رقم جديد واحد
لم ينشر أحد رقمًا جديدًا عن دفتر الطلبات. الذي تغيّر ليس منتصف النطاق، بل عرضه — وهذا وحده كافٍ لتغيير تصنيف.
أول ربع بعد رحيله: الأرقام محسومة، والأسئلة ليست كذلك
الربع نفسه ليس محل شك، أما الأرباع الأربعة التالية فهي المسألة كلها. ورئيسة تنفيذية مؤقتة لديها مكالمة واحدة لتشرح ما لا تستطيع الأرقام شرحه.
جدول نقرات يديره المجتمع يطفئ الإعلانات داخل بناءات أندرويد الصينية
لا يمس النظام، ولا يفتح القفل، ولا يكتب أي شيء على الجهاز. يقلب فقط المفاتيح التي عرضتها الشركات أصلاً. الثمن قائمة يجب أن يظل أحدهم يكتبها.