انتقل إلى المحتوى الرئيسي

استخدام قواعد Cursor بفعالية

مقدمة​

قواعد Cursor هي أداة قوية لتحسين تجربة البرمجة وضمان جودة الكود. هذا الدليل سيساعدك في فهم وتنفيذ القواعد بشكل فعال.

أساسيات القواعد​

1. هيكل القواعد​

القواعد تُخزن في مجلد .cursor/rules:

# .cursor/rules/code-style.mdc
name: "قواعد نمط الكود"
version: 1.0
rules:
  - pattern: "function"
    style: "camelCase"
  - pattern: "class"
    style: "PascalCase"

2. أنواع القواعد​

  • قواعد التنسيق
  • قواعد النمط
  • قواعد الأمان
  • قواعد الأداء

3. تنظيم القواعد​

# .cursor/rules/organization.mdc
structure:
  - category: "style"
    files: ["*.style.mdc"]
  - category: "security"
    files: ["*.security.mdc"]

أفضل الممارسات​

1. تصميم القواعد​

  • قواعد بسيطة ومركزة
  • تجنب التداخل
  • توثيق الغرض
  • اختبار الفعالية

2. تنفيذ القواعد​

# .cursor/rules/implementation.mdc
rules:
  - name: "تنسيق التعليقات"
    pattern: "// TODO:"
    action: "format"
    style: "// TODO [${author}]: "

3. إدارة القواعد​

  • مراجعة دورية
  • تحديث مستمر
  • تتبع الأداء
  • جمع التغذية الراجعة

قواعد متقدمة​

1. قواعد نمط الكود​

# .cursor/rules/code-style.mdc
style_rules:
  - scope: "javascript"
    rules:
      - name: "تنسيق الدوال"
        pattern: "function *"
        format: "camelCase"
      - name: "تنسيق المتغيرات"
        pattern: "const|let|var"
        format: "camelCase"

2. قواعد التوثيق​

# .cursor/rules/documentation.mdc
doc_rules:
  - type: "function"
    template: |
      /**
       * @description ${description}
       * @param {${type}} ${name}
       * @returns {${returnType}}
       */

3. قواعد الاختبار​

# .cursor/rules/testing.mdc
test_rules:
  - pattern: "function"
    require_test: true
    test_template: |
      describe('${functionName}', () => {
        it('should work correctly', () => {
          // اختبار أساسي
        });
      });

تخصيص القواعد​

1. قواعد مخصصة​

# .cursor/rules/custom.mdc
custom_rules:
  - name: "قاعدة مخصصة"
    pattern: "${pattern}"
    action: "${action}"
    parameters:
      param1: "value1"
      param2: "value2"

2. قواعد حسب المشروع​

# .cursor/rules/project-specific.mdc
project_rules:
  - name: "قواعد المشروع"
    scope: "src/**/*"
    rules:
      - pattern: "import"
        style: "absolute"
      - pattern: "export"
        style: "named"

3. قواعد الفريق​

# .cursor/rules/team.mdc
team_rules:
  - standards: "eslint"
  - conventions: "prettier"
  - custom:
      - rule1: "value1"
      - rule2: "value2"

معالجة الأخطاء​

1. أخطاء شائعة​

المشكلة: تضارب القواعد الحل:

  • تحديد الأولويات
  • توحيد القواعد
  • حل التضارب

2. تصحيح الأخطاء​

# .cursor/rules/error-handling.mdc
error_rules:
  - type: "conflict"
    action: "warn"
  - type: "syntax"
    action: "fix"

3. التحقق من القواعد​

# التحقق من صحة القواعد
cursor validate-rules

# اختبار قاعدة محددة
cursor test-rule rule-name

تحسين القواعد​

1. أداء القواعد​

# .cursor/rules/performance.mdc
performance:
  cache: true
  throttle: "1s"
  exclude:
    - "node_modules"
    - "build"

2. تكامل القواعد​

# .cursor/rules/integration.mdc
integrations:
  - linter: "eslint"
  - formatter: "prettier"
  - custom:
      - tool: "custom-tool"
        config: "custom-config"

3. مراقبة القواعد​

# .cursor/rules/monitoring.mdc
monitoring:
  enabled: true
  metrics:
    - usage
    - performance
    - errors
  reporting: "weekly"

نصائح وإرشادات​

1. تحسين الإنتاجية​

  • استخدام القوالب
  • أتمتة التطبيق
  • تحديث مستمر
  • تدريب الفريق

2. ضمان الجودة​

  • اختبار شامل
  • مراجعة دورية
  • توثيق التغييرات
  • جمع الملاحظات

3. التعاون​

  • مشاركة القواعد
  • توحيد المعايير
  • تدريب الفريق
  • تحديث مستمر

موارد إضافية​

تذكير مهم​

راجع وحدث قواعدك بانتظام للحفاظ على فعاليتها وملاءمتها لاحتياجات مشروعك وفريقك.