کار حرفه‌ای با ابزارها

Cursor: برنامه قبل از کد، چت تازه برای کار تازه

تستحریریهٔ سرنخ۲۴ آبان ۱۴۰۵۳ دقیقه مطالعه

این نوشته مستقل است و به هیچ برندی وابسته نیست. اگر ابزاری را معرفی کنیم، دلیلش را هم می‌نویسیم. رویهٔ نوشتن · روش بررسی ابزارها

مؤثرترین تغییری که می‌شود در کار با 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: مدیریت زمینه. و برای فهرست بازبینی، سنجیدن خروجی هوش مصنوعی.

سوالات متداول

اشتراک‌گذاری:تلگرامواتس‌اپایکس
تس

تحریریهٔ سرنخ

تیم نویسندگان و آزمایشگران

ما چند نفریم که هر روز با ابزارهای هوش مصنوعی و اتوماسیون کار می‌کنیم. هر راهنمایی که اینجا می‌بینید اول روی کارِ خودمان امتحان شده و بعد نوشته شده است.

کار حرفه‌ای با ابزارهاراهنمای اصلی

کار مؤثر با ابزارهای هوش مصنوعی: پنج اصل مشترک

پنج اصل مشترک برای کار با Claude، Codex، Cursor، Copilot، NotebookLM و Perplexity: زمینه، برنامه، سنجش، زمینهٔ تمیز و مرز دسترسی. به‌همراه فهرست راهنماها.

۲۶ آبان ۱۴۰۵۳ دقیقه مطالعه