Cursor CLI ثلاثة أوضاع: Agent / Plan / Ask

2 min read

ثلاثة أوضاع، جملة واحدة للتمييز بينها: من يمكنه لمس كودك، ومن يكتفي بالحديث. بمجرد استيعاب ذلك، اختيار الوضع المناسب يصبح سهلاً.

مقارنة في جملة

الوضع جملة واحدة هل يعدّل ملفاتك؟
Agent "افعل" شيئاً لي ✅ نعم
Plan "خطّط" أولاً كيف ستفعل، ثم أقرّر أنا ليس بعد — فقط بعد موافقتك
Ask فقط "اسأل" سؤالاً أو ابحث عن شيء ❌ لا

تخيلهم ثلاثة زملاء: Agent من يقول "أعطني، أنا أنفّذ"؛ Plan من يقول "دعني أكتب اقتراحاً لتراجعَه أولاً"؛ Ask من يقول "أجاوب فقط، لا ألمس الملفات" — اختر الشخص المناسب ووفر على نفسك نصف المتاعب.

وضع Agent (الافتراضي)

حالة الاستخدام: أن يعدّل الذكاء الاصطناعي الكود مباشرة أو يضيف ميزات أو يعيد الهيكلة. تريد النتائج، لا النقاش.

cursor agent "Change login to use JWT"
  • يقرأ الملفات، يعدّلها، وقد يشغّل أوامر
  • يمكنك قبول أو رفض كل خطوة — أنت المسيطر

وضع Plan

حالة الاستخدام: غير متأكد كيف تتعامل مع شيء، أو قلق من أن يغيّر الذكاء الاصطناعي الكثير دفعة واحدة؟ اعرض الخطة قبل الإذن.

cursor agent --plan "Refactor the entire API layer"
  • يطرح الذكاء الاصطناعي بعض الأسئلة ويقترح نهجاً
  • ينفّذ فقط بعد موافقتك — دون مفاجآت

متى تستخدمه: للتغييرات الكبيرة، أو عندما تريد "أن ترى الأمر بوضوح قبل الالتزام."

وضع Ask (قراءة فقط)

حالة الاستخدام: تريد فقط أن تسأل "ماذا يفعل هذا الكود" أو "هل هناك طريقة أفضل لكتابة هذا" — ولا تريد أبداً تغيير أي ملفات.

cursor ask "What is the logic in src/auth.ts?"
  • يقرأ ويحلل ويجيب فقط — لا يكتب أبداً
  • مفيد لـ CI أو بيئات تريد فيها الفحص فقط دون التعديل

التبديل بين الأوضاع أثناء المحادثة

أنت بالفعل داخل محادثة cursor agent؟ استخدم أوامر الشرطة للتبديل فوراً:

  • /plan → التبديل لوضع Plan (خطة أولاً، تنفيذ لاحقاً)
  • /ask → التبديل لوضع Ask (قراءة فقط، اسأل بحرية)

لا حاجة للخروج وإعادة التشغيل — كالتبديل بين السرعات أثناء السير.

ملخص

  • Agent: ينفّذ ويعدّل الملفات — استخدمه عندما تريد النتائج
  • Plan: يخطّط أولاً، ينفّذ فقط بعد موافقتك — استخدمه عندما تريد الأمان
  • Ask: أسئلة فقط، قراءة فقط — استخدمه عندما تريد إجابات دون تغييرات

التالي: 04-non-interactive — الوضع غير التفاعلي للسكربتات وCI، تشغيل الذكاء الاصطناعي دون مراقبة