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

استخدام وضع YOLO في Cursor للتكرار السريع

Cursor YOLO Mode

يقوم وضع YOLO (You Only Live Once) في Cursor بقبول جميع الاختلافات والتغييرات التي تم إنشاؤها بواسطة الذكاء الاصطناعي تلقائيًا دون الحاجة إلى موافقة يدوية لكل منها. هذا يُسرّع بشكل كبير المهام المتكررة وسير العمل الموثوق، ولكنه يأتي مع مخاطر. يغطي هذا الدليل كيفية استخدام وضع YOLO بأمان وفعالية.

ما هو وضع YOLO؟​

يُمكّن وضع YOLO:

  • القبول التلقائي للاختلافات - يتم تطبيق تغييرات الذكاء الاصطناعي على الفور
  • تكرار أسرع - لا حاجة للنقر على "قبول" لكل تغيير
  • العمليات المجمعة - تطبيق تغييرات متعددة بشكل متسلسل
  • احتكاك مخفض - البقاء في حالة التدفق لفترة أطول

متى تستخدم وضع YOLO​

حالات الاستخدام الجيدة​

السيناريوسبب عمل YOLO
إضافة تعليقات JSDocمنخفض المخاطر، قابل للتنبؤ
إعادة تسمية المتغيراتسهل التحقق منه عبر البحث
تنسيق الكودآمن، قابل للتراجع
إضافة الأنواعالمترجم يلتقط الأخطاء
إعادة هيكلة الاستيراداتIDE يسلط الضوء على المشكلات
كتابة الاختباراتعداد الاختبارات يتحقق
تحديث ملفات التكوينعادة ما تكون بسيطة

تجنب YOLO من أجل​

السيناريومستوى المخاطرة
تغييرات المصادقةحرج
ترحيلات قاعدة البياناتحرج
معالجة المدفوعاتحرج
تغييرات عقد واجهة برمجة التطبيقاتمرتفع
تغييرات معمارية كبيرةمرتفع
النشر في الإنتاجحرج
حذف الملفاتمرتفع

تمكين وضع YOLO​

الطريقة 1: الإعدادات​

{
  "cursor.yoloMode": true,
  "cursor.autoAcceptDiffs": true,
  "cursor.autoApplyChanges": true
}

الطريقة 2: لوحة الأوامر​

  1. اضغط Cmd/Ctrl + Shift + P
  2. اكتب "YOLO Mode"
  3. حدد تبديل وضع YOLO

الطريقة 3: أمر الدردشة​

/yolo

أو:

تمكين وضع YOLO لهذه الجلسة

الطريقة 4: اختصار لوحة المفاتيح​

// keybindings.json
{
  "key": "cmd+shift+y",
  "command": "cursor.toggleYoloMode"
}

تكوين وضع YOLO​

إعدادات YOLO الآمنة​

{
  "cursor.yoloMode": true,
  "cursor.autoAcceptDiffs": true,
  
  // حدود الأمان
  "cursor.yolo.maxFilesPerSession": 20,
  "cursor.yolo.maxLinesChanged": 500,
  "cursor.yolo.requireTestsPass": true,
  "cursor.yolo.excludePatterns": [
    "src/auth/**",
    "src/payment/**",
    "src/database/migrations/**",
    "**/*.env*",
    "config/production/**"
  ],
  
  // إعدادات الحفظ التلقائي
  "cursor.yolo.autoSaveBeforeApply": true,
  "cursor.yolo.createGitCheckpoint": true
}

YOLO لكل مشروع​

أنشئ .cursor/yolo-config.json:

{
  "enabled": true,
  "safePatterns": [
    "src/components/**/*.tsx",
    "src/hooks/**/*.ts",
    "src/utils/**/*.ts",
    "tests/**/*.ts"
  ],
  "unsafePatterns": [
    "src/auth/**",
    "src/api/**",
    "src/database/**"
  ],
  "maxChangesPerFile": 50,
  "requireReviewFor": [
    "*.config.*",
    "*.env*",
    "Dockerfile"
  ]
}

سير عمل YOLO الآمن​

سير العمل 1: سباق الوثائق​

[YOLO ON] أضف تعليقات JSDoc لجميع الدوال في src/utils/
اتبع النمط الموجود من src/utils/helpers.ts

المتوقع: 15-20 ملفًا معدّلاً، تمت إضافة جميع التعليقات التحقق: تحقق عشوائيًا من بعض الملفات

سير العمل 2: ترحيل TypeScript​

[YOLO ON] أضف أنواع TypeScript إلى src/components/
استخدم الواجهات من src/types/
حافظ على السلوك الحالي أثناء التشغيل

المتوقع: تمت إضافة الأنواع، لا تغييرات في المنطق التحقق: شغّل tsc --noEmit

سير العمل 3: إنشاء الاختبارات​

[YOLO ON] اكتب اختبارات وحدة لـ src/services/user.ts
اتبع النمط الموجود في tests/services/auth.test.ts
غطّ جميع الطرق العامة

المتوقع: تم إنشاء ملف اختبار جديد التحقق: شغّل الاختبارات باستخدام npm test

سير العمل 4: تنظيف الاستيرادات​

[YOLO ON] نظّم الاستيرادات في src/pages/
التجميع: React، المكتبات الخارجية، الداخلية، الأنواع
أزل الاستيرادات غير المستخدمة

المتوقع: استيرادات نظيفة، لا تغييرات وظيفية التحقق: التطبيق لا يزال يبنى

تدابير الأمان​

1. نقاط التحقق Git​

أنشئ دائمًا نقطة تحقق قبل YOLO:

# إنشاء فرع نقطة تحقق YOLO
git checkout -b yolo/task-name

# التزام الحالة الحالية
git add -A && git commit -m "checkpoint: before YOLO session"

2. المراجعة بعد YOLO​

بعد جلسة YOLO:

# راجع جميع التغييرات
git diff

# تحقق من الملفات المتغيرة
git diff --stat

# شغّل الاختبارات
npm test

# إذا كان هناك خطأ ما، ارجع إلى الخلف
git checkout -- .

3. YOLO مع الاختبارات​

اضبط على YOLO فقط إذا نجحت الاختبارات:

{
  "cursor.yolo.requireTestsPass": true,
  "cursor.yolo.testCommand": "npm test",
  "cursor.yolo.stopOnTestFailure": true
}

4. حدود حجم الملف​

{
  "cursor.yolo.maxFileSizeKB": 100,
  "cursor.yolo.maxFilesPerChange": 10,
  "cursor.yolo.maxLinesPerFile": 200
}

أوامر وضع YOLO​

أوامر الدردشة​

الأمرالإجراء
/yolo onتمكين وضع YOLO
/yolo offتعطيل وضع YOLO
/yolo statusالتحقق من حالة YOLO
/yolo safeYOLO فقط للأنماط الآمنة
/yolo fullYOLO كامل (جميع الملفات)

أوامر الجلسة​

[yolo on] أضف معالجة الأخطاء إلى جميع نقاط نهاية واجهة برمجة التطبيقات
[yolo safe] أعد هيكلة خصائص المكون لاستخدام الواجهات
[yolo off] انتظر، دعني أراجع هذا التغيير الأخير أولاً

قياس فعالية YOLO​

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

المقياسبدون YOLOمع YOLO
الوقت لكل مهمة15-30 دقيقة5-10 دقائق
النقرات لكل تغيير3-50
تبديل السياقمرتفعمنخفض
معدل الخطأمنخفضأعلى قليلاً
معدل التراجعمنخفض5-10%

إرشادات YOLO للفريق​

متى يجب على الفريق استخدام YOLO​

  • تحديثات نمط الكود
  • تحسينات الوثائق
  • إضافة الأنواع
  • إعادة هيكلة الأدوات المساعدة الداخلية
  • كتابة الاختبارات

متى يكون YOLO محظورًا​

  • إصلاحات الإنتاج العاجلة
  • التغييرات المتعلقة بالأمان
  • تغييرات مخطط قاعدة البيانات
  • تغييرات إصدار واجهة برمجة التطبيقات
  • تغييرات التكوين

قالب PR لتغييرات YOLO​

## جلسة YOLO

### المهمة
[صف ما فعلته جلسة YOLO]

### الملفات المتغيرة
- [x] تمت مراجعة جميع التغييرات
- [x] الاختبارات ناجحة
- [x] لم يتم تعديل أي ملفات حساسة

### التحقق
- [x] اكتمل الفحص اليدوي العشوائي
- [x] الاختبارات الآلية ناجحة
- [x] لم يتم اكتشاف أي انحدار

### التراجع
```bash
git revert HEAD

## وضع YOLO + ميزات أخرى

### YOLO + وكلاء الخلفية

[Background, YOLO ON] أضف أنواعًا لجميع الملفات في src/models/


### YOLO + الأوضاع المخصصة

```json
{
  "name": "Safe YOLO",
  "systemPrompt": "You are in YOLO mode but with safety constraints. Only modify: .tsx components, .ts utilities, and tests. Never modify: auth, payment, or database files. Always add types, never remove them.",
  "tools": {
    "write": true,
    "edit": true
  }
}

YOLO + وضع الخطة​

[PLAN MODE] خطط لإعادة الهيكلة
[Review plan]
[YOLO ON] نفذ الخطة المعتمدة

المزالق الشائعة لـ YOLO​

المزالقالوقاية
YOLO على الملفات الخاطئةاستخدام excludePatterns
تغييرات كثيرة جدًاتعيين maxFilesPerSession
تغييرات كسرمطالبة الاختبارات بالنجاح
فقدان التتبعإنشاء نقاط تحقق git
مشكلات الأماناستبعاد ملفات auth/payment

قائمة التحقق السريعة لأمان YOLO​

قبل بدء جلسة YOLO:

  • تم إنشاء فرع نقطة تحقق git
  • تمت مراجعة تكوين YOLO
  • تم تأكيد أن المهمة آمنة لـ YOLO
  • تم استبعاد الأدلة الحساسة
  • يمكن تشغيل الاختبارات بعد ذلك
  • خطة التراجع جاهزة

بعد جلسة YOLO:

  • تمت مراجعة الاختلاف باستخدام git diff
  • تم تشغيل الاختبارات
  • تم فحص الملفات الرئيسية
  • تم الالتزام أو التراجع

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