الرئيسيةمن أناالدوراتالمدونةسوق الأوامرالمناهج والباقاتالشركاء

دورات عربية متخصصة في التقنية والبرمجة والذكاء الاصطناعي.

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

المنصة

  • الرئيسية
  • من أنا
  • الدورات
  • المناهج والباقات
  • سوق الأوامر
  • المدونة

الدعم

  • الأسئلة الشائعة
  • تواصل معنا
  • سياسة الخصوصية
  • شروط استخدام التطبيق
  • سياسة الاسترجاع

© 2026 أحمد حايس. جميع الحقوق محفوظة.

الرئيسيةالدوراتالمناهجالمدونةالدخول
العودة لسوق الأوامر
قواعدقواعد استخدام ومراجعة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)، ولم يستبدل أي سطر بعبارة «باقي الكود كما هو» أو بثلاث نقاط.

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

نتحقق من حسابك الحالي قبل عرض نسخة الأمر الكاملة.

مثال ناتج

المهمة: أضِف دعم الخصم إلى دالة حساب إجمالي الفاتورة مع إبقاء ضريبة القيمة المضافة. الكود الحالي: 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)، ولم يستبدل أي سطر بعبارة «باقي الكود كما هو» أو بثلاث نقاط.

اشتراك مستقل

‏299 ج.م.‏30 يوماشتراك سوق الأوامر الشهري‏2,499 ج.م.‏365 يوماشتراك سوق الأوامر السنوي