إنشاء ملحق Cowork

# إنشاء ملحق Cowork

بناء ملحق جديد من الصفر من خلال محادثة موجهة. توجيه المستخدم عبر مراحل الاكتشاف والتخطيط والتصميم والتنفيذ والتغليف — تقديم ملف `.plugin` جاهز للتثبيت في النهاية.

## نظرة عامة

الملحق هو دليل مستقل يوسّع إمكانيات Claude من خلال المهارات والعوامل والخطافات وتكاملات خادم MCP. تشفر هذه المهارة معمارية الملحق الكاملة وسير عمل من خمس مراحل لإنشاء واحد عن طريق المحادثة.

العملية:

1. **الاكتشاف** — فهم ما يريد المستخدم بناءه 2. **تخطيط المكونات** — تحديد أنواع المكونات المطلوبة 3. **التصميم والأسئلة التوضيحية** — تحديد كل مكون بالتفصيل 4. **التنفيذ** — إنشاء جميع ملفات الملحق 5. **المراجعة والتغليف** — تقديم ملف `.plugin`

> **المخرجات غير التقنية**: احتفظ بجميع المحادثات الموجهة للمستخدم باللغة الواضحة. لا تكشف عن تفاصيل التنفيذ مثل مسارات الملفات أو هياكل الدليل أو حقول المخطط إلا إذا سأل المستخدم. صِغ كل شيء من حيث ما سيفعله الملحق.

## معمارية الملحق

### هيكل الدليل

يتبع كل ملحق هذا التخطيط:

``` plugin-name/ ├── .claude-plugin/ │ └── plugin.json # مطلوب: بيان الملحق ├── skills/ # المهارات (مجلدات فرعية مع SKILL.md) │ └── skill-name/ │ ├── SKILL.md │ └── references/ ├── agents/ # تعريفات الوكيل الفرعي (ملفات .md) ├── .mcp.json # تعريفات خادم MCP └── README.md # توثيق الملحق ```

> **صيغة `commands/` الموروثة**: قد تتضمن الملحقات الأقدم دليل `commands/` يحتوي على أوامر شرطة مائلة `.md` من ملف واحد. هذه الصيغة لا تزال تعمل، لكن يجب أن تستخدم الملحقات الجديدة صيغة `skills/*/SKILL.md` بدلاً من ذلك — يقدم Cowork UI كلاهما كمفهوم "المهارات" الموحد، وتدعم صيغة المهارات الكشف التدريجي عبر `references/`.

**القواعد:**

- `.claude-plugin/plugin.json` مطلوب دائماً - تذهب مجلدات المكونات (`skills/`، `agents/`) إلى جذر الملحق، وليس داخل `.claude-plugin/` - أنشئ مجلدات فقط للمكونات التي يستخدمها الملحق فعلاً - استخدم kebab-case لجميع أسماء الدليل والملفات

### بيان plugin.json

موجود في `.claude-plugin/plugin.json`. الحقل المطلوب الحد الأدنى هو `name`.

```json { "name": "plugin-name", "version": "0.1.0", "description": "شرح موجز لغرض الملحق", "author": { "name": "اسم المؤلف" } } ```

**قواعد الاسم:** kebab-case، حروف صغيرة مع واصلات، بدون مسافات أو أحرف خاصة. **الإصدار:** صيغة semver (MAJOR.MINOR.PATCH). ابدأ من `0.1.0`.

الحقول الاختيارية: `homepage`، `repository`، `license`، `keywords`.

يمكن تحديد مسارات المكونات المخصصة (ملحقات، لا تحل محل، الاكتشاف التلقائي):

```json { "commands": "./custom-commands", "agents": ["./agents", "./specialized-agents"], "hooks": "./config/hooks.json", "mcpServers": "./.mcp.json" } ```

### مخططات المكونات

توجد مخططات مفصلة لكل نوع مكون في `references/component-schemas.md`. ملخص:

| المكون | الموقع | الصيغة | | ---------------------------------- | ------------------- | --------------------------- | | المهارات | `skills/*/SKILL.md` | Markdown + واجهة أمامية YAML | | خوادم MCP | `.mcp.json` | JSON | | الوكلاء (نادراً في Cowork) | `agents/*.md` | Markdown + واجهة أمامية YAML | | الخطافات (نادراً جداً في Cowork) | `hooks/hooks.json` | JSON | | الأوامر (موروث) | `commands/*.md` | Markdown + واجهة أمامية YAML |

هذا المخطط مشترك مع نظام الملحقات في Claude Code، لكنك تنشئ ملحقاً لـ Claude Cowork، تطبيق سطح مكتب للقيام بعمل المعرفة. سيجد مستخدمو Cowork عادة المهارات الأكثر فائدة. **قم بتدعيم الملحقات الجديدة مع `skills/*/SKILL.md` — لا تنشئ `commands/` إلا إذا احتاج المستخدم بشكل صريح إلى صيغة الملف الواحد الموروثة.**

### الملحقات القابلة للتخصيص مع عناصر نائبة `~~`

> **لا تستخدم أو تسأل عن هذا النمط بشكل افتراضي.** قدّم عناصر نائبة `~~` فقط إذا قال المستخدم بوضوح أنهم يريدون للأشخاص خارج منظمتهم استخدام الملحق. > يمكنك ذكر أن هذا خيار متاح إذا بدا أن المستخدم يريد توزيع الملحق خارجياً، لكن لا تسأل بشكل استباقي عن هذا مع AskUserQuestion.

عندما يكون الملحق مقصوداً لمشاركته مع أشخاص آخرين خارج شركتهم، قد تحتوي أجزاء منه على أجزاء تحتاج إلى التكيف مع المستخدمين الأفراد. قد تحتاج إلى الإشارة إلى الأدوات الخارجية حسب الفئة بدلاً من المنتج المحدد (على سبيل المثال، "مُتتبع المشروع" بدلاً من "Jira"). عند الحاجة إلى المشاركة، استخدم لغة عامة وضع علامة على هذه باعتبارها تتطلب تخصيص مع حرفين موجة مثل `إنشاء مشكلة في ~~مُتتبع المشروع`. إذا تم استخدام أي فئات أدوات، اكتب ملف `CONNECTORS.md` في جذر الملحق لتوضيح:

```markdown # الموصلات

## كيفية عمل مراجع الأدوات

تستخدم ملفات الملحق `~~category` كمكان ```