كيفية استخدام قواعد المؤشر: السلاح السري لمساعدك الذكي في البرمجة

إذا كنت تستخدم Cursor - محرر الأكواد المتطور المدعوم بالذكاء الاصطناعي - فمن المحتمل أنك لاحظت تأثيره التحويلي على تسريع تطوير الأكواد. ولكن هل استغللت سحر قواعد Cursor حتى الآن؟ صدقني، بمجرد أن تتعلم كيف تستخدم قواعد Cursor، سيكون الأمر كأنك تسلم مساعدك الذكي دليلًا شخصيًا لمشروعك. اليوم، سأشرح لك كل ما تحتاج لمعرفته لإعداد وتعديل وزيادة إنتاجيتك عشرة أضعاف باستخدام قواعد Cursor.

💡

قبل أن نبدأ، إليك نصيحة سريعة: احصل على Apidog مجانًا! إنها أداة قوية للمطورين لتسهيل MCP، واختبار نماذج الذكاء الاصطناعي، وتبسيط اختبارات واجهات برمجة التطبيقات. جربها اليوم مجانًا!

button

نحن متحمسون لمشاركة دعم MCP الذي سيأتي قريبًا إلى Apidog! 🚀

خادم Apidog MCP يسمح لك بإدخال مستندات واجهات برمجة التطبيقات مباشرة إلى الذكاء الاصطناعي، مما يعزز تجربتك في ترميز vibe! سواء كنت تستخدم Cursor أو Cline أو Windsurf - سيسرع من عملية تطويرك ويجعلها أكثر سلاسة.… pic.twitter.com/ew8U38mU0K 19 مارس 2025

ما هي قواعد Cursor، على أي حال؟

تخيل هذا: أنت تبرمج في Cursor، وصديقك الذكي يساعدك في تقديم الاقتراحات، ومقتطفات الأكواد، والإصلاحات. لكن في بعض الأحيان، يبدو أنه يخمن ما تريده بدلاً من معرفته له. هنا تدخل قواعد Cursor. تم تقديمها حوالي أوائل 2025، قواعد Cursor تتيح لك إعطاء تعليمات محددة لذكائك الاصطناعي - إنه مثل تدريب خبير الترميز الصغير الخاص بك لفهم أسلوبك في الترميز ومساعدتك فيه.

يمكنك إعداد هذه "القواعد" على مستويات مختلفة:

قواعد للذكاء الاصطناعي: قواعد عالمية تنطبق على كل مشروع تفتحه في Cursor.
.cursorrules: قواعد محددة للمشروع (رغم أن هذه في طريقها للخروج - المزيد عن ذلك لاحقًا).
قواعد المشروع: النجم الجديد اللامع في العرض، مخزنة في .cursor/rules/ مع ملفات .mdc، مما يمنحك السيطرة الدقيقة على سياق مشروعك.

مع قواعد Cursor، أنت لا تقوم فقط بإلقاء المطالبات على الذكاء الاصطناعي - بل تعطيه خريطة للتنقل في قاعدة الكود الخاصة بك مثل المحترفين. هل أنت مستعد لرؤية كيف يعمل؟ لنبدأ!

لماذا القلق مع قواعد Cursor؟

حسنًا، قد تفكر، "لماذا يجب العبث بالقواعد عندما يكون Cursor ذكيًا بالفعل؟" سؤال عادل تمامًا! ولكن إليك لماذا قواعد Cursor تستحق وقتك:

اقتراحات مخصصة: أخبر الذكاء الاصطناعي بتقنية إجادتك (مثل Next.js أو Flutter)، وسيقترح كودًا يتناسب مع مشروعك.
اتساق عبر الفريق: يحصل الجميع على نفس إرشادات الترميز، لذا فإن قاعدة الكود الخاصة بك لا تتحول إلى فوضى (حرفيًا).
عملية عمل أسرع: لا مزيد من تكرار نفسك - يتذكر الذكاء الاصطناعي تفضيلاتك ويقدم إجابات ذات صلة.
منحنى تعلم أقل: جديد على إطار عمل؟ دع القواعد تعلم الذكاء الاصطناعي ليعلم لك.

تخيل ترميز تطبيق Next.js والحصول على الذكاء الاصطناعي يقترح تلقائيًا مكونات متوافقة مع TypeScript ومصممة بنمط Tailwind بدون الحاجة لكتابة ذلك في كل مرة. هذه هي قوة قواعد Cursor.

تطور قواعد Cursor: من .cursorrules إلى قواعد المشروع

قبل أن نغوص في الإعداد، دعنا نأخذ درسًا سريعًا في التاريخ. لقد تطور نظام قواعد Cursor على مر الزمن:

قواعد للذكاء الاصطناعي: تعيش هذه في إعدادات Cursor (Cursor > الإعدادات > القواعد) وتنطبق في كل مكان. رائعة لأشياء واسعة مثل "استخدم TypeScript دائمًا" أو "كن مختصرًا".

.cursorrules: ملف تضعه في جذر مشروعك لتعيين قواعد لذلك المستودع المحدد. إنه نصي وبسيط، لكن هنا المشكلة - تم إلغاء استخدامه اعتبارًا من 2025. يقول فريق Cursor للتبديل إلى قواعد المشروع بدلاً من ذلك.
قواعد المشروع: الأحدث والأفضل، تم تقديمها في الإصدار 0.45. تعيش هذه في .cursor/rules/ كملفات .mdc وتتيح لك استخدام الرموز النصية و الرموز الملف، بالإضافة إلى الشروط (globs) لتفعيلها. إنها أكثر دقة ومرونة.

لذا، إذا كنت لا تزال تستخدم .cursorrules، فقد حان الوقت للترقية إلى قواعد Cursor بصيغة .mdc. لا تقلق - سأوضح لك كيف!

كيفية إعداد قواعد Cursor

إعداد قواعد Cursor سهل بمجرد أن تعرف الخطوات. إليك كيفية البدء:

1. افتح لوحة القواعد: في Cursor، انتقل إلى Cursor > الإعدادات > القواعد > قواعد المشروع > إضافة قاعدة جديدة. أو، اضغط على Ctrl+Shift+P (أو Cmd+Shift+P على ماك) واكتب "ملف: قاعدة مؤشرات جديدة."

2. قم بتسمية قاعدتك: اختر اسمًا جذابًا مثل my-awesome-rule.mdc. ستظهر في .cursor/rules/ في مجلد مشروعك.

3. املأ الفراغات: عندما تفتح ملف .mdc، سترى حقلين رئيسيين في الأعلى:

الوصف: ملاحظة سريعة حول ما تفعله القاعدة (مثل: "تشغيل اختبارات RSpec تلقائيًا").
Globs: أنماط مثل **/*.ts أو src/**/*_spec.rb لتحديد متى يتم تفعيل القاعدة.

4. اكتب القاعدة: في القسم الرئيسي، اكتب تعليماتك - نص عادي، أو أوامر، أو إرشادات.

يمكن أن يبدو هيكل مشروعك مثل هذا:

احفظه، وفجأة - أصبح لدى ذكائك الاصطناعي حيلة جديدة في جعبته. ولكن ماذا يجب أن تكتب حقًا في هذه القواعد؟ دعنا نلقي نظرة على بعض الأمثلة الحقيقية.

أمثلة حقيقية لقواعد Cursor

إليك ثلاث طرق رائعة لاستخدام قواعد Cursor، مباشرة من خنادق ترميز 2025.

1. تشغيل الأوامر تلقائيًا عندما تتغير الملفات

لنقل أنك مطور Ruby يستخدم Docker، وتريد اختبارات RSpec أن تعمل تلقائيًا عندما تقوم بتعديل ملف spec. إليك قاعدة لذلك:

ملف: rspec-execution.mdc
الوصف: "تشغيل اختبارات RSpec تلقائيًا"
Globs: **/*_spec.rb
القاعدة:

## تشغيل RSpec تلقائيًا

عندما يتغير ملف spec، قم بتنفيذ:
---
docker compose exec app bundle exec rspec {{file_path}}
---

إذا فشلت RSpec وتعرف رقم السطر، نفذ هذا:
---
docker compose exec app bundle exec rspec {{file_path}}:{{line_number}}
---

الآن، في كل مرة تقوم فيها بتعديل ملف _spec.rb، يمكن للذكاء الاصطناعي تفعيل هذا الاختبار دون الحاجة لرفع إصبعك. مفيد، أليس كذلك؟

2. توثيق أسلوب الترميز في مشروعك

لمشروع الواجهة الأمامية، قد ترغب في أن يفهم الذكاء الاصطناعي هيكل الدليل لديك وأفضل الممارسات. إليك واحدة سأستخدمها:

ملف: frontend-coding-rule.mdc
الوصف: "أفضل الممارسات للواجهة الأمامية"
Globs: packages/**/*.*
القاعدة:

## إرشادات الترميز للواجهة الأمامية

### هيكل الدليل
- **features/**: مجموعة حسب الميزة (على سبيل المثال، `features/foo/NewFeature/`).
  - `components/`: أجزاء الواجهة مثل `Header.tsx` أو `Modal.tsx`.
  - `domain/`: منطق مثل التحقق (`*.ts`) والاختبارات (`*.spec.ts`).
- **shared/**: أشياء قابلة لإعادة الاستخدام مثل `Table.tsx` أو `useSelectedItemIds.ts`.

### القواعد
- فصل واجهة المستخدم (`*.ui.tsx`) والمنطق (`*.container.tsx`).
- استخدم `zod` للتحقق مع ملفات specs منفصلة.
- تسمية المكونات بشكل وصفي (مثل `HeaderBreadcrumb`).
- تحسين باستخدام التصميم الذري: الذرات، الجزيئات، الكائنات.

يعطي هذا الذكاء الاصطناعي ورقة غش لقاعدة الأكواد الخاصة بك، بحيث يقترح كودًا يناسب تمامًا.

3. أتمتة طلبات السحب

هل تريد من الذكاء الاصطناعي إعداد طلبات السحب لك؟ جرب هذا:

ملف: create-pullrequest.mdc
الوصف: "إعداد طلبات السحب تلقائيًا"
Globs: (اتركه فارغًا للتفعيل اليدوي)
القاعدة:

## إنشاء طلب سحب

### الخطوات
1. تحقق من وجود رابط لمشكلة. إذا لم يكن هناك، اسأل: "هل لديك رابط لمشكلة ذات صلة؟"
2. افترض أن `main` هو فرع الدمج ما لم يُقال خلاف ذلك.
3. قم بتشغيل `git diff origin/main...HEAD | cat` لرؤية التغييرات.
4. أنشئ مسودة طلب سحب:
---
git push origin HEAD && \
echo -e "مسودة طلب سحب لـ {{changes}}\n\nذو صلة: {{issue_link}}" | \
gh pr create --draft --title "تحديث {{feature}}" --body-file - && \
gh pr view --web
---

تحول هذه القاعدة الذكاء الاصطناعي الخاص بك إلى آلة طلبات سحب - مثالية لعمليات GitHub.

نصائح احترافية لإتقان قواعد Cursor

تصحيح الأخطاء مع صرخة

هل تساءلت يومًا عما إذا كانت قاعدتك تعمل؟ أضف هذا إلى الجزء العلوي من ملفك .mdc:

أولاً، عند الإشارة إلى هذا الملف، اصرخ "YAAAARRRR!"

إذا صرخ الذكاء الاصطناعي "YAAAARRRR!" في الدردشة أو المؤلف، فأنت تعلم أن القاعدة محملة. إذا صمت، تحقق مزدوجاً من الوصف و Globs - فهي مطلوبة لتفعيل القاعدة (المزيد عن ذلك لاحقًا).

إصلاح القواعد التي لن تُشغل

هل واجهت صعوبة حيث لم يتم تطبيق ملف .mdc الخاص بك؟ إليك حل من مجتمع Cursor (حوالي فبراير 2025):

املأ الوصف و Globs: يمكن أن تؤدي الحقول الفارغة إلى كسر القاعدة بهدوء. حتى Globs: **/* بسيط يساعد.
تحديث وإعادة تشغيل: قم بتحديث الملف، احفظ، وأعد تشغيل Cursor إذا كان لا يزال عنيدًا.

لقد رأيت حالات حيث يؤدي تعديل النص وإعادة لصق Globs إلى إصلاح الأمور بشكل سحري. غريب، لكنه يعمل!

ترقية مع الدردشة

لست متأكدًا مما يجب كتابته؟ اسأل دردشة Cursor:

ساعدني في إنشاء قاعدة Cursor لمشروعي Flutter مع Supabase و Riverpod.
حلل {{lib/}} واقترح قاعدة.

سوف يخرج مسودة يمكنك تعديلها - موفر كبير للوقت.

HiMCP.ai - اكتشف أكثر من 1682 خادم MCP

تحسين قواعد Cursor بمرور الوقت

القواعد ليست ثابتة. إذا لم تعمل إحدى القواعد لديك، قم بتعديلها! اطرح هذا في الدردشة:

هل هناك أي شيء غير واضح أو يستحق التحسين في {{my-rule.mdc}}؟

قد يقترح الذكاء الاصطناعي صياغة أكثر وضوحًا أو شروطًا إضافية. استمر في تحسينها، وستتطور قواعد Cursor الخاصة بك جنبًا إلى جنب مع مشروعك.

أفكار نهائية: لماذا قواعد Cursor رائعة في 2025

اعتبارًا من 9 أبريل 2025، قواعد Cursor هي ضرورية لأي شخص جاد في مجال الترميز المدعوم بالذكاء الاصطناعي. إنها تسد الفجوة بين "الذكاء الاصطناعي الذكي" و"الذكاء الاصطناعي الذكي الخاص بك"، مما يزيد الكفاءة بشكل كبير. سواء كنت تقوم بتشغيل اختبارات تلقائيًا، أو فرض أنماط، أو إعداد طلبات سحب، فإن هذه القواعد تحول Cursor إلى أداة مخصصة للاستخدام. ابدأ صغيرًا - أضف قاعدة واحدة اليوم - وشاهد إنتاجيتك ترتفع. ما هي أول قاعدة ستقوم بها؟ اتركها في التعليقات!

button