الدلائل - قواعد مجتمعي Cursor و Windsurf ودليل خادم MCP

نظرة عامة على المشروع

Directories هو مشروع مفتوح المصدر مصمم خصيصًا لمجتمعي Cursor و Windsurf، ويوفر بشكل أساسي منصة مركزية لإدارة ومشاركة القواعد (Rules) وخوادم MCP (بروتوكول سياق النموذج). تم تطوير المشروع وصيانته بواسطة Pontus Abrahamsson، ويهدف إلى مساعدة المطورين على الاستفادة بشكل أفضل من أدوات البرمجة المدعومة بالذكاء الاصطناعي.

الميزات الرئيسية

1. نظام إدارة القواعد

• تخزين القواعد بشكل مركزي: إدارة مختلف قواعد التطوير وموجهات الأوامر (prompts) بشكل مركزي في دليل packages/data/rules/
• تنسيق موحد: تتضمن كل قاعدة تنسيق معلمات موحدًا لضمان الاتساق وسهولة الاستخدام.
• إدارة مصنفة: تنظيمها وتصنيفها حسب لغة البرمجة أو الإطار أو الأداة.

2. آلية مساهمة المجتمع

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

3. تكامل خادم MCP

• دعم MCP: يدعم بروتوكول سياق النموذج (Model Context Protocol)، مما يعزز قدرة أدوات الذكاء الاصطناعي على التفاعل.
• توافق مع أدوات متعددة: يدعم في نفس الوقت أداتي البرمجة الرائدتين المدعومتين بالذكاء الاصطناعي: Cursor و Windsurf.

الهيكل التقني

هيكل المشروع

directories/
├── packages/
│   └── data/
│       └── rules/
│           ├── index.ts          # ملف فهرس القواعد
│           └── rules/            # دليل ملفات القواعد المحددة
│               ├── c.ts
│               ├── nextjs.ts
│               └── ...
├── apps/
│   ├── cursor/                   # إعدادات Cursor ذات الصلة
│   └── windsurf/                 # إعدادات Windsurf ذات الصلة

تنسيق تعريف القاعدة

يجب أن يتضمن كل ملف قاعدة المعلمات القياسية التالية:

{
  tags: ["JavaScript", "Next.js"],           // علامات خاصة باللغة
  title: "Next.js Best Practices",           // عنوان القاعدة
  slug: "nextjs-best-practices",             // معرف فريد
  content: `your amazing prompt`,            // محتوى موجه الأوامر (prompt)
  author: {                                  // معلومات المؤلف
    name: "Your Name",
    url: "https://github.com/username",
    avatar: "avatar-url"
  }
}

طريقة الاستخدام

إعداد بيئة التطوير

# تثبيت التبعيات
npm install

# تشغيل خادم التطوير
npm run dev
# أو
yarn dev
# أو
pnpm dev
# أو
bun dev

# الوصول إلى http://localhost:3000

إضافة قاعدة جديدة

1. تحديد موقع فهرس القواعد: أضف استيراد القاعدة الجديدة في ملف packages/data/rules/index.ts

   import { cRules } from "./rules/c";
   

2. إنشاء ملف القاعدة: أنشئ ملف قاعدة جديد في دليل packages/data/rules/

   // على سبيل المثال: nextjs.ts
   export const nextjsRules = {
     // تعريف القاعدة
   };
   

3. تعريف محتوى القاعدة: اكتب القاعدة وفقًا للتنسيق القياسي، مع التأكد من:

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

تحديث القواعد الحالية

1. ابحث عن ملف القاعدة ذي الصلة.
2. أضف محتوى جديدًا أسفل موجه الأوامر الحالي.
3. تأكد من أن المحتوى المضاف حديثًا قد تم اختباره والتحقق منه.

ميزات المجتمع

ضمان الجودة

• متطلبات الاختبار: يجب أن يتم اختبار جميع موجهات الأوامر والتحقق منها.
• ضمان الدقة: ضمان دقة وفائدة محتوى القواعد.
• تحسين مستمر: يقوم المجتمع بصيانة وتحسين القواعد الحالية باستمرار.

صديق للمطورين

• وثائق مفصلة: توفير إرشادات مساهمة كاملة وتعليمات استخدام.
• عملية موحدة: تنسيق قواعد موحد وعملية تقديم موحدة.
• آلية التقدير: عرض مساهمات المساهمين من خلال معلومات المؤلف.

تكامل الأدوات

• دعم محررين متعددين: يدعم Cursor و Windsurf في نفس الوقت.
• تطبيق فوري: يدعم التطبيق التلقائي للقواعد، والمطابقة الذكية لأنماط مسار الملفات.
• تكامل MCP: يدعم بروتوكول سياق النموذج (Model Context Protocol)، مما يعزز قدرة الذكاء الاصطناعي على التفاعل.

مزايا المشروع

1. إدارة مركزية: إدارة القواعد وموجهات الأوامر المبعثرة بشكل مركزي، مما يسهل العثور عليها واستخدامها.
2. تنسيق موحد: يضمن تنسيق القواعد الموحد التوافق وسهولة الصيانة.
3. مدفوع بالمجتمع: تعزز آلية المساهمة المفتوحة تبادل المعرفة والتحسين المستمر.
4. مستقل عن الأدوات: يدعم في نفس الوقت أدوات برمجة الذكاء الاصطناعي المتعددة، مما يزيد من قابليته للتطبيق.
5. ضمان الجودة: تضمن عمليات الاختبار والتحقق الصارمة فعالية القواعد.

سيناريوهات التطبيق

• البرمجة المدعومة بالذكاء الاصطناعي: توفير قواعد برمجة محسّنة لمستخدمي Cursor و Windsurf.
• التعاون الجماعي: يمكن للفرق مشاركة وتوحيد معايير البرمجة.
• تحسين المهارات: يمكن للمطورين المبتدئين تعلم أفضل الممارسات.
• تحسين الأدوات: تعزيز وظائف أدوات الذكاء الاصطناعي من خلال بروتوكول MCP.

ملخص

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