المرجع

مخطط marketplace.json

يوجد ملف بيان السوق في .claude-plugin/marketplace.json في جذر المستودع.

الحقول على المستوى الأعلى

الحقل	مطلوب	الوصف
`$schema`	لا	عنوان URL لمخطط JSON للتحقق
`name`	نعم	معرّف السوق الفريد
`version`	لا	إصدار مخطط السوق (semver)
`metadata.description`	نعم	وصف السوق المقروء للإنسان
`owner.name`	نعم	المؤسسة أو المستخدم المالك للسوق
`owner.url`	لا	عنوان URL لملف المالك أو موقعه الإلكتروني
`owner.email`	لا	البريد الإلكتروني للتواصل
`plugins`	نعم	مصفوفة إدخالات الإضافات

حقول إدخال الإضافة

الحقل	مطلوب	الوصف
`name`	نعم	معرّف الإضافة (يجب أن يطابق `plugin.json`)
`description`	نعم	وصف مختصر للإضافة
`version`	نعم	سلسلة الإصدار الدلالي
`author.name`	نعم	مؤلف الإضافة
`source`	نعم	المسار أو عنوان URL للإضافة (انظر أنواع المصادر)
`category`	نعم	فئة الإضافة (مثلاً، `productivity`)
`homepage`	لا	عنوان URL لتوثيق الإضافة أو صفحتها الرئيسية
`license`	لا	معرّف ترخيص SPDX
`keywords`	لا	مصفوفة كلمات مفتاحية للبحث
`tags`	لا	مصفوفة وسوم للتصفية
`repository`	لا	عنوان URL للمستودع

أنواع مصادر الإضافات

يدعم حقل source في marketplace.json تنسيقات متعددة:

النوع	مثال	الوصف
مسار نسبي	`./plugins/example-plugin`	إضافة في نفس المستودع
اختصار GitHub	`owner/repo`	إضافة في جذر المستودع
GitHub مع مسار	`owner/repo/path/to/plugin`	إضافة في مجلد فرعي
عنوان URL لـ Git	`https://github.com/owner/repo.git`	مستودع Git
حزمة npm	`npm:@scope/package`	حزمة npm منشورة

مخطط plugin.json

تحتوي كل إضافة على ملف بيان في .claude-plugin/plugin.json داخل مجلدها.

الحقل	مطلوب	الوصف
`name`	نعم	معرّف الإضافة
`description`	نعم	وظيفة الإضافة
`version`	نعم	الإصدار الدلالي
`author.name`	نعم	مؤلف الإضافة
`author.url`	لا	عنوان URL لملف المؤلف أو موقعه الإلكتروني
`homepage`	لا	عنوان URL للتوثيق
`keywords`	لا	كلمات مفتاحية للبحث
`license`	لا	معرّف ترخيص SPDX
`repository`	لا	عنوان URL للمستودع

هيكل مجلد الإضافة

plugins/example-plugin/
  .claude-plugin/
    plugin.json          # Plugin manifest (required)
  skills/
    skill-name/
      SKILL.md           # Skill definition (required per skill)
      references/        # Reference data files (optional)
  commands/
    command-name.md      # Command definition (one per command)
  agents/
    agent-name.md        # Agent definition (one per agent)
  README.md              # Plugin documentation (recommended)

متغيرات البيئة

يمكن للإضافات استخدام هذه المتغيرات في ملفات المهارات والأوامر:

المتغير	الوصف
`$\{CLAUDE_PLUGIN_ROOT\}`	المسار المطلق إلى المجلد الجذر للإضافة

التحقق

تحقق من بيانات السوق والإضافات محلياً:

claude plugin validate .

يتحقق هذا من:

توافق مخطط marketplace.json
وجود جميع مجلدات الإضافات المشار إليها
امتلاك كل إضافة لملف plugin.json صالح
تنسيق frontmatter لـ SKILL.md بشكل صحيح في المهارات
امتلاك الأوامر للحقول المطلوبة في frontmatter

تكوين الفريق

التكوين المسبق للأسواق

أضف إلى .claude/settings.json في أي مستودع:

{
  "extraKnownMarketplaces": [
    "f5-sales-demo/marketplace"
  ]
}

التفعيل المسبق للإضافات

{
  "enabledPlugins": [
    "f5xc-docs-tools@f5-sales-demo-marketplace"
  ]
}

استكشاف الأخطاء وإصلاحها

السوق غير موجود

تحقق من إضافة السوق:

/plugin marketplace list

إذا كان مفقوداً، أعد إضافته:

/plugin marketplace add f5-sales-demo/marketplace

الإضافة لا تتفعّل

تأكد من تثبيت الإضافة: /plugin list
تحقق من أن إصدار Claude Code يدعم الإضافات (v1.0.33+)
تحقق من أن شروط التفعيل الخاصة بالمهارة تطابق سياقك الحالي

المهارات لا تُفعَّل تلقائياً

تُفعَّل المهارات استناداً إلى حقل description في frontmatter ملف SKILL.md. إذا لم تُفعَّل مهارة ما عند توقع ذلك:

تحقق من أن الوصف يصف سياق التفعيل بدقة
استخدم الأمر مباشرةً (مثلاً، /f5xc-docs-tools:review-mdx) كحل بديل

أخطاء البناء بعد المراجعة

تُبلّغ الإضافة عن المشكلات لكنها لا تُصلحها تلقائياً. طبّق الإصلاحات المقترحة يدوياً، ثم أعد تشغيل المراجعة للتأكد من الحل.