بناء مكتبة مطالباتك

مكتبة المطالبات الشخصية توفر الوقت وتضمن الاتساق. يوفر هذا الدرس قوالب جاهزة للاستخدام لمهام التطوير الشائعة.

لماذا تبني مكتبة مطالبات؟

الفوائد:
├── الاتساق عبر المشاريع
├── توفير الوقت (لا إعادة اختراع)
├── خط أساس الجودة (مطالبات مُختبرة)
├── قدرات المشاركة مع الفريق
└── التحسين المستمر

القوالب الأساسية

1. توليد الكود

إنشاء دالة

أنشئ دالة [language] اسمها [functionName]:

الغرض: [ماذا تفعل]

المعاملات:
- [param1]: [النوع] - [الوصف]
- [param2]: [النوع] - [الوصف]

تُرجع: [النوع] - [الوصف]

المتطلبات:
- تعامل مع الحالات الحدية: [قائمة الحالات]
- ارمِ أخطاء لـ: [الشروط]
- تضمين JSDoc/docstring

مثال الاستخدام:
[أظهر المدخل/المخرج المتوقع]

طابق النمط في: @[ملف مرجعي]

2. الاختبار

اختبار الوحدة

اكتب اختبارات وحدة لـ @[مسار الملف]:

إطار الاختبار: [Jest/Vitest/pytest/إلخ]
هدف التغطية: [النسبة أو دوال محددة]

حالات الاختبار المطلوبة:
- المسار السعيد: [السيناريوهات]
- الحالات الحدية: [السيناريوهات]
- حالات الخطأ: [السيناريوهات]

متطلبات المحاكاة:
- [ما تحاكيه وكيف]

اتبع الأنماط في: @[ملف اختبار موجود]

3. إعادة الهيكلة

استخراج دالة

في @[مسار الملف]، استخرج المنطق في الأسطر [X-Y] إلى دالة منفصلة:

اسم الدالة: [الاسم المقترح]
الغرض: [لماذا الاستخراج]

تأكد من:
- لا تغيير في السلوك
- نقل معالجة الأخطاء المناسبة
- الاختبارات لا تزال تمر
- أضف اختبارات جديدة إذا لزم للدالة المستخرجة

4. إصلاح الأخطاء

قالب التصحيح

تقرير خطأ لـ @[مسار الملف]:

السلوك الملاحظ: [ما يحدث]
السلوك المتوقع: [ما يجب أن يحدث]
خطوات إعادة الإنتاج:
1. [خطوة 1]
2. [خطوة 2]

رسالة الخطأ (إن وُجدت):

[مخرج الخطأ]

حقق وقدم:
1. تحليل السبب الجذري
2. تنفيذ الإصلاح
3. حالة اختبار لمنع التراجع

5. التوثيق

توثيق الكود

أضف توثيقاً لـ @[مسار الملف]:

النمط: [JSDoc/TSDoc/docstrings]

وثّق:
- جميع الدوال المُصدّرة
- كتل المنطق المعقدة
- طرق الفئة العامة
- تعريفات الأنواع

تضمين:
- أوصاف المعاملات
- أوصاف قيمة الإرجاع
- أمثلة الاستخدام
- ملاحظات الحالات الحدية

6. تطوير API

نقطة نهاية REST

أنشئ نقطة نهاية REST:

المسار: [METHOD] /api/[path]
المصادقة: [لا شيء/جلسة/JWT/مفتاح API]

الطلب:
- الرؤوس: [الرؤوس المطلوبة]
- معاملات الاستعلام: [المعاملات]
- مخطط الجسم:
```json
{
  "field": "type"
}

الاستجابة:

• النجاح (200):

{
  "data": {}
}

• الأخطاء: [قائمة رموز الحالة والمعاني]

التحقق:

• [قواعد التحقق]

اتبع النمط: @[ملف مسار موجود]

### 7. قاعدة البيانات

#### الترحيل

أنشئ ترحيل قاعدة بيانات:

الغرض: [أي تغيير]

تغييرات المخطط:

• أضف جدول: [الاسم] مع أعمدة [قائمة]
• عدّل عمود: [table.column] [التغيير]
• أضف فهرس: [الاسم] على [table(columns)]

ترحيل البيانات: [إذا لزم]

استراتيجية التراجع: [كيفية العكس]

ORM: [Prisma/TypeORM/Drizzle/إلخ]

### 8. الأمان

#### مراجعة الأمان

مراجعة أمان لـ @[ملف أو ميزة]:

تحقق من:

• التحقق من المدخلات
• حقن SQL/NoSQL
• ثغرات XSS
• حماية CSRF
• تجاوز المصادقة
• مشاكل التفويض
• كشف البيانات الحساسة
• تحديد المعدل

قدم:

• النتائج مع الشدة
• توصيات إصلاح محددة
• أمثلة كود للإصلاحات

## استراتيجيات التنظيم

### هيكل الملفات

prompts/ ├── generation/ │ ├── functions.md │ ├── components.md │ └── classes.md ├── testing/ │ ├── unit.md │ └── integration.md ├── refactoring/ │ ├── extract.md │ └── improve.md ├── debugging/ │ └── investigate.md └── project-specific/ └── [project-name].md

### حلقة التحسين

1. استخدم قالباً
2. لاحظ ما نجح/لم ينجح
3. حدّث القالب
4. التزم بالتحسين
5. كرر

### المشاركة مع الفريق

prompts/ ├── team/ # قوالب الفريق المشتركة ├── personal/ # قوالبك الشخصية └── project/ # قوالب خاصة بالمشروع

> **حكمة المكتبة:** ابدأ بـ 5-10 قوالب لمهامك الأكثر شيوعاً. نمّ المكتبة عضوياً كلما اكتشفت أنماطاً. الجودة فوق الكمية—قالب ممتاز واحد أفضل من عشرة متوسطة.

الآن لديك أساس للمطالبة الفعالة. في الوحدة 5، سنتعلم كيفية تصحيح الكود المُنتج بالذكاء الاصطناعي.
:::