قواعد المؤشر .mdc وبنيته بدون ديون فنية

قواعد .mdc جاهزة لـ Cursor IDE: تصميم مقسم إلى شرائح، والتحقق من Zod، والحماية من هلوسة الذكاء الاصطناعي، وTypeScript خالص في الإنتاج.

TL;DR · Key Answer

تحدد ملفات Cursor .mdc (Markdown with YAML frontmatter) حدودًا معمارية صارمة لوكيل الذكاء الاصطناعي: AlwaysApply، وglobs حسب الطبقة (مشتركة/كيانات/ميزات/عناصر واجهة مستخدم) وحظر تكرار المنطق. يؤدي هذا إلى تقليل عدد الأخطاء أثناء تشفير vibe بمقدار 3-4 مرات.

Checklist

  • أضف المادة الأمامية YAML باستخدام AlwaysApply: صحيح بالنسبة للقواعد الأساسية والكرات الأرضية الخاصة بالطبقة.
  • الحد من حجم الوظائف إلى 40-50 سطرًا وحظر عمليات الاستيراد الدائرية بين الشرائح.
  • يتطلب مخطط Zod على كل مسار API والتحقق من tsc --noEmit بعد كل تغيير.
  • إصلاح قاعدة السياق بنسبة 50%: ابدأ جلسة جديدة عندما يكون نصف النافذة ممتلئًا.

Forum Discussions (vbcd4u.com)

Все обсуждения →

Engineering Guides (MurdaSoft)

FAQ

أين يمكن حفظ قواعد .mdc في مشروع المؤشر؟

إلى المجلد .cursor/rules/ ذو الملحق .mdc (على سبيل المثال، .cursor/rules/architecture.mdc). يقوم المؤشر تلقائيًا بتوصيلهم باستخدام الكرات الأرضية أو حقل AlwaysApply.

كيف يكون .mdc أفضل من .cursorrules العادية؟

يدعم .mdc الوحدات النمطية عن طريق الملفات وأقنعة المسار (globs)، بحيث لا يتم تحميل السياق بشكل زائد بتعليمات غير ضرورية.