وضع الوكيل وإكمال Tab

وضع الوكيل وإكمال Tab هما ميزتا الطيار الآلي في Cursor—يتوقعان ما تحتاجه ويفعلانه تلقائياً. أتقن هذه للوصول لأقصى حالة تدفق.

إكمال Tab

إكمال Tab يتنبأ بكودك التالي قبل أن تكتبه.

كيف يعمل

تكتب:                 AI يقترح:
─────────────────────────────────────────
function calc          |culateTotal(items: Item[]): number {
const user =           |await prisma.user.findUnique({ where: { id } })
if (error)             |{ console.error(error); return null; }

اضغط Tab لقبول الاقتراح.

الإعداد

الإعدادات → الميزات → إكمال Tab:
├── تمكين: مفعّل
├── التشغيل: عند الضغط على مفتاح
├── عرض مضمن: مفعّل
├── اقتراحات متعددة الأسطر: مفعّل
└── استخدام السياق: مفعّل

أنماط إكمال Tab

1. إكمال أجسام الدوال

// اكتب هذا:
function validateEmail(email: string): boolean {

// Tab يقترح:
function validateEmail(email: string): boolean {
  const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
  return emailRegex.test(email);
}

2. إكمال الاستيرادات

// اكتب:
import { useState

// Tab يقترح:
import { useState, useEffect } from 'react';

وضع الوكيل

وضع الوكيل يتيح لـ Cursor العمل بشكل مستقل على المهام المعقدة.

تمكين وضع الوكيل

في Composer (⌘I)، ابحث عن تبديل Agent أو اكتب:

/agent أنشئ صفحة إعدادات مستخدم كاملة مع التحقق من النموذج

ما يمكن للوكيل فعله

قدرات الوكيل:
├── قراءة وتحليل ملفات متعددة
├── إنشاء ملفات ومجلدات جديدة
├── تشغيل أوامر الطرفية (بإذن)
├── تثبيت التبعيات
├── تشغيل الاختبارات للتحقق من التغييرات
├── التصحيح الذاتي بناءً على الأخطاء
└── التكرار حتى اكتمال المهمة

سير عمل الوكيل

┌─────────────────────────────────────────────────────────────┐
│                    تدفق وضع الوكيل                          │
└─────────────────────────────────────────────────────────────┘
         │
         ▼
┌─────────────────┐
│  تحليل المهمة  │ ← يفهم ما تحتاجه
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  تخطيط التغييرات│ ← يُنشئ خطة خطوة بخطوة
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│ تنفيذ التغييرات│ ← يُنشئ/يعدّل الملفات
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  تشغيل الأوامر │ ← npm install، اختبارات، إلخ (يطلب إذن)
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│ التحقق من النتائج│ ← يتحقق من الأخطاء
└────────┬────────┘
         │
    ┌────┴────┐
    │ أخطاء؟  │
    └────┬────┘
   نعم   │  لا
    ▼    │  ▼
┌───────┐│┌────────┐
│ إصلاح │││  تم!   │
└───┬───┘│└────────┘
    │    │
    └────┘ (يتكرر حتى النجاح)

مطالبات الوكيل الفعالة

مهمة: إضافة المصادقة

/agent أضف مصادقة Google OAuth:
- استخدم NextAuth.js v5
- أضف زر تسجيل دخول للهيدر
- احمِ مسارات /dashboard
- خزّن جلسات المستخدم في قاعدة البيانات
- أضف قائمة منسدلة لملف المستخدم عند تسجيل الدخول

حواجز الوكيل

الوكيل يطلب إذناً قبل:

• تشغيل أوامر الطرفية
• تثبيت الحزم
• حذف الملفات
• إجراء تغييرات قد تكون مدمرة

متى تستخدم الوكيل vs Composer

استخدم الوكيل عندما...	استخدم Composer عندما...
المهمة تتطلب تشغيل أوامر	مجرد تحرير كود
خطوات متعددة مع تبعيات	التغييرات مستقلة
تحتاج التحقق بالاختبارات	ستختبر يدوياً
تثبيت حزم	العمل ضمن التبعيات الحالية

دمج الميزات

سير العمل القوي

1. إكمال Tab للتحريرات السريعة
   └── كتابة دوال فردية
   └── إكمال الأنماط التي تعرفها

2. التحرير المضمن (⌘K) للتغييرات المركزة
   └── تعديل الكود المحدد
   └── إعادة هيكلة سريعة

3. Composer (⌘I) للتحريرات متعددة الملفات
   └── تغييرات مرتبطة عبر الملفات
   └── إضافة ميزات جديدة

4. الوكيل للعمل المستقل
   └── ميزات كاملة
   └── مهام تتطلب أوامر shell

رؤية حالة التدفق: الهدف ألا تقطع تدفقك أبداً. Tab للإكمالات الصغيرة، ⌘K للإصلاحات السريعة، Composer للتغييرات المخططة، الوكيل لمهام "افعلها فقط". انتقل بسلاسة بين الأربعة.

الآن لديك فهم كامل لـ Cursor. في الوحدة 3، سنستكشف Claude Code لسير العمل الأصلي في الطرفية. :::