المرجع

مخطط marketplace.json

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

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

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

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

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

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

يدعم الحقل source في marketplace.json صيغًا متعددة:

النوع	مثال	الوصف
مسار نسبي	`./plugins/example-plugin`	إضافة في نفس المستودع
اختصار GitHub	`owner/repo`	إضافة في جذر المستودع
GitHub مع مسار	`owner/repo/path/to/plugin`	إضافة في مجلد فرعي
رابط 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`	لا	رابط الملف الشخصي أو الموقع الإلكتروني للمؤلف
`homepage`	لا	رابط التوثيق
`keywords`	لا	كلمات البحث
`license`	لا	معرّف الترخيص SPDX
`repository`	لا	رابط المستودع

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

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) كحل بديل

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

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