نظام إضافات Claude Code — وسّع إمكانيات كلود بلا حدود
ما هو نظام الإضافات في Claude Code؟
Claude Code ليس مجرد أداة ثابتة — هو نظام قابل للتوسيع بلا حدود. نظام الإضافات (Plugins) يسمح لك ببناء مكونات مخصصة تضيف قدرات جديدة لكلود: أوامر سلاش جديدة، وكلاء ذكيون متخصصون، مهارات تُفعّل تلقائياً، وخطافات (Hooks) تنفذ إجراءات قبل أو بعد عمليات محددة.
تخيّل أنك تبني "صندوق أدوات" مخصص لفريقك. بدلاً من تكرار نفس التعليمات كل مرة، تبني إضافة مرة واحدة وكل أعضاء الفريق يستخدمونها. مثلاً: إضافة /deploy تنشر الموقع تلقائياً، إضافة /seo-audit تفحص صفحة وتعطي تقرير SEO، أو وكيل ذكي يراجع الكود قبل كل commit.
نظام الإضافات يعمل على مستوى المشروع (في مجلد .claude/plugins/) أو على مستوى المستخدم (في مجلد المستخدم العام). الإضافات على مستوى المشروع تُشارَك مع الفريق عبر Git، أما إضافات المستخدم فهي شخصية تعمل في كل المشاريع.
الإضافات = قوة خارقة لـ Claude Code
بدون إضافات، Claude Code قوي. مع إضافات مخصصة لعملك، Claude Code يصبح أداة لا مثيل لها — يعرف عملياتك، يتبع معاييرك، ويُنفذ مهامك بدون تعليمات متكررة.
هيكل الإضافة (Plugin Structure)
كل إضافة عبارة عن مجلد يحتوي على ملف plugin.json (ملف التعريف) ومجلدات فرعية لكل نوع من المكونات:
# هيكل إضافة كاملة
my-plugin/
plugin.json # ملف التعريف — مطلوب
commands/ # أوامر سلاش مخصصة
deploy.md
seo-audit.md
agents/ # وكلاء ذكيون
code-reviewer.md
content-writer.md
skills/ # مهارات متخصصة
seo-optimizer/
SKILL.md
auto-testing/
SKILL.md
hooks.json # خطافات تلقائية
.mcp.json # MCP Servers للإضافة (اختياري)
كل مجلد اختياري — لا تحتاج إنشاء كل المجلدات. إذا كانت إضافتك تحتوي فقط على أوامر سلاش، أنشئ مجلد commands/ فقط. إذا كانت تحتوي على خطافات فقط، أنشئ hooks.json فقط. المطلوب الوحيد هو ملف plugin.json.
ملف plugin.json — قلب الإضافة
ملف plugin.json هو ملف التعريف الذي يصف الإضافة لـ Claude Code. يحتوي على معلومات أساسية ومكونات الإضافة:
{
"name": "marketing-toolkit",
"version": "1.0.0",
"description": "أدوات تسويق متكاملة لفريق التسويق",
"author": "A Plan Agency",
"commands": [
{
"name": "marketing-plan",
"description": "إنشاء خطة تسويق شهرية كاملة",
"file": "commands/marketing-plan.md"
}
],
"agents": [
{
"name": "content-writer",
"description": "وكيل كتابة محتوى متخصص",
"file": "agents/content-writer.md"
}
],
"mcpServers": {
"analytics": {
"command": "npx",
"args": ["-y", "mcp-server-analytics"]
}
}
}
الحقول المطلوبة هي name وversion وdescription. الباقي اختياري — أضف فقط المكونات التي تحتاجها. الاسم يجب أن يكون فريداً ويُستخدم كمعرّف للإضافة.
أنواع المكونات في الإضافة
كل إضافة يمكن أن تحتوي على أربعة أنواع من المكونات، كل نوع يخدم غرضاً مختلفاً:
1. Commands — أوامر سلاش مخصصة
Commands هي أوامر سلاش تنفذها بكتابة /command-name في Claude Code. كل أمر عبارة عن ملف Markdown يحتوي على تعليمات يتبعها كلود عند تنفيذ الأمر. مثال:
# commands/deploy.md
أنت مسؤول عن نشر الموقع على السيرفر.
اتبع هذه الخطوات بالترتيب:
1. شغّل npm run build وتأكد من نجاح البناء
2. شغّل npm test وتأكد من نجاح كل الاختبارات
3. ارفع الملفات على السيرفر عبر rsync
4. امسح الكاش (Cloudflare + server cache)
5. تحقق أن الموقع يعمل (HTTP 200)
6. أبلغ المستخدم بالنتيجة مع رابط الموقع
إذا فشلت أي خطوة، توقف فوراً وأبلغ المستخدم بالخطأ.
عندما تكتب /deploy في Claude Code، كلود يقرأ هذا الملف وينفذ الخطوات تلقائياً — يبني المشروع، يختبره، يرفعه، ويتحقق من النتيجة. أمر واحد ينفذ عملية كاملة كانت تستغرق 15 دقيقة يدوياً.
2. Agents — وكلاء ذكيون متخصصون
Agents هم وكلاء ذكيون بشخصيات وتعليمات وأدوات خاصة. كل وكيل عبارة عن ملف Markdown يحدد دور الوكيل وقدراته. الفرق عن Commands أن الوكلاء أكثر تعقيداً — لديهم سياق خاص وأدوات محددة ويمكنهم تنفيذ سلسلة من المهام المعقدة.
# agents/code-reviewer.md
أنت مراجع كود خبير. مهمتك مراجعة التغييرات البرمجية.
## المعايير:
- تحقق من الأمان (SQL injection, XSS, CSRF)
- تحقق من الأداء (N+1 queries, memory leaks)
- تحقق من قابلية القراءة والصيانة
- تحقق من التوافق مع معايير الفريق
- اقترح اختبارات مفقودة
## الإخراج:
قدّم تقريراً منظماً بالمشاكل المكتشفة مع:
- مستوى الخطورة (عالي/متوسط/منخفض)
- الملف والسطر
- الوصف والحل المقترح
3. Skills — مهارات تُفعّل تلقائياً
Skills هي مهارات متخصصة يكتشفها كلود ويستدعيها تلقائياً عند اكتشاف سياق مناسب. لا تحتاج كتابة أمر — كلود يعرف متى يستخدم المهارة بنفسه. كل مهارة عبارة عن مجلد يحتوي على ملف SKILL.md:
# skills/seo-optimizer/SKILL.md
## Description
تحسين محتوى الصفحات لمحركات البحث
## When to use
عندما يطلب المستخدم تحسين SEO أو عند إنشاء صفحات HTML جديدة
## Instructions
- أضف meta title (60 حرفاً كحد أقصى)
- أضف meta description (155 حرفاً كحد أقصى)
- تأكد من وجود H1 واحد فقط
- تحقق من بنية العناوين (H1 > H2 > H3)
- أضف alt text لكل الصور
- أضف Schema.org markup مناسب
- تحقق من الروابط الداخلية والخارجية
4. Hooks — خطافات تلقائية
Hooks هي إجراءات تُنفَّذ تلقائياً قبل أو بعد عمليات محددة. تُعرّف في ملف hooks.json. مثلاً: hook يراجع الكود تلقائياً قبل كل git commit، أو hook يشغّل الاختبارات بعد كل تعديل على ملفات Python:
{
"hooks": [
{
"event": "PreToolUse",
"matcher": "Bash(git commit*)",
"command": "npm run lint && npm test",
"description": "فحص الكود وتشغيل الاختبارات قبل كل commit"
},
{
"event": "PostToolUse",
"matcher": "Write(*.py)",
"command": "python -m pytest tests/ -q",
"description": "تشغيل اختبارات Python بعد كل تعديل"
}
]
}
الأحداث المدعومة تشمل: PreToolUse (قبل استخدام أداة)، PostToolUse (بعد استخدام أداة)، Notification (عند إرسال إشعار)، وStop (عند توقف كلود). يمكنك تحديد matcher لتفعيل الـ hook فقط على عمليات محددة.
بناء إضافة كاملة — مثال عملي
لنبنِ إضافة متكاملة لإدارة التسويق الرقمي. الإضافة ستحتوي على: أمر سلاش لإنشاء خطة تسويق، وكيل لكتابة المحتوى، مهارة SEO، و hook لمراجعة المحتوى تلقائياً.
أنشئ المجلدات والملفات الأساسية:
# إنشاء هيكل الإضافة
mkdir -p .claude/plugins/marketing-toolkit/{commands,agents,skills/seo-optimizer}
# الملفات المطلوبة:
.claude/plugins/marketing-toolkit/
plugin.json
commands/marketing-plan.md
agents/content-writer.md
skills/seo-optimizer/SKILL.md
hooks.json
عرّف الإضافة ومكوناتها:
{
"name": "marketing-toolkit",
"version": "1.0.0",
"description": "أدوات تسويق رقمي متكاملة — خطط، محتوى، SEO",
"author": "A Plan Agency",
"commands": [
{
"name": "marketing-plan",
"description": "إنشاء خطة تسويق شهرية كاملة"
}
],
"agents": [
{
"name": "content-writer",
"description": "وكيل كتابة محتوى تسويقي"
}
]
}
أنشئ ملف commands/marketing-plan.md بتعليمات إنشاء خطة تسويق شاملة — يحدد الجمهور، القنوات، الميزانية، الأهداف، تقويم المحتوى، و KPIs.
أنشئ ملف agents/content-writer.md يحدد شخصية كاتب المحتوى: النبرة، الأسلوب، القواعد، الصيغ المطلوبة لكل نوع محتوى (منشور سوشيال، مقال، إيميل).
أنشئ skills/seo-optimizer/SKILL.md بتعليمات تحسين SEO — كلود يطبقها تلقائياً عند إنشاء صفحات أو كتابة مقالات.
بعد إنشاء كل الملفات، الإضافة جاهزة للاستخدام فوراً. Claude Code يكتشفها تلقائياً وتظهر الأوامر الجديدة في قائمة الأوامر المتاحة.
MCP Servers في الإضافات
يمكنك تضمين إعدادات MCP Servers في إضافتك لتوفير أدوات إضافية لكلود. هناك طريقتان:
الطريقة 1: في plugin.json مباشرة
أضف حقل mcpServers في ملف plugin.json. كلود يتصل بالخوادم تلقائياً عند تفعيل الإضافة:
{
"name": "analytics-plugin",
"version": "1.0.0",
"description": "إضافة تحليلات متقدمة",
"mcpServers": {
"google-analytics": {
"command": "npx",
"args": ["-y", "mcp-server-ga4"],
"env": {
"GA_PROPERTY_ID": "$GA_PROPERTY_ID"
}
}
}
}
الطريقة 2: ملف .mcp.json منفصل
أنشئ ملف .mcp.json داخل مجلد الإضافة. هذا الأسلوب أنظف عندما تكون إعدادات الخوادم معقدة أو متعددة. كلود يقرأ الملف تلقائياً عند تفعيل الإضافة.
دورة حياة المكونات
كل مكون في الإضافة يمر بأربع مراحل:
- Registration (التسجيل): Claude Code يكتشف الإضافة ويقرأ plugin.json. يسجّل كل المكونات (أوامر، وكلاء، مهارات، خطافات) في النظام.
- Activation (التفعيل): عندما يستدعي المستخدم أمراً أو يُفعَّل hook أو تُكتشَف مهارة مناسبة، المكون يُفعَّل ويُحمَّل في ذاكرة كلود.
- Execution (التنفيذ): كلود ينفذ التعليمات المحددة في المكون — يقرأ الملف، يفهم المطلوب، وينفذه. خلال التنفيذ، كلود يمكنه استخدام كل الأدوات المتاحة (Bash، Read، Write، MCP tools).
- Cleanup (التنظيف): بعد اكتمال التنفيذ، المكون يعود لحالة الانتظار. النتائج تُعرض للمستخدم وأي موارد مؤقتة تُحرَّر.
المكونات لا تتداخل
كل مكون يعمل بشكل مستقل. الأوامر لا تتأثر بالوكلاء، والمهارات لا تتداخل مع الخطافات. هذا يضمن استقراراً وقابلية للتنبؤ — كل مكون ينفذ مهمته المحددة بدون آثار جانبية.
توزيع الإضافات ومشاركتها
الإضافات عبارة عن ملفات عادية يمكن مشاركتها بعدة طرق:
- عبر Git: ضع مجلد الإضافة في
.claude/plugins/في مشروعك. عند clone أو pull، كل أعضاء الفريق يحصلون على الإضافة تلقائياً. هذه أفضل طريقة لإضافات خاصة بمشروع محدد. - على مستوى المستخدم: ضع الإضافة في مسار المستخدم العام (
~/.claude/plugins/) لاستخدامها في كل مشاريعك. مفيدة لأدوات شخصية تستخدمها دائماً. - عبر npm: انشر إضافتك كحزمة npm يمكن تثبيتها بأمر واحد. مناسبة للإضافات العامة التي تريد مشاركتها مع المجتمع.
- عبر GitHub: شارك repository الإضافة على GitHub. المستخدمون يستنسخونها ويضعونها في مجلد الإضافات. مناسبة للإضافات مفتوحة المصدر.
5 أفكار لإضافات مفيدة
إليك خمس أفكار لإضافات يمكنك بناؤها لتحسين إنتاجيتك:
1. إضافة SEO Toolkit
أوامر لفحص SEO لأي صفحة، إنشاء meta tags، تحليل المنافسين، واقتراح كلمات مفتاحية. تتضمن مهارة SEO تُفعّل تلقائياً عند إنشاء صفحات HTML أو كتابة مقالات.
2. إضافة Deployment Pipeline
أمر /deploy ينفذ كامل عملية النشر: build، test، upload، clear cache، verify. مع hook يمنع النشر إذا فشلت الاختبارات. ويرسل إشعار Slack عند النجاح أو الفشل.
3. إضافة Testing Suite
وكيل متخصص في كتابة اختبارات — يحلل الكود ويكتب unit tests شاملة. مع hook يشغّل الاختبارات تلقائياً بعد كل تعديل على ملفات الكود.
4. إضافة Documentation Generator
أمر /docs يحلل الكود ويُنشئ توثيقاً شاملاً — README، API docs، دليل المستخدم. مع مهارة تحدّث التوثيق تلقائياً عند تعديل الكود.
5. إضافة Monitoring Dashboard
أوامر لمراقبة أداء الخوادم والتطبيقات. تتصل بخدمات المراقبة عبر MCP Servers وتعرض تقارير الأداء وتُنبّه عند اكتشاف مشاكل.
أسئلة شائعة عن نظام الإضافات
إليك إجابات مفصلة على أكثر الأسئلة التي يطرحها المستخدمون:
ما هو نظام الإضافات في Claude Code؟
▼نظام الإضافات يسمح لك بتوسيع قدرات Claude Code بإضافة أوامر مخصصة (Commands)، وكلاء ذكيين (Agents)، مهارات متخصصة (Skills)، وخطافات تلقائية (Hooks). كل إضافة عبارة عن مجلد يحتوي على ملف plugin.json ومكونات محددة.
كيف أبني إضافة مخصصة لـ Claude Code؟
▼ابدأ بإنشاء مجلد للإضافة وملف plugin.json يحدد الاسم والإصدار والوصف. ثم أضف المكونات المطلوبة: أوامر سلاش في مجلد commands/، وكلاء في agents/، مهارات في skills/، أو خطافات في hooks.json. كلود يكتشف الإضافة تلقائياً.
ما الفرق بين Commands و Agents و Skills؟
▼Commands هي أوامر سلاش بسيطة تنفذ مهمة محددة. Agents هي وكلاء ذكيون بتعليمات وأدوات خاصة ينفذون مهام معقدة. Skills هي مهارات متخصصة تُفعّل تلقائياً عند اكتشاف سياق مناسب — كلود يستدعيها بنفسه حسب الحاجة.
هل يمكنني مشاركة الإضافات مع فريقي؟
▼نعم، الإضافات عبارة عن ملفات يمكنك مشاركتها عبر Git أو أي طريقة أخرى. ضع الإضافة في مجلد .claude/plugins/ في مشروعك وكل أعضاء الفريق سيستخدمونها تلقائياً.
هل يمكنني تضمين MCP Servers في الإضافة؟
▼نعم، يمكنك تضمين إعدادات MCP Servers في ملف plugin.json أو في ملف .mcp.json منفصل داخل مجلد الإضافة. عند تفعيل الإضافة، كلود يتصل بالخوادم المحددة تلقائياً ويحصل على أدوات إضافية.