Cursor والوكيل الذكي — من الصفر إلى الاحتراف

1. ما هو Cursor؟ ولماذا يختلف عن الشات؟

الهدف: تميّز بين مساعد دردشة عادي ووكيل يعمل داخل مشروعك الحقيقي.

Cursor بيئة تطوير مبنية حول وكيل ذكاء اصطناعي يقرأ ملفات مشروعك، يعدّل الكود، يشغّل أوامر، ويراجع النتائج — لا يكتفي بإجابة نصية عامة.

الشات العام يجيب من ذاكرته. الوكيل في Cursor يعمل على سياقك: الملفات المفتوحة، المستودع، القواعد، والأدوات المتصلة.

الفكرة الجوهرية: أنت المدير التقني؛ الوكيل منفّذ ذكي يحتاج توجيهاً واضحاً ومراجعة.

• الوكيل يرى المشروع وليس سؤالك فقط
• يمكنه التعديل والتشغيل وليس الاقتراح فقط
• جودة النتيجة = جودة السياق + الأمر + المراجعة

2. أوضاع العمل: Agent و Ask و Plan و Debug

الهدف: تختار الوضع المناسب لكل مهمة بدل خلط التخطيط بالتنفيذ الأعمى.

Agent: ينفّذ — يعدّل ملفات، يشغّل أوامر، يتابع حتى ينجز المهمة.
Ask: يسأل ويجيب دون تعديل (ممتاز للفهم والاستكشاف).
Plan: يصمّم نهجاً قبل الكتابة — مفيد للمهام الكبيرة أو الغامضة.
Debug: يركّز على تشخيص الأعطال بأدلة تشغيل.

قاعدة ذهبية: إن لم تفهم المطلوب بعد، ابدأ بـ Ask أو Plan. إن كان المطلوب واضحاً وصغيراً، Agent مباشرة.

• Plan قبل المشاريع الكبيرة
• Ask لاستكشاف كود لا تعرفه
• Agent للتنفيذ المحدود الواضح
• Debug عند فشل متكرر بأعراض محددة

3. السياق هو كل شيء: ملفات، تحديد، ومستودع

الهدف: تطعم الوكيل بالمعلومات الصحيحة بدل أن يخمّن.

الوكيل الجيد يعمل بسياق غني ومنتقى:
• ملف مفتوح أو تحديد (Selection) لما تريد تغييره
• إشارة لملفات بـ @ (مسارات، مستندات، قواعد)
• وصف للهدف التجاري لا التقني فقط عند الحاجة

خطأ شائع: أمر عام مثل «حسّن الموقع» بلا ملفات ولا معايير. النتيجة تكون عامة أو خاطئة.

صح: «في contact/index.php أضف حقل طريقة الدفع كما في domains.php، بلا تغيير للهيدر».

• @file لتوجيه الانتباه
• حدّد الملف والأسطر عند الإمكان
• اذكر ما يجب عدم لمسه
• أقل سياق عشوائي = أقل هلوسة

4. هندسة الأوامر: كيف تستخلص نتائج أدق

الهدف: تكتب أوامر قابلة للتنفيذ والقياس والمراجعة.

صيغة الأمر القوي (Mesue Prompt):
1) الدور/السياق: ماذا نبني ولمن؟
2) المهمة: فعل واحد واضح
3) القيود: لا تكسر كذا، لا تضف كذا
4) معيار النجاح: كيف أعرف أنك انتهيت؟
5) أسلوب التسليم: ملفات، ملخص، خطوات اختبار

كلّما كان معيار النجاح قابلاً للتحقق («الصفحة ترجع 200»، «الزر يظهر على الموبايل»)، قلّت الإجابات الفضفاضة وزادت الموهبة العملية للنتيجة.

• مهمة واحدة لكل رسالة قدر الإمكان
• قيود صريحة أفضل من أمل ضمني
• اطلب خطة قصيرة قبل التنفيذ إن كبرت المهمة
• اطلب اختباراً يدوياً في النهاية

5. القواعد Rules: ذاكرة دائمة لأسلوب عملك

الهدف: تعلّم الوكيل عادات مشروعك مرة واحدة بدل تكرارها كل محادثة.

User Rules و Project Rules تُخبر الوكيل كيف يتصرف دائماً: لغة الرد، أسلوب الـ commit، عدم لمس الأسرار، تفضيلات التصميم، بروتوكول Git.

ضع القواعد القصيرة والحازمة فقط. القواعد الطويلة المتناقضة تُضعف الالتزام.

مثال قاعدة جيدة: «لا تعدّل ملفات .env. اكتب واجهات عربية RTL. لا تستخدم Inter كخط افتراضي».

مثال سيء: «كن رائعاً ومبدعاً دائماً» بلا تفاصيل قابلة للتنفيذ.

• قواعد قصيرة وقابلة للتنفيذ
• افصل قواعد المستخدم عن قواعد المشروع
• حدّث القواعد بعد أخطاء متكررة
• لا تضع أسراراً داخل القواعد

6. Skills وملفات التوجيه: قدرات متخصصة

الهدف: تعرف متى يستخدم الوكيل مهارة جاهزة بدل الارتجال.

Skills ملفات تعليمات يقرأها الوكيل لمهام متخصصة (مراجعة أمن، إنشاء قواعد، Canvas، SDK…).

AGENTS.md أو قواعد المجلدات توجّه السلوك في أجزاء معينة من المستودع.

احترافك يظهر عندما تبني مهارات داخلية لفريقك: «كيف ننشر على VPS»، «كيف نكتب درس Learn»، «كيف نفحص النطاقات».

لا تكرّر نفس الشرح في كل محادثة — حوّله لمهارة أو قاعدة.

• المهارة = إجراء متكرر موثّق
• اجعل المهارة محددة الملف/الأوامر
• راجع المهارة بعد كل فشل

7. الأدوات: الطرفية، المتصفح، وMCP

الهدف: تفهم أن قوة الوكيل تأتي من الأدوات لا من النص وحده.

الوكيل قد يقرأ ملفات، يبحث في الكود، يشغّل أوامر Shell، يفتح المتصفح، ويتصل بخدمات عبر MCP (قواعد بيانات، إدارة مشروع، أنظمة داخلية).

احتراف الاستعمال:
• اسمح بما هو آمن فقط
• راقب الأوامر قبل الموافقة على الخطرة
• اطلب منه تلخيص ما نفّذه ولماذا

حدود: أداة خاطئة أو صلاحية ناقصة = نتيجة ناقصة. المشكلة ليست دائماً «ذكاء النموذج».

• Shell للمهام الحقيقية على السيرفر/المحلي
• MCP يوسّع القدرات خارج المحرر
• الموافقة البشرية جزء من الأمان

8. حدود الوكيل: الهلوسة، الثقة، ومتى تتوقف

الهدف: تضع سقفاً واقعياً لما يمكن للذكاء الاصطناعي إنجازه بأمان.

الوكيل قد:
• يخترع مسارات ملفات أو واجهات API
• يبالغ في اكتمال المهمة
• يكسر سلوكاً جانبياً أثناء إصلاح شيء آخر

علامات خطر: ثقة عالية بلا دليل، تعديلات واسعة بلا طلب، تجاهل قيودك.

بروتوكول الأمان Mesue:
1) اطلب فرقاً أو ملخص ملفات متغيرة
2) اختبر يدوياً المسار الحرج
3) لا تدمج/تنشر قبل المراجعة
4) للمسائل الأمنية والدفع: مراجعة بشرية إلزامية

• لا تثق بلا تحقق
• المهام الأمنية والمالية = حذر مضاعف
• التراجع Git صديقك
• الصمت عن الشك خطأ

9. ورشة عمل يومية محترفة مع الوكيل

الهدف: تبني إيقاعاً يومياً يرفع مستواك دون فوضى.

إيقاع مقترح:
صباحاً: مهمة واحدة واضحة (Bug أو درس Learn أو تحسين تحويل)
ظهراً: مراجعة ما أنجزه الوكيل + اختبار
مساءً: توثيق قاعدة/مهارة قصيرة لما تكرر

قسّم العمل إلى شرائح قابلة للدمج خلال ساعة. تجنّب «أعد بناء المنصة اليوم».

للمحتوى التعليمي: اطلب هيكل الدرس أولاً، ثم اكتب درساً واحداً، ثم تفاعل، ثم انشر.

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

10. مراجعة الجودة: كيف ترفع «موهبة» النتائج

الهدف: تحوّل مخرجات متوسطة إلى احترافية عبر حلقات نقد قصيرة.

بعد كل تنفيذ اطلب:
• ما الذي تغيّر؟
• ما المخاطر؟
• ماذا لم يُختبر؟
ثم أعطِ نقداً محدداً: «النص العربي ضعيف في الزر»، «كسرت الموبايل»، «أضفت بطاقة في الـ Hero خلافاً للقواعد».

الوكيل يتعلم داخل المحادثة من نقدك. النقد العام («ليس جيداً») لا يعلّمه شيئاً.

مستوى متقدم: اطلب منه أن ينتقد حلّه نفسه قبل أن تقبل.

• نقد محدد بموقع العيب
• اطلب self-review
• ارفض الزخرفة بلا قيمة

11. من الفكرة إلى النشر مع الوكيل

الهدف: تربط التخطيط والتنفيذ والنشر في سلسلة واحدة منضبطة.

سلسلة احترافية:
1) Idea → معايير نجاح
2) Plan مختصر
3) تنفيذ شريحة
4) اختبار محلي/سيرفر
5) نشر محدود
6) مراقبة سريعة (HTTP، نموذج، سجل)

على MesueTech مثال حي: مسار تعلّم جديد = بيانات الدروس + صفحة PHP + CSS + رفع + تحقق curl.

لا تجعل الوكيل ينشر للإنتاج ويحذف بيانات بلا أوامر صريحة منك.

• النشر قرار بشري
• تحقق بعد الرفع
• سجل ما نُشر

12. مستوى الاحتراف: قائمة إتقان Cursor

الهدف: تقيّم نفسك وتحدد فجواتك للوصول لأعلى مستوى تقني في استعمال الوكيل.

أنت في مستوى احترافي عندما تستطيع:
• صياغة أوامر بمعيار نجاح واضح
• اختيار الوضع الصحيح
• تغذية سياق دقيق
• إدارة قواعد ومهارات
• مراجعة نقدية بلا انبهار
• منع الوكيل من تجاوز الحدود
• إنتاج قيمة أعمال (ميزة، درس، إصلاح) بشكل متكرر أسبوعياً

الخطوة التالية بعد هذا المسار: ابنِ منتجاً صغيراً بالكامل بمساعدة الوكيل خلال أسبوع، مع توثيق أوامرك وأخطائك.

• الإتقان = عادة لا شهادة
• القياس بالأعمال المنجزة
• علّم غيرك ليترسخ فهمك