Cursor Project Rules (.cursor/rules/*.mdc): مكانه وكيفية قراءته من الأدوات

قواعد Cursor للمشروع هي ملفات .mdc في .cursor/rules/، وتحدد بياناتها الوصفية متى تُرفق كل قاعدة. يقرأ Cursor أيضاً AGENTS.md، إلى جانب قواعد المستخدم وقواعد الفريق المضبوطة خارج المستودع.

مكان الملف

• .cursor/rules/**/*.mdc، ويُسمح بالمجلدات الفرعية؛ أما ملفات .md العادية في .cursor/rules فيتم تجاهلها.
• ملف AGENTS.md في الجذر وفي المجلدات المتداخلة.
• قواعد المستخدم، المضبوطة في إعدادات Cursor.
• قواعد الفريق، المضبوطة في لوحة تحكم الفريق.

التنسيق

Markdown مع بيانات YAML وصفية، ويُشترط امتداد .mdc. تؤدي alwaysApply: true إلى تضمين القاعدة دائماً؛ وتُرفق القواعد التي تتضمن globs مع alwaysApply: false عند وجود ملف مطابق في السياق؛ أما الوصف وحده فيترك القرار للوكيل. إذا لم يتوفر أي مما سبق، فلا تُطبّق القاعدة إلا عند الإشارة إليها باستخدام @.

مفاتيح Frontmatter: descriptionglobsalwaysApply

---
description: React component conventions
globs: src/components/**/*.tsx
alwaysApply: false
---

- One component per file, with a named export matching the file name.
- Type props with an interface named after the component plus Props.
- Use the existing CSS modules; no inline style objects.
- Follow @src/components/Button.tsx as the reference pattern.

الأولوية والدمج

قواعد الفريق، ثم قواعد المشروع، ثم قواعد المستخدم. تُدمج كل القواعد المنطبقة، وعند التعارض تكون الأولوية للمصدر الأسبق؛ ولا يمكن تعطيل قواعد الفريق المفروضة. تُدمج ملفات AGENTS.md في المجلدات المتداخلة مع ملفات المجلدات الأصلية، وتكون الأولوية للملف الأكثر تحديداً.

الأدوات التي تقرأه

نصائح

• افصل بين عدة أنماط glob بفواصل في حقل globs.
• اجعل كل قاعدة أقل من 500 سطر، وأشِر إلى الملفات باستخدام @filename بدلًا من لصق محتواها.
• لا تؤثر القواعد في Cursor Tab، ولا تنطبق User Rules على Inline Edit.
• لم يعد ملف .cursorrules القديم مذكورًا في وثائق Cursor؛ انقله إلى .cursor/rules/.

ملفات التعليمات الأخرى