مؤثرترین تغییری که میشود در کار با Agent در Cursor داد، برنامهریزی پیش از کدنویسی است؛ و عادت دوم، چت تازه برای کار تازه. این حرف مستقیم از وبلاگ رسمی Cursor آمده است.
ما در ۲۶ آبان ۱۴۰۵ مستندات رسمی و وبلاگ بهترین روشهای Agent را خواندیم. نام حالتها و دکمهها ممکن است در نسخهٔ تو کمی فرق کند.
Plan Mode
Plan Mode پیش از نوشتن کد، برنامهٔ اجرایی دقیق میسازد. با Shift+Tab در ورودی چت فعال میشود؛ Cursor هم گاهی خودش وقتی کار پیچیدهای مینویسی آن را پیشنهاد میکند.
مستندات برای این موقعیتها توصیه میکند:
- قابلیتی که چند رویکرد معتبر دارد.
- کاری که چند فایل یا سیستم را درگیر میکند.
- نیازمندی نامعلوم.
- تصمیم معماری.
برای کار سریع و آشنا لازم نیست؛ مستندات صریح میگوید «همهٔ کارها برنامهٔ دقیق لازم ندارند». برنامهها مارکداون قابلویرایشاند و پیشفرض در پوشهٔ خانگی ذخیره میشوند؛ با «Save to workspace» به .cursor/plans/ میروند.
اگر Agent چیز غلط ساخت
بهجای اصلاحهای پشتسرهم: تغییرات را برگردان، برنامه را اصلاح کن و دوباره اجرا کن. وبلاگ رسمی همین را توصیه میکند.
چت تازه، کِی؟
وبلاگ دو فهرست دارد:
چت تازه بساز وقتی: به کار یا قابلیت دیگری میروی، Agent گیج شده یا اشتباه تکرار میکند، یا یک واحد منطقی کار تمام شده.
ادامه بده وقتی: روی همان قابلیت تکرار میکنی، Agent به زمینهٔ قبلی نیاز دارد یا چیزی را که همین الان ساخته دیباگ میکنی.
دلیلش: گفتگوهای طولانی میتوانند تمرکز Agent را کم کنند. برای مراجعه به گفتگوی قبلی، بهجای کپیپیست از @Chats استفاده کن.
زمینه را پر نکن
لازم نیست هر فایل را @ کنی؛ Agent با جستجو (grep و جستجوی معنایی) خودش پیدا میکند. اگر فایل دقیق را میدانی، تگ کن؛ فایل نامربوط ممکن است گیجش کند. @Branch برای «تغییرات این شاخه را بازبینی کن» مفید است.
بازبینی بعد از کار
- حین تولید، diff را ببین و در صورت لزوم Stop بزن.
- بعد از اتمام: Review → Find Issues یا Agent Review در Source Control.
- Bugbot روی pull requestها بعد از push بازبینی خودکار میکند.
وبلاگ هشدار میدهد کد تولیدشده میتواند درست به نظر برسد ولی ظریفاً غلط باشد؛ diff را بخوان. اهداف قابلسنجش بده: انواع، لینتر و تست. روش TDD هم پیشنهاد شده: تست بنویس، شکستش را ببین، commit کن، بدون تغییر تست پیادهسازی کن.
Debug Mode
برای باگهای قابلبازتولید که حل نمیشوند، شرایط رقابتی، مشکل عملکرد و نشت حافظه: فرضیه میسازد، کد را با لاگ ابزاربندی میکند، میخواهد باگ را بازتولید کنی، داده را تحلیل میکند و بعد اصلاح هدفمند انجام میدهد.
Agentهای موازی و ابری
Cursor برای Agentهای موازی worktree گیت میسازد و با «Apply» نتیجه برمیگردد؛ میتوانی یک دستور را روی چند مدل بزنی. Agent ابری روی sandbox راه دور شاخه میسازد، کار میکند، pull request باز میکند و خبر میدهد. وبلاگ آن را برای کارهای فرعی مثل باگهای کوچک، بازآرایی تغییرات اخیر، تولید تست و بهروزرسانی مستندات پیشنهاد میکند. ما این بخش را خودمان امتحان نکردهایم.
ادامه
قاعدههای ثابت را در قواعد Cursor بنویس. برای مقایسه با روش Claude Code: مدیریت زمینه. و برای فهرست بازبینی، سنجیدن خروجی هوش مصنوعی.
سوالات متداول
راهنمای اصلی این بخش
کار مؤثر با ابزارهای هوش مصنوعی: پنج اصل مشترکتحریریهٔ سرنخ
تیم نویسندگان و آزمایشگران
ما چند نفریم که هر روز با ابزارهای هوش مصنوعی و اتوماسیون کار میکنیم. هر راهنمایی که اینجا میبینید اول روی کارِ خودمان امتحان شده و بعد نوشته شده است.