أفضل ممارسات البرمجة التوليدية: تقنيات متقدمة للتطوير بمساعدة الذكاء الاصطناعي

ماذا ستتعلم

هذا الدليل يغطي تقنيات البرمجة التوليدية المتقدمة:

• استراتيجيات كتابة الأوامر الفعالة
• التحقق من الكود والأمان
• أنماط التعاون الجماعي
• متى لا تستخدم البرمجة التوليدية
• قياس مكاسب الإنتاجية

المتطلبات الأولية

• إكمال مقدمة البرمجة التوليدية
• إكمال إعداد البرمجة التوليدية
• خبرة أساسية مع التطوير بمساعدة الذكاء الاصطناعي

أفضل ممارسة 1: أتقن فن كتابة الأوامر

كن محدداً، وليس غامضاً

❌ أمر سيء:

اصنع نموذج مستخدم

✅ أمر جيد:

أنشئ نموذج تسجيل مستخدم React مع:
- حقل البريد الإلكتروني (تحقق من الصيغة)
- حقل كلمة المرور (8 أحرف كحد أدنى، زر إظهار/إخفاء)
- تأكيد كلمة المرور (يجب أن يتطابق)
- زر إرسال (معطل حتى يكون صالحاً)
- حالة تحميل أثناء الإرسال
- عرض الأخطاء لفشل API
استخدم react-hook-form و Zod للتحقق.
اتبع الأنماط الموجودة في src/components/forms/

قدم السياق

أعطِ الذكاء الاصطناعي دائماً السياق ذي الصلة:

أعمل على تدفق الدفع للتجارة الإلكترونية.
المشروع يستخدم Next.js 14 App Router مع server actions.
لدينا CartContext موجود في src/context/cart.tsx.
معالجة الدفع تتم عبر Stripe.

أنشئ مكون ملخص الدفع الذي:
- يعرض عناصر السلة من CartContext
- يظهر المجموع الفرعي والضريبة والإجمالي
- لديه زر "المتابعة للدفع"
- يتطابق مع التصميم في /designs/checkout.figma

استخدم الأمثلة

أظهر للذكاء الاصطناعي ما تريده:

أنشئ نقطة نهاية API لتفضيلات المستخدم.
اتبع هذا النمط الموجود من src/app/api/profile/route.ts:

export async function GET(req: Request) {
  const session = await getSession();
  if (!session) return unauthorized();
  // ... منطق المعالج
}

نقطة النهاية الجديدة يجب أن تتعامل مع GET و PATCH لتفضيلات المستخدم.

أفضل ممارسة 2: تحقق من الكود المولد بالذكاء الاصطناعي

راجع دائماً قبل الالتزام

أنشئ قائمة مراجعة ذهنية:

• هل يتطابق مع المتطلبات؟
• هل هناك أخطاء واضحة؟
• هل يتبع اتفاقيات المشروع؟
• هل هناك مشاكل أمنية؟
• هل معالجة الأخطاء كافية؟

شغّل الاختبارات

# شغل الاختبارات الموجودة
npm test
 
# اطلب من الذكاء الاصطناعي توليد اختبارات
"اكتب اختبارات وحدة للمكون الذي أنشأته للتو.
غطِ: التدفق العادي، الحالات الحدية، حالات الخطأ."

استخدم التحليل الثابت

# TypeScript يلتقط العديد من المشاكل
npm run typecheck
 
# Linting يلتقط الأسلوب والأخطاء الشائعة
npm run lint

أفضل ممارسة 3: الأمان أولاً

لا تثق أبداً بالذكاء الاصطناعي مع الأسرار

❌ لا تفعل هذا أبداً:

هذا مفتاح API الخاص بي: sk-xxxxx
أنشئ دالة لاستدعاء OpenAI API.

✅ افعل هذا بدلاً من ذلك:

أنشئ دالة لاستدعاء OpenAI API.
افترض أن مفتاح API متاح عبر process.env.OPENAI_API_KEY.
لا تسجل أو تكشف المفتاح أبداً.

انتبه للثغرات الشائعة

اطلب من الذكاء الاصطناعي التحقق من:

• حقن SQL (استخدم الاستعلامات المعلمة)
• XSS (طهر مدخلات المستخدم)
• CSRF (استخدم الرموز)
• تجاوز المصادقة
• كشف البيانات الحساسة

راجع هذا الكود للثغرات الأمنية:
[الصق الكود]
ركز على مشاكل OWASP Top 10.

أفضل ممارسة 4: كرر بشكل تدريجي

ابدأ صغيراً، توسع

بدلاً من طلب ميزة كاملة:

1. الأساس أولاً:

   أنشئ هيكل المكون الأساسي للوحة التحكم
   

2. أضف الوظائف:

   أضف hook لجلب البيانات لتحميل مقاييس لوحة التحكم
   

3. تعامل مع الحالات الحدية:

   أضف حالات التحميل والخطأ للوحة التحكم
   

4. صقل:

   أضف الرسوم المتحركة وحسن إمكانية الوصول
   

أفضل ممارسة 5: وثق أثناء العمل

احتفظ بالأوامر كتوثيق

احفظ الأوامر المهمة في مشروعك:

<!-- docs/ai-prompts/checkout-flow.md -->
# تنفيذ تدفق الدفع
 
## الأمر الأولي
[الصق الأمر الذي استخدمته]
 
## التحسينات المتابعة
[الصق أوامر المتابعة]
 
## القرارات الرئيسية
- استخدمنا server actions لمعالجة الدفع
- اخترنا Stripe على PayPal لـ API أفضل

أفضل ممارسة 6: التعاون الجماعي

وحّد كتابة الأوامر

أنشئ قوالب أوامر للفريق:

## السياق
[صف سياق المشروع/الميزة]
 
## المتطلبات
[اسرد المتطلبات المحددة]
 
## القيود
- يجب اتباع [معيار الترميز]
- يجب استخدام [مكتبات محددة]
- يجب مطابقة [تصميم/أنماط]
 
## الأمثلة
[قدم أمثلة كود ذات صلة]

راجع طلبات السحب المولدة بالذكاء الاصطناعي بعناية

علّم الكود المولد بالذكاء الاصطناعي في PRs:

## وصف PR
 
🤖 **بمساعدة الذكاء الاصطناعي:** هذا PR تم إنشاؤه بمساعدة الذكاء الاصطناعي.
 
**المراجعة البشرية ركزت على:**
- [ ] الآثار الأمنية
- [ ] اعتبارات الأداء
- [ ] معالجة الحالات الحدية
- [ ] تغطية الاختبارات

أفضل ممارسة 7: اعرف متى لا تستخدم البرمجة التوليدية

تجنب البرمجة التوليدية لـ:

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

استخدم البرمجة التوليدية لـ:

• الكود المتكرر: النماذج، CRUD، الأنماط القياسية
• النماذج الأولية: إثبات المفاهيم السريع
• إعادة الهيكلة: تحويل الكود، التحديث
• التوثيق: التعليقات، READMEs، مستندات API
• الاختبارات: اختبارات الوحدة، اختبارات التكامل

قياس النجاح

تتبع هذه المقاييس

• الوقت للنسخة العاملة الأولى: أسرع مع البرمجة التوليدية
• معدل الأخطاء: يجب أن يبقى نفسه أو يتحسن
• وقت مراجعة الكود: قد ينخفض مع أوامر جيدة
• رضا المطورين: استطلع فريقك

الملخص

النقاط الرئيسية:

1. اكتب الأوامر بفعالية - كن محدداً، قدم السياق، أظهر الأمثلة
2. تحقق بصرامة - راجع واختبر وافحص كل كود AI
3. الأمان أولاً - لا تثق بالذكاء الاصطناعي مع الأسرار، تحقق من الثغرات
4. كرر بشكل تدريجي - ابنِ الميزات بخطوات صغيرة
5. وثق كل شيء - احفظ الأوامر والقرارات
6. تعاون بذكاء - وحّد ممارسات الفريق
7. اعرف الحدود - استخدم البرمجة التوليدية حيث يتفوق

الخطوات التالية

• مركز البرمجة التوليدية - جميع الموارد
• احصل على مساعدة البرمجة التوليدية - مساعدة الخبراء