💬 NLP

RPG: A Repository Planning Graph for Unified and Scalable Codebase Generation

تقدم الورقة البحثية (RPG)، وهو مخطط تخطيط مستودع مهيكل يستبدل التخطيط باللغة الطبيعية الغامضة بمخططات صريحة، مما يمكن إطار عمل (ZeroRepo) من توليد مستودعات برمجية أكبر بكثير وأكثر تماسكاً وأعلى جودة مع دقة اختبار محسنة مقارنة بالنماذج المرجعية الحالية.

المؤلفون الأصليون: Jane Luo, Xin Zhang, Steven Liu, Jie Wu, Jianfeng Liu, Yiming Huang, Yangyu Huang, Chengyu Yin, Ying Xin, Yuefeng Zhan, Hao Sun, Qi Chen, Scarlett Li, Mao Yang

نُشر 2026-02-16

📖 4 دقيقة قراءة☕ قراءة في استراحة قهوة

CC BY 4.0

المؤلفون الأصليون: Jane Luo, Xin Zhang, Steven Liu, Jie Wu, Jianfeng Liu, Yiming Huang, Yangyu Huang, Chengyu Yin, Ying Xin, Yuefeng Zhan, Hao Sun, Qi Chen, Scarlett Li, Mao Yang

البحث الأصلي مرخَّص بموجب CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). ✨ هذا شرح مولَّده بالذكاء الاصطناعي للبحث أدناه. لم يكتبه المؤلفون ولم يصادقوا عليه. وللتحقق من الدقة التقنية، يرجى الرجوع إلى البحث الأصلي. اقرأ إخلاء المسؤولية الكامل

تخيل أنك تسأل مهندساً معمارياً عبقرياً ولكنه فوضوي قليلاً أن يبني مدينة ضخمة وصاخبة من الصفر بناءً على جملة واحدة فقط: "ابنِ مدينة لتعلم الآلة."

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

تقدم هذه الورقة البحثية RPG (مخطط تخطيط المستودع) و ZeroRepo، وهي طريقة جديدة لمساعدة الذكاء الاصطناعي على بناء "مدن" برمجية (مستودعات) ضخمة، منظمة، وتعمل بالفعل.

إليك تفصيل ذلك باستخدام تشبيهات بسيطة:

1. المشكلة: نهج "سلطة الكلمات"

أدوات البرمجة الحالية بالذكاء الاصطناعي بارعة في كتابة فقرة واحدة (دالة/Function) أو صفحة واحدة (ملف). ولكن عندما يُطلب منها كتابة كتاب كامل (مستودع برمجيات)، فإنها تميل إلى الضياع.

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

2. الحل: "المخطط الهندسي" (RPG)

لقد ابتكر المؤلفون شيئاً يسمى مخطط تخطيط المستودع (RPG). فكر في هذا ليس كمجرد قائمة كلمات، بل كـ مخطط هندسي تفاعلي وحي.

العُقد هي الغرف: بدلاً من مجرد كتابة "نحتاج إلى مطبخ"، يقوم الـ RPG بإنشاء عقدة محددة للمطبخ، وأخرى لغرفة النوم، وأخرى للسباكة.
الحواف هي الأنابيب والأسلاك: يرسم الـ RPG خطوطاً بين هذه العُقد. فهو يعلم أن مضخة المياه (العقدة أ) يجب أن تتصل بـ مغسلة المطبخ (العقدة ب) قبل أن يمكن لـ الصنبور (العقدة ج) أن يعمل.
لماذا هذا مهم: هذا يزيل التخمين. لا يحتاج الذكاء الاصطناعي إلى "تذكر" كيفية اتصال الأشياء؛ المخطط هو من يخبره بالضبط بما يجب بناؤه وبالترتيب الصحيح.

3. البنّاء: ZeroRepo

ZeroRepo هو طاقم البناء الذي يستخدم هذا المخطط. وهو يعمل عبر ثلاث مراحل متميزة:

المرحلة الأولى: الاقتراح (الـ "ماذا"):
تخيل مخططاً رئيسياً ينظر إلى كتالوج ضخم لكل ميزة ممكنة في العالم (مثل "تحميل البيانات"، "التجميع/Clustering"، "التصور البياني"). يختار المخطط الميزات المطلوبة لهذه المدينة تحديداً ويرتبها في خريطة أولية.
المرحلة الثانية: التنفيذ (الـ "كيف"):
الآن، يقوم المخطط بالتقريب (Zoom in). يحول عقدة "المطبخ" إلى قائمة ملفات محددة: sink.py و stove.py و fridge.py. ويرسم الأنابيب (تدفق البيانات) التي توضح كيف تتحرك المياه من الخط الرئيسي إلى المغسلة. هذا ينشئ الـ RPG الكامل.
المرحلة الثالثة: البناء (الـ "بناء"):
يبدأ الذكاء الاصطناعي بالبناء. لكنه لا يكتب الكود فحسب؛ بل يتبع ترتيب المخطط.
- يبني الأساس أولاً.
- يبني الجدران.
- الأمر الحاسم: بعد بناء كل غرفة، يقوم فوراً بإجراء "فحص سلامة" (اختبارات). إذا كان هناك تسريب في المغسلة، فإنه يصلحه قبل الانتقال إلى الغرفة التالية. هذا يضمن أن المدينة بأكملها لن تنهار لاحقاً.

4. النتائج: مدينة مقابل كوخ

اختبر الباحثون هذا النظام مقابل أفضل مبرمجي الذكاء الاصطناعي الآخرين (مثل Claude Code) باستخدام اختبار يسمى RepoCraft (وهو اختبار يحتوي على 6 مشاريع حقيقية مثل أدوات البيانات وأطر عمل الويب).

الحجم: بنى الذكاء الاصطناعي الذي يستخدم RPG كوداً أكبر بـ 3.9 مرة من أفضل منافسيه. لم يبنِ مجرد كوخ، بل بنى ناطحة سحاب.
الجودة: اجتاز 81.5% من الاختبارات الوظيفية، مقارنة بـ 54% للمنافس.
القابلية للتوسع: كلما كبر المشروع، استمرت طريقة RPG في التحسن (نمو خطي)، بينما ارتبكت الطرق الأخرى وتوقفت عن إضافة الميزات.

5. تشبيه "نظام تحديد المواقع (GPS)" للعثين عن الأخطاء

أحد أصعب أجزاء البرمجة هو العثور على خطأ (Bug) في قاعدة بيانات برمجية ضخمة.

بدون RPG: الأمر يشبه البحث عن جورب مفقود معين في كومة غسيل ضخمة وفوضوية. عليك البحث في كل شيء.
مع RPG: الأمر يشبه امتلاك نظام GPS. يعرف الذكاء الاصطناعي بالضبط في أي "غرفة" (ملف) وأي "رف" (دالة) يوجد الجورب لأن الخريطة أخبرته أين ينتمي كل شيء. جعل هذا الذكاء الاصطناعي أسرع بنسبة 30-50% في إصلاح الأخطاء.

الملخص

تتعلق هذه الورقة بتعليم الذكاء الاصطناعي التوقف عن "الارتجال" بالكلمات والبدء في "التخطيط" بالهيكلية. من خلال تزويد الذكاء الاصطناعي بـ خريطة مهيكلة (RPG) بدلاً من قائمة تعليمات غامضة، مكنوه من بناء أنظمة برمجية ضخمة ومعقدة متماسكة، مختبرة، وجاهزة لعالم الواقع.

إنه الفرق بين أن تطلب من طفل أن "يرسم مدينة" (مما ينتج عنه خربشات) وبين إعطاء مهندس معماري رسماً هندسياً (CAD) يوضح كل أنبوب وسلك (مما ينتج عنه مدينة وظيفية).

إليك ملخص تقني مفصل لورقة البحث بعنوان "RPG: مخطط رسم بياني لتخطيط المستودعات من أجل توليد برمجيات موحد وقابل للتوسع".

1. بيان المشكلة

بينما تبرع النماذج اللغوية الكبيرة (LLMs) في توليد دوال فردية أو ملفات منفردة، فإن توليد مستودعات برمجية كاملة من الصفر لا يزال يمثل تحديًا جوهريًا. تواجه النهج الحالية ثلاث عقبات رئيسية:

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

تكمن الصعوبة الجوهرية في سد الفجوة بين نية المستخدم عالية المستوى والشبكة المعقدة من الملفات، والفئات (Classes)، والتبعيات المطلوبة لبناء نظام برمجيات متماسك.

2. المنهجية

يقترح المؤلفون RPG (مخطط رسم بياني لتخطيط المستودعات)، وهو تمثيل هيكلي مستمر يوحد بين التخطيط على مستوى المقترح والتخطيط على مستوى التنفيذ. وبناءً على RPG، طوروا ZeroRepo، وهو إطار عمل مدفوع بالرسوم البيانية لتوليد المستودعات.

أ. مخطط رسم بياني لتخطيط المستودعات (RPG)

يقوم RPG بترميز وظائف المستودع ومنطق التنفيذ في رسم بياني واحد قابل للتفسير آليًا:

العقد (Nodes): تمثل القدرات الهرمية (من الوحدات عالية المستوى إلى الدوال/الفئات المحددة) والعناصر الهيكلية (المجلدات، الملفات).
الحواف (Edges): تلتقط التبعيات الصريحة، بما في ذلك:
- حواف ما بين الوحدات (Inter-module edges): تدفقات البيانات بين الوحدات المختلفة (مثل: تحميل البيانات $\leftarrow$ خوارزميات تعلم الآلة).
- حواف داخل الوحدات (Intra-module edges): ترتيبات الملفات وتبعيات التنفيذ.
الفائدة: يستبدل هذا الهيكل اللغة الطبيعية الغامضة بمخطط صريح، مما يضمن الترتيب الطوبولوجي والتماسك بين الدلالات العامة والتنفيذ المحلي.

ب. إطار عمل ZeroRepo

يعمل ZeroRepo عبر ثلاث مراحل متميزة:

بناء مستوى المقترح:
- ترجمة مواصفات المستخدم عالية المستوى إلى رسم بياني وظيفي.
- استخدام استراتيجية الاستكشاف والاستغلال (Explore-Exploit) عبر شجرة ميزات EpiCoder (قاعدة معرفية تضم 1.5 مليون قدرة برمجية) لاختيار الميزات ذات الصلة.
- إعادة صياغة الميزات المختارة إلى رسم بياني وظيفي نمطي، مع ضمان استيفاء مبادئ التماسك والاقتران.
بناء مستوى التنفيذ:
- إثراء الرسم البياني الوظيفي بتفاصيل تنفيذ ملموسة لتشكيل الـ RPG الكامل.
- ترميز هيكل الملفات: ربط الوحدات بأسماء النطاقات (Namespaces) للمجلدات وتعيين الملفات للعقد المتوسطة.
- ترميز تدفق البيانات والدوال: تحديد قيود المدخلات والمخرجات، وتجريد الهياكل المشتركة في فئات أساسية (مثل BaseEstimator)، وربط الميزات الطرفية بدوال أو فئات محددة.
توليد الكود الموجه بالرسم البياني:
- التنقل في الـ RPG وفق ترتيب طوبولوجي لضمان حل التبعيات قبل العناصر التي تعتمد عليها.
- توظيف التطوير القائم على الاختبار (TDD): تُشتق الاختبارات من المواصفات، ثم يتم توليد الكود، وتؤدي الاختبارات الفاشلة إلى عمليات تصحيح وتحرير تكرارية.
- التحديد الموضعي (Localization): استخدام البحث الموجه بالرسم البياني، وعروض كود المستودع، واستكشاف التبعيات لتحديد مكان التعديل بدقة، مما يسرع عملية تصحيح الأخطاء بشكل كبير.

3. المساهمات الرئيسية

مخطط رسم بياني لتخطيط المستودعات (RPG): تمثيل موحد ومبتكر يدمج تخطيط المقترح وتخطيط التنفيذ، ويشفر الوظائف، وهياكل الملفات، وتدفقات البيانات، وتصميمات الدوال في رسم بياني واحد.
إطار عمل ZeroRepo: نظام مدفوع بالرسوم البيانية يبني الـ RPGs من خلال التخطيط متعدد المستويات ويولد الكود مع التحقق الصارم من الاختبارات.
معيار RepoCraft: معيار تقييم جديد يتكون من 6 مشاريع واقعية (مثل scikit-learn، pandas، django) و 1,052 مهمة مصممة لتقييم التغطية، والدقة، وحجم الكود في توليد المستودعات.
التحقق التجريبي: أثبت أن التخطيط الهيكلي بالرسوم البيانية يتفوق على النماذج المرجعية القائمة على اللغة الطبيعية من حيث النطاق، والصحة، والتعقيد.

4. النتائج التجريبية

عند تقييمه على معيار RepoCraft، حقق ZeroRepo أداءً هو الأفضل في فئته:

النطاق: ولد ZeroRepo مستودعات تحتوي على 36 ألف سطر من الكود (LOC) و 445 ألف رمز برمجي (Tokens) (باستخدام Qwen3-Coder)، وهو ما يعادل 3.9 ضعف أقوى نموذج مرجعي (Claude Code) و 68 ضعفًا من النماذج المرجعية الأخرى.
التغطية والدقة:
- التغطية الوظيفية: 81.5% (مقابل 54.2% لـ Claude Code).
- معدل اجتياز الاختبار: 69.7% (مقابل 33.9% لـ Claude Code)، مما يمثل تحسنًا قدره 35.8 نقطة.
القابلية للتوسع:
- يتيح RPG توسعًا شبه خطي للميزات وحجم الكود عبر التكرارات. وبينما تستقر النماذج المرجعية القائمة على اللغة الطبيعية بعد عدد قليل من التكرارات (غالبًا بسبب حدود السياق أو عدم الاتساق)، يستمر ZeroRepo في النمو بشكل متماسك حتى أكثر من 30 تكرارًا.
كفاءة التحديد الموضعي: قلل التحديد الموضعي الموجه بالرسم البياني من الجهد المطلوب لتصحيح الأخطاء والتطوير التدريجي بنسبة 30-50% مقارنة بالنهج غير المعتمد على الرسوم البيانية.

5. الأهمية

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

في الختام، يمثل RPG و ZeroRepo قفزة نوعية في توليد الكود المؤتمت، مما يثبت أن التخطيط الهيكلي المعتمد على الرسوم البيانية ضروري لبناء مستودعات برمجية واسعة النطاق، ومتماسكة، وصحيحة.