الفصل 09
كتابة الكود بالبرومبت

كيف تكتب برومبتات فعالة لتوليد كود احترافي.
2 دقيقة قراءة
هيكل برومبت الكود الفعال
لكتابة برومبت كود ناجح، حدد: 1. اللغة/الإطار: Python, JavaScript, React, etc. 2. المهمة: ماذا يفعل الكود بالضبط 3. المدخلات: ما البيانات التي يستقبلها 4. المخرجات: ما النتيجة المتوقعة 5. القيود: أداء، أمان، أسلوب كتابة 6. أمثلة: مثال input/output إن أمكن
مثال 1: برومبت Python
اكتب function بلغة Python:
الاسم: analyze_sales
الوصف: تحلل بيانات مبيعات شهرية وتعيد تقرير
المدخل: قائمة dictionaries بهذا الشكل:
[{"month": "يناير", "revenue": 50000, "orders": 120}, ...]
المخرج: dictionary يحتوي:
- total_revenue: إجمالي الإيرادات
- avg_monthly: متوسط شهري
- best_month: أفضل شهر
- worst_month: أسوأ شهر
- growth_rate: نسبة النمو (أول شهر لآخر شهر)
المتطلبات:
- Type hints
- Docstring بالعربية
- معالجة حالة القائمة الفارغة
- تعليقات توضيحيةمثال 2: برومبت React
اكتب React component:
الاسم: ContactForm
الوصف: نموذج تواصل مع validation
الحقول:
- الاسم (مطلوب، أقل 3 أحرف)
- البريد (مطلوب، صيغة email صحيحة)
- الرسالة (مطلوبة، 10-500 حرف)
- رقم الجوال (اختياري، صيغة سعودية 05xxxxxxxx)
المتطلبات:
- TypeScript
- CSS Modules أو Tailwind
- رسائل خطأ بالعربية
- تصميم RTL
- زر إرسال يتعطل أثناء الإرسال
- رسالة نجاح بعد الإرسال✦
نصائح لبرومبتات الكود
• حدد اللغة والإصدار — "Python 3.11" أدق من "Python" • اطلب error handling — "ماذا يحدث إذا كان المدخل فارغ؟" • اطلب tests — "أضف 3 unit tests" • حدد الأسلوب — "اتبع PEP 8" أو "اتبع Airbnb style" • اطلب تعليقات — "أضف تعليقات عربية توضيحية"