انتقل إلى المحتوى الرئيسي

كيفية استخدام الإيعازات في Cursor

تلميح

يمكن أن يؤدي الاستخدام الفعال للإيعازات إلى تحسين إنتاجية البرمجة بشكل كبير في Cursor من خلال الاستفادة من المساعدة بالذكاء الاصطناعي.

فهم الإيعازات​

إيعازات Cursor هي تعليمات بلغة طبيعية تساعد في:

  • توليد الكود
  • تصحيح المشكلات
  • إعادة هيكلة الكود الحالي
  • الحصول على تفسيرات
  • أتمتة المهام

أنواع الإيعازات الأساسية​

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

# توليد الكود الأساسي
/generate إنشاء مكون زر React مع تأثير التحويم

2. شرح الكود​

# الحصول على تفسير للكود
/explain ماذا يفعل نمط التعبير العادي هذا: ^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$

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

# طلب إعادة الهيكلة
/refactor تحويل هذه الدالة لاستخدام async/await

كتابة إيعازات فعالة​

1. كن محدداً​

✅ إيعاز جيد:

/generate إنشاء دالة TypeScript للتحقق من صحة عنوان البريد الإلكتروني باستخدام التعبيرات العادية مع معالجة الأخطاء المناسبة

❌ إيعاز سيء:

/generate إنشاء مدقق بريد إلكتروني

2. توفير السياق​

/explain هذا الكود في سياق تطبيق React يستخدم Redux لإدارة الحالة:

3. استخدام المعلمات​

/generate language:typescript
         framework:react
         style:functional
         إنشاء مكون نموذج مع التحقق من صحة البريد الإلكتروني

ميزات الإيعازات المتقدمة​

1. المهام متعددة الخطوات​

/task إنشاء نظام مصادقة المستخدم
الخطوات:
1. إنشاء نموذج تسجيل الدخول
2. إضافة التحقق من الصحة
3. تنفيذ استدعاء API
4. معالجة الاستجابة
5. إضافة معالجة الأخطاء

2. إنشاء القوالب​

/template إنشاء قالب مكون React جديد يتضمن:
- TypeScript
- Styled Components
- اختبارات الوحدة
- التوثيق

3. القواعد المخصصة​

/rules إضافة قواعد مخصصة لـ:
- نمط الكود
- معالجة الأخطاء
- التوثيق
- متطلبات الاختبار

إيعازات خاصة باللغة​

JavaScript/TypeScript​

/generate js
إنشاء فئة ES6 للتعامل مع طلبات API تتضمن:
- تكامل Axios
- معالجة الأخطاء
- تخزين الطلبات مؤقتًا

مكونات React​

/generate react
إنشاء مكون تنقل متجاوب يتضمن:
- قائمة للجوال
- دعم الوضع المظلم
- ميزات إمكانية الوصول

أفضل الممارسات​

1. هيكلة الإيعازات​

/generate
الهدف: إنشاء برنامج وسيط للمصادقة
المتطلبات:
- التحقق من JWT
- الوصول المستند إلى الأدوار
- معالجة الأخطاء
- التسجيل
التقنيات:
- Express.js
- مكتبة jsonwebtoken

2. استخدام القوالب​

إنشاء قوالب إيعازات قابلة لإعادة الاستخدام:

# حفظ القالب
/template save auth-component
إنشاء مكون مصادقة يتضمن:
- نماذج تسجيل الدخول/التسجيل
- التحقق من الصحة
- تكامل API
- معالجة الأخطاء

# استخدام القالب
/template use auth-component

3. تضمين الأمثلة​

/generate
إنشاء دالة مشابهة لـ:
```javascript
function example(data) {
  return data.filter(item => item.active);
}

ولكن مع فحص النوع الإضافي ومعالجة الأخطاء


## أنماط الإيعازات

### 1. مراجعة الكود

```bash
/review
تحقق من هذا الكود للتأكد من:
- مشكلات الأداء
- الثغرات الأمنية
- أفضل الممارسات
- سلامة النوع

2. التوثيق​

/doc
إنشاء وثائق لـ:
- معلمات الدالة
- القيم المرجعة
- الأمثلة
- الحالات الحدية

3. الاختبار​

/test
إنشاء اختبارات وحدة تتضمن:
- المسار السعيد
- الحالات الحدية
- سيناريوهات الخطأ
- السلوك غير المتزامن

التقنيات المتقدمة​

1. ربط الإيعازات​

/chain
1. إنشاء خدمة API
2. إضافة معالجة الأخطاء
3. إنشاء الاختبارات
4. إضافة التوثيق

2. الوعي بالسياق​

/context
اعتبارات:
- استيراد الملف الحالي
- هيكل المشروع
- التبعيات
- معايير الترميز

3. التحسين التكراري​

/refine
تحسين الكود المُنشأ من خلال:
1. إضافة سلامة النوع
2. تحسين الأداء
3. تعزيز القراءة
4. إضافة التعليقات

استكشاف الأخطاء وإصلاحها​

المشكلات الشائعة​

  1. نتائج غير واضحة

    /clarify
    لم يتم معالجة ما يلي في الإنشاء السابق:
    - الحالات الحدية
    - سيناريوهات الخطأ

  2. سياق مفقود

    /context add
    المشروع يستخدم:
    - React 18
    - TypeScript 4.8
    - Material UI

  3. إنشاء غير مكتمل

    /continue
    الرجاء إكمال التنفيذ بما في ذلك:
    - معالجة الأخطاء
    - تعريفات النوع

نصائح التكامل​

1. إدارة الإصدار​

/generate
كتابة رسالة التزام تتبع:
- اتفاقيات الالتزام
- مراجع المشكلة
- التغييرات الرئيسية

2. إعداد المشروع​

/setup
تهيئة المشروع باستخدام:
- تكوين TypeScript
- قواعد ESLint
- إعداد Prettier
- خطافات Git

3. التوثيق​

/doc
إنشاء وثائق المشروع:
- README.md
- وثائق API
- تعليمات الإعداد
- إرشادات المساهمة

نصائح للنجاح​

  1. كن واضحًا ومحددًا

    • حدد المتطلبات
    • قدم أمثلة
    • حدد القيود

  2. التكرار والتحسين

    • ابدأ بإيعاز أساسي
    • أضف التفاصيل تدريجيًا
    • حسّن بناءً على النتائج

  3. التعلم من الاستجابات

    • تحليل اقتراحات الذكاء الاصطناعي
    • تحسين أنماط الإيعازات
    • حفظ الإيعازات الفعالة
تلميح

استخدم الأمر /help لاكتشاف المزيد من ميزات وخيارات الإيعازات!

الموارد ذات الصلة​