قواعدقواعد استخدام ومراجعة0 مرة نسخ

قاعدة إخراج كود كامل قابل للتشغيل (ممنوع الاختصار بـ «باقي الكود كما هو» أو حذف المنطق)

قاعدة تشغيل تُوضع في موجّه النظام أو بداية المحادثة لإجبار مساعد الكود على إخراج كود كامل قابل للتشغيل بدل مقتطف ناقص أو هيكل مختصر يترك فجوات. المشكلة التي تعالجها شائعة ومكلفة مع وكلاء الكود: يستبدل النموذج أجزاءً من الكود بعبارات اختصار مثل «// باقي الكود كما هو» أو «# ... نفس السابق» أو ثلاث نقاط «...»، أو يقدّم دالة فارغة (pass/return None) على أنها مكتملة، أو يحذف عند التعديل منطقًا قائمًا بصمت، فينتج كود لا يعمل من أول لصق ويضيّع وقت المطوّر في إعادة تركيب الفجوات. تفرض هذه القاعدة عقدًا واضحًا على اكتمال المخرَج: إعادة الوحدة كاملة (دالة/ملف) أو diff دقيق كامل، ومنع أي عبارة تحذف منطقًا، ومنع الدوال الوهمية المقدَّمة كمكتملة، وتضمين الاستيرادات والتعريفات وما يلزم للتشغيل مع مثال قصير عند الإمكان، وتمييز أي جزء مؤجَّل بـ TODO موصوف صريح بدل ادّعاء الاكتمال، وتقسيم الإجابات الطويلة إلى كتل متتابعة مرقّمة دون حذف منطق، وطلب أي تعريف أو توقيع جوهري ناقص بدل اختراع واجهة غير موجودة. تختلف هذه القاعدة جوهريًا عن قاعدة جودة كود Go (التي تضبط أسلوب وجودة الكود ضمن لغة محددة) وعن مهارات مراجعة الكود وحارس Clean Code (التي تقيّم كودًا مكتوبًا بالفعل): هدف هذه القاعدة هو اكتمال المخرَج نفسه وقابليته للتشغيل من أول لصق، لا أسلوبه ولا مراجعته. كما تختلف عن قاعدة إخراج JSON الصارم التي تضبط شكل بيانات آلية القراءة لا كود المصدر. مناسبة لكل من يولّد أو يعدّل كودًا عبر Claude Code وCursor وCodex وAntigravity ويريد كودًا كاملاً يعمل مباشرة بدل مقتطفات مبتورة.

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

Claude CodeCursorCodexAntigravityClaudeChatGPTGeminiDeepSeekai rulecode output

الشكل المتوقع للناتج

المهمة: أضِف دعم الخصم إلى دالة حساب إجمالي الفاتورة مع إبقاء ضريبة القيمة المضافة. الكود الحالي: def calc_total(items, vat): subtotal = sum(i["price"] * i["qty"] for i in items) return subtotal * (1 + vat) مخرج مرفوض (يخالف القاعدة): def calc_total(items, vat, disc=0): subtotal = sum(i["price"] * i["qty"] for i in items) # ... باقي المنطق كما هو مع تطبيق الخصم ... مخرج مطابق للقاعدة (كامل قابل للتشغيل): def calc_total(items, vat, disc=0.0): if not 0 <= disc <= 1: raise ValueError("الخصم يجب أن يكون بين 0 و 1") subtotal = sum(i["price"] * i["qty"] for i in items) total = subtotal * (1 - disc) * (1 + vat) return round(total, 2) # مثال تشغيل كامل items = [{"price": 100, "qty": 2}, {"price": 50, "qty": 1}] print(calc_total(items, vat=0.15, disc=0.10)) # 258.75 الفرق: المخرج المطابق أعاد الدالة كاملة بعد التعديل، وأضاف تحقق مدى الخصم، وضمّن مثال تشغيل بنتيجة فعلية (258.75)، ولم يستبدل أي سطر بعبارة «باقي الكود كما هو» أو بثلاث نقاط.

مثال ناتج

قاعدة إخراج كود كامل قابل للتشغيل (ممنوع الاختصار بـ «باقي الكود كما هو» أو حذف المنطق)

الشكل المتوقع للناتج

جاري تجهيز الوصول