← العودة إلى المدونة
Aiحوالي 1 دقيقة قراءة

المراجع الذي لم يرد وظيفتك

نُشر في 9 نوفمبر 2026
المراجع الذي لم يرد وظيفتك

معظم وكلاء البرمجة بالذكاء الاصطناعي التي يتجادل عليها الناس في 2026 تحاول كتابة كودك. أما PR-Agent فيحاول قراءته.

لديه 15,539 نجمة، ويعيش في The-PR-Agent/pr-agent، وREADME يفتح الآن بسطر يبدو كأن من كتبه خاض هذه المحادثة مرات كثيرة: «المراجع مفتوح المصدر الأصلي لطلبات الدمج. هذا المشروع ليس الطبقة المجانية من Qodo.»

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

ما يفعله، في أربعة أوامر

المنتج كله أربعة أوامر مائلة على طلب دمج.

/describe يكتب وصف طلب الدمج — ما تغير، ولماذا، وما ينبغي أن ينظر إليه المراجع أولًا. و/review يقوم بالمراجعة: أخطاء محتملة، ومخاوف أمنية، واختبارات ناقصة، وتناقضات مع بقية الملف. و/improve يقترح تغييرات كود ملموسة. و/ask يجيب عن سؤال حول الفرق، في الخيط، والفرق سياقه.

كل واحد من هذه استدعاء واحد لنموذج لغوي. ويضعه الـREADME في نحو ثلاثين ثانية وبكلفة منخفضة، وهذا هو قيد التصميم الذي شكّل كل شيء آخر. لا حلقة وكيل، ولا شجرة استدعاء أدوات، ولا خطة متعددة الخطوات. وصف واحد، ورد واحد، وتعليق واحد.

يبدو هذا مخيبًا حتى تتذكر ما حلّ محله: مراجع يفتح طلب دمج من 1,400 سطر في السادسة مساءً ويتصفحه بسرعة.

تثبيته

ثلاثة طرق، بترتيب مقدار التفكير الذي تحتاجه.

إجراء GitHub ملف سير عمل واحد. ضع هذا في .github/workflows/pr-agent.yml:

on: pull_request: types: [opened, synchronize]
uses: the-pr-agent/pr-agent@main
env: OPENAI_KEY, GITHUB_TOKEN

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

واجهة سطر الأوامر لتشغيله محليًا على طلب لم تكتبه:

pip install "pr-agent[github]"
export OPENAI_KEY=your_key_here
pr-agent --pr_url <url> review

ثبّت إضافة المزود للمنصة التي تستخدمها، أو pr-agent[all] إن أردت كل التكاملات.

Webhooks والاستضافة الذاتية للفرق التي تحتاج المراجعة داخل شبكتها. صور Docker موجودة. وGitLab يستخدم إعداد webhook، وBitbucket تثبيت تطبيق، وAzure DevOps مسارًا خاصًا. وGitea مدعوم أيضًا.

A printed page with a red pen mark in the margin beside a cooling cup of coffee

قرارا الهندسة اللذان يجعلانه صالحًا للاستخدام

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

تهيئة الوصف كبيانات. فئات المراجعة والنبرة وما تريد الإشارة إليه وما تريد تجاهله تعيش في ملف TOML لا في Python. فيمكنك إضافة فئة — «تحقق أن كل عمود قاعدة بيانات جديد له ترحيل» — دون لمس الكود. والفرق التي تتبنى هذا تنتهي عادة بتهيئة ترمز ثقافة المراجعة عندها، وهذا الفرق بين مدقق عام وشيء يوافق عليه مهندس أول فعلًا.

واختيار النموذج مفتوح عبر LiteLLM: OpenAI وClaude وGemini وDeepSeek وMistral، إضافة إلى Azure OpenAI وBedrock وVertex وDatabricks وOpenRouter وOllama. فإن كنت تشغّل نموذجًا محليًا للسرية، فهذا أحد المراجعين القلائل الذين سيتبعونك إلى هناك.

كيف يبدو تعليق مراجعة مفيد

الفرق بين روبوت مراجعة يساعد وآخر يُكتَم ليس الدقة. بل هل التعليق محدد بما يكفي للتصرف.

«فكّر في إضافة معالجة أخطاء هنا» أسوأ من لا شيء، لأنه يشعر القارئ بأنه مراقب دون أن يقول له شيئًا. أما «هذا الاستدعاء يمكن أن يعيد null عند فقد الذاكرة المؤقتة؛ والمستدعي أسفل بثلاثة أسطر يفكّه دون تحقق» فمفيد حتى لو كان الروبوت محقًا 70% فقط، لأن التحقق يستغرق عشر ثوانٍ.

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

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

عيب صادق واحد في الـREADME

/help_docs معطل منذ v0.36.1 انتظارًا لإصلاح مشكلة كشف بيانات اعتماد، مسجلة كقضية #2445. والملاحظة هناك في قسم الخصائص، لا مدفونة في سجل التغييرات.

يعجبني أنها مرئية. فروبوت المراجعة لديه وصول قراءة إلى مصدرك. وخطأ كشف بيانات اعتماد في أداة تقرأ مصدرك شيء تريد الإفصاح عنه بصوت عالٍ، وقد فعل المشرفون ذلك بدل إزالة الأمر بهدوء والأمل ألا يلاحظ أحد.

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

لماذا صمد هذا ولم تصمد الوكلاء الأكثر بريقًا

كانت هناك عشرات الشركات الناشئة لمراجعة الكود بالذكاء الاصطناعي في 2024 و2025. مات معظمها أو ابتُلع. والمراجع المفتوح المصدر الذي بدأ كمشروع جانبي ما زال هنا، وما زال يُصان، وما زال يشحن تغييرات تهيئة.

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

قارن ذلك بأطر الوكلاء التي تريد الاستيلاء على سير عملك كله. تلك أكثر إبهارًا وأصعب بكثير في الإبقاء عليها تعمل. أما PR-Agent فيطلب ملف سير عمل ومفتاحًا.

إن كنت ستجربه

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

ثم اكتب الفئات التي تهمك فعلًا وضعها في التهيئة. فالمراجع العام يعطي ملاحظات عامة. والقيمة تصل حين يتحقق الروبوت من الأشياء الثلاثة التي ينساها فريقك دائمًا — وأنت من يخبره أيها.

مقالات ذات صلة

جدول نقرات يديره المجتمع يطفئ الإعلانات داخل بناءات أندرويد الصينية

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

GPT Image 2.6 أبقى على سعر الرموز ورفع الفاتورة

أبقى GPT Image 2.6 على كل أسعار الرموز كما كانت في 2.5، ومع ذلك صارت الصورة الواحدة أكثر كلفة، لأن جزءاً أكبر من العمل يجري الآن في رموز الإخراج. بعد أحد عشر يوماً من الإطلاق، تقول بنية التسعير أكثر مما تقوله لوحة الصدارة.

أحدهم أعاد بناء IDM من الخارج وكتب ما لم يمسّه

إعادة تنفيذ بلغة Rust لبرنامج Internet Download Manager تزعم سرعة أكبر بخمسة أضعاف ودعماً لـ 86 لغة. والوثيقة الأكثر إثارة للاهتمام هي الفقرة التي تشرح كيف بُني المشروع دون نسخ أي شيء.

Rune إطار عمل UI بلغة Rust صُمم كي يستطيع الوكيل التحقق من عمله

يرسم Rune بلا واجهة، ويفرّغ شجرة عناصره، ويقبل إدخالًا مكتوبًا، ما يمنح وكيل البرمجة إشارة قابلة للمقارنة لا تقدمها لقطة الشاشة أبدًا. الإطار في مرحلة ما قبل الإصدار ولا يستقبل pull requests.