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

قواعد Cursor: چهار نوع Rule و چطور کوتاهشان نگه داریم

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

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

قواعد (Rules) در Cursor دستورهای ثابتی هستند که به Agent داده می‌شود؛ بهترین توصیهٔ رسمی این است که ساده شروع کنی و فقط وقتی قاعده اضافه کنی که Agent یک اشتباه را مدام تکرار می‌کند. نوشتن قاعدهٔ زیاد، بیشتر نویز می‌سازد تا کمک.

از مستندات رسمی Cursor و وبلاگ بهترین روش‌های Agent خوانده‌ایم (۲۶ آبان ۱۴۰۵). اگر نام تنظیم یا مسیرها در نسخهٔ تو فرق داشت، همان مستندات را ببین.

چهار نوع

  1. Project Rules: در .cursor/rules ذخیره می‌شوند و با پروژه نگه‌داری (version-control) می‌شوند.
  2. User Rules: سراسری، از Customize → Rules.
  3. Team Rules: از داشبورد، برای طرح‌های Team و Enterprise.
  4. 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 و سایر قابلیت‌های هوش مصنوعی اثر ندارند.

الگوی ساده

  1. بدون قاعده شروع کن.
  2. وقتی Agent دو سه بار همان اشتباه را کرد، یک قاعدهٔ کوتاه بنویس.
  3. قاعده را در git بگذار تا تیم هم استفاده کند.
  4. هر چند هفته یک بار فهرست را مرور و کم کن.

ادامه

برنامه‌ریزی و چت تازه در Cursor را بخوان. اگر با Claude Code کار می‌کنی، CLAUDE.md معادل این است. برای نقشهٔ کلی: کار با ابزارها.

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

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

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

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

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

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

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

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

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