ربط PR-Agent: GitHub Action، ومفتاح النموذج، وتكلفته بالرموز

السؤال الذي تجيب عنه هذه الصفحة ليس ما هو وكيل PR — فتلك مقالة أخرى — بل ما يحدث بين أن تقرر أنك تريد PR-Agent على مستودعك وأن تراجع طلب سحب. والفجوة بين هاتين النقطتين تقارب ملف YAML واحد ومفتاح نموذج واحد، والأجزاء التي يخطئ فيها الناس هي التي لا يوثقها أحد: أي مسار تثبيت هو المعتمد حالياً، وكم يكلّف النموذج الافتراضي لكل مراجعة، ولماذا يمكن أن يرفع طلب سحب واحد فاتورتك إلى عشرة أضعاف.

PR-Agent هي الأداة مفتوحة المصدر التي بنتها CodiumAI ثم تبرعت بها للمجتمع. وهي الآن توجد في منظمتها الخاصة على GitHub كمشروع إرثي مجتمعي تابع لـ Qodo، بترخيص MIT، بحوالي 12.6 ألف نجمة و1.7 ألف نسخة متفرعة. إنها مجانية؛ لكن استدعاءات النموذج التي تجريها ليست كذلك، وهذا هو الرقم الوحيد في هذا الإعداد الذي يتوسع مع فريقك.

مسارات التثبيت الثلاثة، وأيّها تريده فعلاً

• GitHub Action — ملف سير عمل يشغّل code>the-pr-agent/pr-agent@main/code> عند أحداث طلب السحب. هذا هو المسار الموصى به والذي ينبغي البدء به: لا يحتاج إلى خادم، ولا نقطة نهاية webhook، ولا أي سرّ عدا مفتاح النموذج والرمز الذي يمنحه GitHub للإجراء مسبقًا.

• واجهة سطر الأوامر (CLI) — code>pip install pr-agent/code>، ثم code>pr-agent --pr_url <url> review/code>. مفيدة لتجربة مراجعة على طلب سحب (PR) موجود قبل ربط أي شيء، ولتشغيل المحرك نفسه من حاسوب محمول أو مهمة CI ليست GitHub Actions.

• الحاوية و«الويب هوك» — صورة Docker، أو مسار الويب هوك المستضاف لـ GitLab وBitbucket وAzure DevOps وGitea. اختر هذا الخيار عندما لا تكون مستودعاتك على GitHub، أو عندما تحتاج إلى تشغيل المراجعة داخل حدود شبكتك الخاصة.

ثمة تحذير جدير بالمعرفة قبل أن تنسخ رقم إصدار من درس تعليمي: توثيق المشروع نفسه يشير إلى أن حزمة code>pip/code> المنشورة تتأخر حاليًا عن أحدث إصدار، ويوجّه المستخدمين إلى التثبيت من وسم GitHub إذا كانوا يحتاجون إلى أحدث شيفرة. هذه مشكلة في الحالة المستقرة وليست حادثًا، لكنها تعني أن «أخبرني التوثيق بأن أشغّل pip install» و«لديّ الإصدار الحالي» ليستا الجملة نفسها.

مفتاح النموذج هو القرار الفعلي

يأتي PR-Agent بدعمٍ للنماذج يكون مفتوحًا عن قصد. وتُدرج ملاحظات الإصدار GPT-5.6 كنموذج افتراضي جديد، مع دعم Gemini 3.6 وعائلتَي Claude Opus 5 وClaude Sonnet 5، وعمل DeepSeek وMistral عبر كتلة الإعدادات نفسها. وأيًّا كان ما تختاره، فأنت من يوفّر المفتاح، وتجري المراجعة على حسابك.

تلك هي مقايضة المصادر المفتوحة في جملة واحدة: أنت تملك البنية الأساسية — المفاتيح والأسرار ووقت التشغيل والفاتورة — مقابل تكلفة لكل مراجعة لا علاقة لها بالمقاعد. فريق من خمسة مطورين على أداة مستضافة بتسعير لكل مقعد يدفع المبلغ نفسه سواء دمج عشرة طلبات سحب شهريًا أو ألفًا. أما في مسار التسعير بالرموز، فإن الرقم يتتبع ما تراجعه فعليًا، وهو أفضل عندما تكون مشغولًا وأسوأ عندما لا تكون كذلك.

خياران في الإعداد يغيّران ذلك الرقم أكثر مما يغيّره اختيار النموذج:

• شغّله مرة واحدة لكل طلب سحب، لا مرة واحدة لكل دفعة. بعض الأدوات تُجري المراجعة افتراضيًا على كل إيداع. فطلب سحبٍ يحتوي على عشر دفعات يصبح عشر جولات مراجعة، وعشر استدعاءات للنموذج، وعشرة أضعاف الفاتورة، مقابل تسع مراجعات لكود لم يعد موجودًا. تحقّق من هذا الإعداد أولًا، أينما كنت تنشر.

• ضع حدًا لحجم الفرق. كل أداة من هذه الأدوات تضغط الفرق قبل وصوله إلى النموذج، لأن تغييرًا من 2,000 سطر لا يتسع في مطالبة مع مساحة للتفكير. استراتيجية ضغط طلبات السحب لدى PR-Agent هي التطبيق المعياري. يمكن لملف مُولَّد أو ملف قفل أو تبعية مضمّنة أن يهيمن على الفرق والتكلفة من دون أن يحتوي على أي شيء قد يقرأه المراجع — فاستبعدها.

ما الذي تفعله الأوامر، وكم تكلّف كل واحدة منها

بعد التثبيت، تستجيب الأداة لأوامر الشرطة المائلة على طلب السحب. كل منها عادةً استدعاء واحد للنموذج، ولهذا تصل الردود في غضون عشرات الثواني وتكلف أجزاء من السنت:

• code>/describe/code> — يكتب عنوان طلب السحب وملخصه وشرحه التفصيلي وتسمياته اعتمادًا على الفرق وحده.

• code>/review/code> — يفحص الأخطاء ومشكلات الأمان ومشكلات قابلية الصيانة، مع تسميات للخطورة ودرجة.

• code>/improve/code> — يقترح تغييرات برمجية قابلة للإيداع بدلًا من التعليقات.

• code>/ask/code> — يجيب عن سؤال مستند إلى الفرق، وهو الأمر الذي يستخدمه المراجعون أكثر من غيره بمجرد أن يثقوا بالأداة.

• code>/update_changelog/code> — يعيد إنشاء إدخال سجل التغييرات الخاص بطلب السحب.

السلوك التلقائي الذي تريده معظم الفرق هو code>/review/code> واحد عند فتح طلب السحب. يمكن ترك كل ما عدا ذلك لتعليق، مما يجعل التكلفة قابلة للتوقع ويُبقي الوكيل بعيدًا عن طريق المراجع الذي يقرأ بالفعل.

أنماط الفشل التي لا يحذّرك منها أحد

• ينجح الإجراء ولا ينشر أي شيء. عادةً ما تكون هذه مشكلة في الأذونات: يمكن لرمز سير العمل قراءة الفروقات ولكن لا يمكنه كتابة تعليق. تحقق من سجل الإجراء بحثًا عن خطأ 403 عند استدعاء التعليق قبل تصحيح أخطاء النموذج.

• إنه يراجع فرقًا خاطئًا.تُشغَّل طلبات السحب من الـ fork برمز مقيَّد افتراضيًا، وسير عمل لم يُضبَط للتعامل معها يراجع فرقًا فارغًا أو جزئيًا ولا يُبلِغ عن أي ملاحظات. الصمت ليس شهادة سلامة.

• المراجعة واثقة وخاطئة. سيصف كل مُراجِع مدعوم بنموذج، من حين لآخر، كودًا غير موجود في الفروقات. والعلاج بنيوي لا على مستوى التوجيه: اطلب من الأداة الاستشهاد بالأسطر التي تشكو منها، وتعامل مع أي ملاحظة غير مستشهَد بها كتعليق لا كبوابة.

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

أين يتناسب جهاز التوجيه، وأين لا يتناسب

يُعدّ وكيل PR واحدًا من أحمال عمل الذكاء الاصطناعي القليلة التي يكون فيها تبديل النماذج أثناء التشغيل مفيدًا حقًا: فالتمريرة الأولى الرخيصة تلتقط أخطاء التنسيق والعيوب الواضحة، ولا يحتاج إلى نموذج مكلف إلا طلبات السحب التي تنجو منها. وهذا بالضبط هو الشكل الذي ينفّذه منتج OrcaCode Review من OrcaRouter — تمريرة سريعة بنموذج رائد منخفض التكلفة، ثم تصعيد إلى نموذج أقوى عندما يكتشف الفحص شيئًا — وهو أيضًا شيء يمكنك محاكاته بنفسك باستخدام PR-Agent عبر توجيه إعداداته إلى بوابة والتوجيه حسب حجم PR.

ما لا يفعله الموجّه هو أن يجعل المراجعة صحيحة. فالقيمة تكمن في مفتاح واحد لكل نموذج قد ترغب في مقارنته، وسعر قائمة المزوّد دون أي هامش ربح مضاف، والتحويل التلقائي عند تعثّر مزوّد ما في منتصف طابور الدمج لديك. فكل من Claude Opus 5.5 وClaude Sonnet 5.5 وGPT-5.6 وسلسلة Gemini قابلة للاستدعاء عبر النقطة الطرفية نفسها المتوافقة مع OpenAI، وهو ما يجعل سؤال «أي نموذج يراجع شيفرتنا البرمجية؟» تغييرًا في الإعدادات بدلًا من عملية شراء.

ماذا تفعل هذا الأسبوع

• ثبّت GitHub Action على مستودع واحد، لا على جميعها. المستودع الواحد يخبرك بجودة المراجعة والتكلفة لكل PR؛ أما جميعها فيخبرك بكلا الأمرين مقسومين على مقام غير مقيس.

• حدِّد النموذج بالقياس، لا بالسمعة. شغِّل code>/review/code> على آخر عشرين طلب سحب مدموجًا لديك باستخدام نموذجين مختلفين، وقارن الملاحظات التي وافق عليها إنسان. هذا الرقم هو المعيار الوحيد الذي يهم هنا.

• اضبط "مرة واحدة لكل طلب سحب" قبل أن تضبط أي شيء آخر، واضبط حدًّا للميزانية على المفتاح.

• أبقِ على البوابة البشرية. وكيل طلبات السحب الذي يحجب عمليات الدمج هو وكيل سيجد فريقك طريقة لتجاوزه في غضون شهر.

ملاحظة المصادر: أصل PR-Agent وترخيصه وعدد النجوم ومسارات التثبيت ومجموعة الأوامر والإعدادات الافتراضية للنماذج، وكذلك ملاحظة أن حزمة pip متأخرة عن أحدث إصدار، كلها مأخوذة من مستودع المشروع ووثائقه كما وردت في 4 نوفمبر 2026. أما تسعير البدائل المستضافة لكل مقعد ولكل رصيد فهو مأخوذ من الصفحات المنشورة لتلك الجهات البائعة، ولا يُذكر إلا للمقارنة. وقد استُخدمت Grok وأسماء النماذج كأمثلة على الإعدادات؛ كما تم التحقق من معرّفات النماذج على بوابة OrcaRouter مقابل قائمة النماذج الحية في التاريخ نفسه. وأنماط الفشل مستمدة من كيفية سلوك هذه الأدوات عندما تكون صلاحيات رمز سير العمل غير كافية، وليس من تقرير حادث محدد.