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

إنشاء واستخدام الأوضاع المخصصة في Cursor

Cursor Custom Modes

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

ما هي الأوضاع المخصصة؟​

الأوضاع المخصصة هي:

  • أدوار وكيل متخصصة مصممة لمهام محددة
  • خاصة بمكدس تقني مصممة للأطر واللغات
  • قيود أسلوب تفرض معايير الترميز
  • تكوينات قابلة لإعادة الاستخدام لحفظها ومشاركتها عبر المشاريع

الأوضاع المدمجة​

يأتي Cursor مع عدة أوضاع مدمجة:

الوضعالاستخدامحالات الاستخدام
Generalالترميز العامالمهام اليومية
Agentالتنفيذ المستقلالمهام المعقدة متعددة الملفات
Askالأسئلة والأجوبةالشروحات، التعلم
Reviewمراجعة الكودفحوصات الجودة

إنشاء وضع مخصص​

الخطوة 1: تحديد الغرض من الوضع​

حدد ما سيفعله وضعك:

اسم الوضع: خبير اختبار الواجهة الأمامية
الغرض: كتابة اختبارات شاملة لمكونات React
المكدس التقني: React، Jest، React Testing Library
المخرجات: ملفات الاختبار وتقارير التغطية

الخطوة 2: فتح محرر الوضع​

  1. انتقل إلى الإعدادات > إعدادات الوكيل > الأوضاع
  2. انقر على + إنشاء وضع جديد
  3. أو اضغط على Cmd/Ctrl + Shift + M

الخطوة 3: تكوين الوضع​

المعلومات الأساسية​

الاسم: خبير اختبار الواجهة الأمامية
الوصف: كتابة اختبارات شاملة لمكونات React
الأيقونة: 🧪 (اختياري)
الاختصار: Cmd+Shift+T (اختياري)

موجه النظام​

هذه هي الشخصية التوجيهية للوضع:

أنت خبير ضمان جودة متخصص في اختبار الواجهة الأمامية.

## مسؤولياتك
- كتابة اختبارات شاملة لمكونات React
- تنفيذ اختبارات الوحدة والتكامل
- استخدام React Testing Library و Jest
- اتباع مبادئ التطوير الموجه بالاختبار (TDD)

## تنسيق المخرجات
1. تعليقات تصف الغرض من الاختبار
2. اختبارات تغطي العرض، والتفاعلات، وحالات الحد
3. اختبارات لقطة للتأكد من اتساق واجهة المستخدم
4. اختبارات إمكانية الوصول للامتثال لمعايير a11y
5. تقرير التغطية بعد اكتمال الاختبارات

## معايير الترميز
- استخدام كتل `describe`/`it` لجميع الاختبارات
- اتباع نمط AAA (الترتيب-الفعل-التأكيد)
- استخدام كائن `screen` لجميع التفاعلات
- إعطاء الأولوية لـ `data-testid` كمحدد
- استخدام الثوابت لجميع معرّفات الاختبار

## متطلبات التغطية
- الفروع: >80%
- الوظائف: >90%
- الأسطر: >85%
- البيانات: >85%

ملف القواعد (اختياري)​

أنشئ .cursor/rules/testing-expert.mdc:

---
description: 'قواعد خبير اختبار الواجهة الأمامية'
globs: ['**/*.test.{ts,tsx}']
alwaysApply: true
---

## معايير الاختبار

### يجب على كل مكون اختبار
1. العرض باستخدام خصائص مختلفة
2. تفاعلات المستخدم (النقر، الإدخال، الإرسال)
3. حالات الحد (الحالات الفارغة، التحميل، الأخطاء)
4. سمات إمكانية الوصول
5. تنفيذ وظائف رد الاتصال

### هيكل الاختبار
```typescript
describe('ComponentName', () => {
  describe('العرض', () => {
    it('يجب أن يعرض بالخصائص الافتراضية', () => {});
    it('يجب أن يعرض بالخصائص المخصصة', () => {});
  });

  describe('التفاعلات', () => {
    it('يجب أن يتعامل مع حدث النقر عند النقر', () => {});
    it('يجب أن يحدث القيمة عند الإدخال', () => {});
  });

  describe('حالات الحد', () => {
    it('يجب أن يتعامل مع البيانات الفارغة', () => {});
    it('يجب أن يعرض حالة التحميل', () => {});
    it('يجب أن يعرض حالة الخطأ', () => {});
  });
});

حدود التغطية​

  • الفروع: >80%
  • الوظائف: >90%
  • الأسطر: >85%

### الخطوة 4: اختبار الوضع

اختبر وضعك قبل تبنيه:

[خبير اختبار الواجهة الأمامية] اكتب اختبارات لمكون UserProfile.

مسار المكون: src/components/UserProfile.tsx


### الخطوة 5: حفظ وتفعيل

1. انقر على **حفظ الوضع**
2. حدده في محدد الوضع
3. ابدأ المحادثة

## التخصيص المتقدم

### الأوضاع المستندة إلى الإطار

#### وضع خبير React

```markdown
## وضع خبير React

### المكدس التقني
- React 18+ مع الخطافات
- TypeScript
- Tailwind CSS
- React Query لجلب البيانات

### معايير الترميز
1. استخدام مكونات الدالة لجميع المكونات
2. استخدام واجهات TypeScript لتعريف الخصائص
3. تنفيذ React.memo للتحسين
4. استخدام useEffect لجميع التأثيرات الجانبية
5. استخدام خطافات مخصصة للمنطق

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

src/ components/ ComponentName/ index.tsx ComponentName.tsx ComponentName.test.tsx types.ts hooks/ useComponentName.ts


### تنسيق المخرجات
1. ملف المكون المكتوب
2. اختبارات الوحدة
3. قصص Storybook (إن وجدت)
4. تعليقات التوثيق

وضع تطوير API​

## وضع تطوير API

### المكدس التقني
- Node.js + Express
- TypeScript
- Prisma ORM
- التحقق من صحة Zod

### معايير الترميز
1. استخدام مخططات Zod للتحقق من صحة الطلبات
2. تنفيذ معالجة الأخطاء المناسبة لجميع نقاط النهاية
3. استخدام تنسيق متسق لجميع استجابات API
4. تنفيذ الحد من المعدل
5. إضافة توثيق swagger لجميع نقاط النهاية

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

src/ routes/ entity/ index.ts entity.controller.ts entity.service.ts entity.validator.ts entity.types.ts


### تنسيق المخرجات
1. وحدة تحكم مع التحقق
2. طبقة الخدمة مع منطق الأعمال
3. ملف الفهرس لتعريفات المسارات
4. نمط المستودع للوصول إلى قاعدة البيانات

الأوضاع مع الأدوات​

وضع ترحيل قاعدة البيانات​

## خبير ترحيل قاعدة البيانات

### الأدوات
- Prisma Migrate
- Drizzle ORM
- TypeORM

### سير العمل
1. تحليل المخطط الحالي
2. إنشاء ملف الترحيل
3. إنشاء سكربت التراجع
4. التحقق من سلامة البيانات
5. تحديث بيانات البذرة

### تنسيق المخرجات
1. ملف SQL للترحيل
2. سكربت التراجع
3. سجل الترحيل
4. استعلامات التحقق

الأوضاع مع قيود الفحص​

وضع مراجعة الأمان​

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

### التركيز
- OWASP Top 10
- التحقق من صحة الإدخال
- المصادقة/التفويض
- حماية البيانات

### سير العمل
1. فحص الثغرات الشائعة
2. تحديد مخاطر الحقن
3. التحقق من عيوب المصادقة
4. مراجعة تعرض البيانات
5. إنشاء تقرير الأمان

### تنسيق المخرجات
1. قائمة الثغرات مرتبة حسب الخطورة
2. الملفات المتأثرة والمواقع
3. الإصلاحات الموصى بها
4. أمثلة على الكود
5. حالات اختبار الأمان

تبديل الأوضاع​

التبديل اليدوي​

  1. انقر على محدد الوضع في الدردشة
  2. حدد الوضع من القائمة المنسدلة
  3. ابدأ مهمتك

التبديل التلقائي​

استخدم القواعد لتبديل الأوضاع تلقائيًا بناءً على نوع الملف:

---
description: 'التبديل التلقائي للوضع بناءً على السياق'
globs: ['**/*.test.{ts,tsx}']
alwaysApply: true
---

عند العمل في هذا السياق، انتقل إلى وضع **خبير اختبار الواجهة الأمامية**.
اتبع معايير الاختبار ومتطلبات التغطية.

مجموعات سير العمل​

أنشئ سير عمل يجمع بين أوضاع متعددة:

# الخطوة 1: استخدام وضع المهندس المعماري
[المهندس المعماري] صمم نقاط نهاية API لإدارة المستخدمين.

# الخطوة 2: استخدام وضع تطوير API
[تطوير API] نفذ نقاط النهاية المصممة في الخطوة 1.

# الخطوة 3: استخدام وضع الاختبار
[خبير اختبار الواجهة الأمامية] اكتب اختبارات لعميل API.

# الخطوة 4: استخدام وضع المراجعة
[المراجعة] راجع جودة جميع التغييرات.

مشاركة الأوضاع​

تصدير الوضع​

# تصدير تكوين الوضع
cursor mode:export frontend-testing-expert > frontend-testing-expert.json

استيراد الوضع​

# استيراد تكوين الوضع
cursor mode:import frontend-testing-expert.json

المشاركة في الفريق​

  1. احفظ ملفات الوضع في .cursor/modes/
  2. ارتكبها في التحكم بالإصدارات
  3. يقوم أعضاء الفريق بالاستيراد
  4. قم بتوحيدها في جميع المشاريع

مكتبة قوالب الأوضاع​

القالب 1: مراجع الكود​

## خبير مراجعة الكود

### التركيز
- جودة الكود
- الأداء
- قابلية الصيانة
- أفضل الممارسات

### معايير المراجعة
1. الكود يتبع أسلوب المشروع
2. الوظائف صغيرة ومركزة بما يكفي
3. تسمية المتغيرات واضحة
4. معالجة الأخطاء مناسبة
5. لا يوجد تكرار في الكود
6. الأداء محسّن

### تنسيق المخرجات
1. النتيجة الإجمالية للجودة
2. المشكلات المحددة مع أرقام الأسطر
3. اقتراحات التحسين
4. أمثلة على إعادة البناء
5. ملاحظات إيجابية

القالب 2: كاتب الوثائق​

## كاتب الوثائق التقنية

### التركيز
- وثائق API
- ملفات README
- تعليقات الكود
- أدلة الاستخدام

### المعايير
1. جميع واجهات برمجة التطبيقات العامة موثقة
2. يحتوي README على تعليمات الإعداد
3. الكود يحتوي على تعليقات مضمنة
4. يتم توفير أمثلة
5. يتم الاحتفاظ بسجل التغييرات

### تنسيق المخرجات
1. مستندات Markdown مع أمثلة
2. تعليقات JSDoc/TypeDoc
3. أقسام README
4. إدخالات سجل التغييرات
5. أدلة الاستخدام

القالب 3: محسّن الأداء​

## خبير تحسين الأداء

### التركيز
- أداء وقت التشغيل
- استخدام الذاكرة
- تحسين البناء
- كفاءة الشبكة

### التحليل
1. تحديد الاختناقات
2. تحليل استخدام الذاكرة
3. مراجعة مخرجات البناء
4. التحقق من طلبات الشبكة
5. قياس أوقات التحميل

### التحسينات
1. تقسيم الكود
2. التحميل الكسول
3. استراتيجيات التخزين المؤقت
4. ضغ الموارد
5. تحسين الاستعلامات

### تنسيق المخرجات
1. خط الأساس للأداء
2. تحليل الاختناقات
3. اقتراحات التحسين
4. خطة التنفيذ
5. نتائج القياس

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

تصميم الوضع​

  1. محدد: ركز على هدف واحد
  2. مقيد: حدد حدودًا واضحة
  3. قابل للاختبار: أضف معايير التحقق
  4. موثق: اشرح عملية اتخاذ القرار

هندسة الموجهات​

## هيكل موجه الوضع الفعال

### تعريف الدور
- من أنت
- خبرتك
- قيودك

### سير العمل
- الخطوات التي تتبعها
- نقاط القرار
- معايير الجودة

### تنسيق المخرجات
- هيكل الاستجابة
- ما هو مضمن
- الاتفاقيات المستخدمة

### القيود
- ما يجب عليك فعله
- ما يجب ألا تفعله أبدًا
- معايير الجودة

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