مواصفات إضافات Cursor: يصف المستودع cursor/plugins صيغة إضافات (plugins) محرر Cursor، ويضم أيضًا مجموعة من الإضافات «الرسمية»، لكل منها مجلده وملف البيان (manifest) الخاص به. وصف المستودع على GitHub هو «Cursor plugin specification and official plugins». يبلغ عدد نجوم المستودع نحو 13 500 في نهاية أكتوبر 2026.
بالنسبة إلى فريق يثبّت إضافات في المحرر، تجيب المواصفات عن سؤالين: ما الذي يمكن أن تحتويه الإضافة (قواعد ومهارات ووكلاء وأوامر وhooks وخوادم MCP)، وماذا تفعل على جهازك. يعتمد هذا المقال على ملف README الخاص بالمستودع وعلى وثائق Cursor. وللموضوع نفسه في Claude Code، راجع الدليل الرسمي لإضافات Claude Code.
توضيح للأمانة: span.observer مدوّنة مستقلة لا صلة لها بـ Cursor، ولم تثبّت هذه الإضافات. الأوامر والمقتطفات مأخوذة من المستودع ومن وثائق Cursor، أما اللقطات فهي مقتطفات معروضة انطلاقًا من ملفات المستودع.
مواصفات إضافات Cursor: ما يقوله المستودع
- الناشر: المستودع تابع لمنظمة Cursor، وعنوان المؤلف في ملفات البيان هو
[email protected]. تذكر بعض الإضافات مؤلفين آخرين في عمود «Author» من README. - الترخيص: يشير قسم «License» في README إلى MIT. لم يظهر أي ملف LICENSE في جذر المستودع بتاريخ 22 أكتوبر 2026، أما الإضافات التي روجعت (مثل
teaching) فلكلٍّ منها ملف MIT خاص بها يحمل «Copyright (c) 2026 Cursor». تحقق من ملف كل إضافة قبل إعادة استخدامها. - أرقام قُرئت في 22 أكتوبر 2026: نحو 13 500 نجمة، ونحو 1 300 fork، و642 commit. ولا توجد أي release منشورة.
- المحتوى: يسرد جدول README نحو مئة إضافة: أدوات للمطوّرين (مراجعة PR وإنشاء إضافة وSDK)، وفي المجلد
third_party/تكاملات (Google Drive وGitHub وPlaywright وSalesforce وغيرها).
تشريح الإضافة
كل إضافة مجلد في الجذر يحتوي على ملف البيان .cursor-plugin/plugin.json. هذا ملف البيان الخاص بالإضافة teaching، مختصرًا:

توضح وثائق Cursor أن الحقل name وحده إلزامي في plugin.json. وتوجد المكوّنات في مجلدات افتراضية أو في مسارات مصرَّح بها في ملف البيان:
- rules/: قواعد بصيغة
.mdc؛ - skills/<name>/SKILL.md: مهارات (skills) للوكيل؛
- agents وcommands: إعدادات الوكلاء وملفات الأوامر (مخصصة لصيغة Cursor Plugins بحسب الوثائق)؛
- hooks: سكربتات تُطلقها أحداث؛
- mcp.json: تعريفات خوادم MCP. تطلب الوثائق استخدام
${CURSOR_PLUGIN_ROOT}للإشارة إلى جذر الإضافة.
يضيف المستودع الذي يضم عدة إضافات الملف .cursor-plugin/marketplace.json الذي يسرد كل إضافة (الاسم والمصدر والوصف).

التثبيت خطوة بخطوة
الخطوة 1 — من المحرر
يعطي README الأمر /add-plugin teaching (يليه اسم الإضافة). وتصف وثائق Cursor أيضًا المسار الرسومي: افتح «Customize»، وابحث عن الإضافة، واختر «Install»، ثم اختر النطاق: المشروع أو المستخدم.
الخطوة 2 — التطوير محليًا
بحسب الوثائق، تضع الإضافة في ~/.cursor/plugins/local/<plugin-name>، ثم تعيد تشغيل Cursor أو تنفّذ «Developer: Reload Window». وتقدّم الإضافة create-plugin في المستودع هيكلًا أوليًا ومراجعة قبل التقديم (المهارتان create-plugin-scaffold وreview-plugin-submission).
الخطوة 3 — النشر
تذكر الوثائق أن التقديم يتم عبر cursor.com/marketplace/publish، وأن كل إضافة وكل تحديث يخضعان لمراجعة يدوية قبل الإدراج، وأن الإضافات المنشورة في السوق يجب أن تكون مفتوحة المصدر. وتذكر كذلك أسواقًا خاصة لعروض Teams وEnterprise.
ما الذي تفعله الإضافة على جهازك
الإضافة ليست نصًا بسيطًا. هذه أمثلة قُرئت في المستودع:
- تعلن الإضافة
ralph-loopفيhooks/hooks.jsonعن hooks من النوعينafterAgentResponseوstopتشغّل سكربتات shell من الإضافة؛ - تعلن الإضافة
github(المجلدthird_party/github) فيmcp.jsonعن خادم MCP بعيد هوhttps://api.githubcopilot.com/mcp/، مع ترويسة تفويض تُقرأ من المتغيرGITHUB_PERSONAL_ACCESS_TOKEN؛ - تصف عدة إضافات في
third_party/نفسها بأنها منافذ إلى خدمات: مراسلة وCRM ومالية ودفع. وتذكر أوصاف README مثلًا تنفيذ أوامر البورصة أو إرسال الرسائل: هذه صلاحيات يجب مراجعتها قبل التفعيل.
بخصوص خادم GitHub، راجع دليل خادم MCP الخاص بـ GitHub؛ وبخصوص مخاطر التعليمات المخفية، راجع تسميم أدوات MCP؛ وبخصوص إضافة مراقبة في جانب Dynatrace، راجع إضافة Dynatrace لـ Cursor.
المراقبة والإشراف
لا تصف المواصفات تصديرًا عبر OpenTelemetry للإضافات نفسها. أما ما يمكن قياسه من جهة التشغيل فهو:
- الجرد: أحصِ الإضافات المثبّتة في كل جهاز وإصدارها ونطاقها (مشروع أو مستخدم)، كما تفعل مع الحزم.
- Hooks: اقرأ كل ملف
hooks.jsonوالسكربتات التي يستدعيها، وسجّل عمليات تنفيذها إن كنت مالك الجهاز. - خوادم MCP: دوّن العناوين ومتغيرات البيئة الخاصة بالرموز وصلاحيات كل رمز (راجع تأمين خادم MCP).
- التكاليف والاستدعاءات: يُقرأ نشاط الأدوات في قياسات الوكيل (telemetry) وليس في الإضافة.
الحدود والنقاط المفتوحة
- الترخيص: MIT بحسب README، لكن لا يوجد ملف في الجذر عند المراجعة؛ ولم تُراجع هنا جميع إضافات
third_party/. - الصيغة تتطور: تميّز وثائق Cursor أصلًا بين صيغة «Cursor Plugins» (
.cursor-plugin/plugin.json) وصيغة «Agent Plugins» (plugin.jsonفي الجذر). - تتطلب عدة إضافات حسابات لدى أطراف ثالثة، وشروط هذه الخدمات لا تعتمد على المستودع.
أفضل الممارسات
- ثبّت على مستوى المشروع بدل المستخدم ما دمت في مرحلة التقييم.
- اقرأ
plugin.jsonوhooks.jsonوmcp.jsonقبل تفعيل أي إضافة. - امنح خوادم MCP رموزًا بأقل الصلاحيات، للقراءة فقط كلما أمكن.
- أعدّ جردًا مكتوبًا بالإضافات المسموح بها، مع مالك لكل إضافة وتاريخ مراجعة.
الأسئلة الشائعة
هل إضافات Cursor هي نفسها إضافات Claude Code؟
لا تفترض أنهما قابلتان للتبادل. ملف البيان في Cursor هو .cursor-plugin/plugin.json، وتصف وثائق Cursor أيضًا صيغة «Agent Plugins». تحقق من التوافق في وثائق الأداة الأخرى قبل إعادة استخدام إضافة.
هل يجب الدفع لاستخدام هذا المستودع؟
المستودع عام ومرخّص بـ MIT بحسب README. أما محرر Cursor والخدمات الخارجية التي تستدعيها الإضافات فلكلٍّ منها شروطه الخاصة.
كيف أعرف ما ترسله الإضافة إلى الخارج؟
اقرأ ملف mcp.json الخاص بها (عناوين الخوادم) وملفات hooks (السكربتات المنفَّذة). ثم راقب الاتصالات الصادرة من الجهاز.
الخلاصة
يعمل المستودع cursor/plugins كمواصفات حيّة وككتالوج. وأهم ما في الأمر لفريق SRE أن يعامل الإضافة كما يعامل الشيفرة: يقرأ ملف البيان، ويراجع hooks، ويقيّد الرموز، ويحافظ على الجرد. المصادر: مستودع cursor/plugins ووثائق إضافات Cursor.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا لـ Cursor ولا للمشاريع المذكورة. العلامات التجارية المذكورة تعود إلى مالكيها. الأدوات تتطور بسرعة: تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.