قواعد (Rules) در Cursor دستورهای ثابتی هستند که به Agent داده میشود؛ بهترین توصیهٔ رسمی این است که ساده شروع کنی و فقط وقتی قاعده اضافه کنی که Agent یک اشتباه را مدام تکرار میکند. نوشتن قاعدهٔ زیاد، بیشتر نویز میسازد تا کمک.
از مستندات رسمی Cursor و وبلاگ بهترین روشهای Agent خواندهایم (۲۶ آبان ۱۴۰۵). اگر نام تنظیم یا مسیرها در نسخهٔ تو فرق داشت، همان مستندات را ببین.
چهار نوع
- Project Rules: در
.cursor/rulesذخیره میشوند و با پروژه نگهداری (version-control) میشوند. - User Rules: سراسری، از Customize → Rules.
- Team Rules: از داشبورد، برای طرحهای Team و Enterprise.
- AGENTS.md: فایل متنی ساده در ریشهٔ پروژه، بهعنوان جایگزین سادهتر.
اگر قاعدهها با هم تداخل داشته باشند، ترتیب ارجحیت Team، بعد Project، بعد User است و همهٔ قاعدههای مرتبط ترکیب میشوند.
فایلهای Rule پروژه
باید با پسوند .mdc باشند. مستندات صریح میگوید فایل .md ساده در .cursor/rules چون فرانتمتر ندارد نادیده گرفته میشود. زیرپوشه مجاز است. سه کلید فرانتمتر: description، globs و alwaysApply.
| نوع فعالسازی | چطور کار میکند |
|---|---|
| Always Apply | در هر گفتگو |
| Apply Intelligently | Agent از روی توضیح تصمیم میگیرد |
| Apply to Specific Files | وقتی فایل با الگو بخواند |
| Apply Manually | وقتی با @ صدا زده شود |
برای ساخت قاعده: /create-rule در چت یا Customize → Rules → Add Rule.
کوتاه نگه دار
مستندات میگوید هر قاعده زیر ۵۰۰ خط باشد و قاعدههای بزرگ را به قاعدههای کوچکتر و قابلترکیب بشکن. یک نکتهٔ فنی: اگر در متن قاعده یک فایل را با @ بیاوری، محتوای فایل داخل قاعده نمیآید؛ Agent هرگاه لازم شد آن را با ابزارهایش میخواند. آنچه باید همیشه در زمینه باشد را داخل بدنهٔ قاعده بنویس.
چه چیزی در قاعده بنویسیم و چه چیزی نه
وبلاگ رسمی Cursor توصیه میکند قاعدهها شامل دستورها، الگوها و اشاره به نمونههای مرجع باشند. اجتناب از اینها:
- کپیکردن کل راهنمای سبک (از لینتر استفاده کن).
- مستندسازی همهٔ دستورها.
- حالتهای نادر و استثنایی.
AGENTS.md در Cursor
مستندات میگوید AGENTS.md متن ساده بدون فرانتمتر است و در ریشه و زیرپوشهها پشتیبانی میشود؛ فایلهای تودرتو با فایلهای بالاتر ترکیب میشوند و دستور مشخصتر برتری دارد. اگر چند ابزار استفاده میکنی، این یک فایل مشترک میدهد؛ مقایسهاش در مقایسهٔ ابزارهای کدنویسی هست.
یک چیز مهم: قواعد Tab را عوض نمیکنند
مستندات تصریح میکند قاعدهها روی Cursor Tab و سایر قابلیتهای هوش مصنوعی اثر ندارند.
الگوی ساده
- بدون قاعده شروع کن.
- وقتی Agent دو سه بار همان اشتباه را کرد، یک قاعدهٔ کوتاه بنویس.
- قاعده را در git بگذار تا تیم هم استفاده کند.
- هر چند هفته یک بار فهرست را مرور و کم کن.
ادامه
برنامهریزی و چت تازه در Cursor را بخوان. اگر با Claude Code کار میکنی، CLAUDE.md معادل این است. برای نقشهٔ کلی: کار با ابزارها.
سوالات متداول
راهنمای اصلی این بخش
کار مؤثر با ابزارهای هوش مصنوعی: پنج اصل مشترکتحریریهٔ سرنخ
تیم نویسندگان و آزمایشگران
ما چند نفریم که هر روز با ابزارهای هوش مصنوعی و اتوماسیون کار میکنیم. هر راهنمایی که اینجا میبینید اول روی کارِ خودمان امتحان شده و بعد نوشته شده است.