كيفية تثبيت أكثر من 300 متخصص ذكاء اصطناعي في كود كلود وكيرسور

باختصار: تُعدّ agency-agents أكبر مجموعة منسّقة لشخصيات وكلاء الذكاء الاصطناعي على GitHub، وقد بلغت 149,312 نجمة في 1 سبتمبر 2026. يضم المشروع أكثر من 300 ملف تعريف موزعة على نحو 20 مجلدًا، ويمكن تثبيتها في Claude Code وCursor وCodex وGemini CLI وOpenCode وWindsurf وAider وغيرها بأمر واحد. هذه الشخصيات تغيّر طريقة تعامل الوكيل مع المهمة، لكنها لا تضيف إليه معرفة جديدة ولا تستمر بعد انتهاء الجلسة.

جرّب Apidog اليوم

هذا تعمّق في أداة واحدة من مجموعة خمس أدوات وكلاء ذكاء اصطناعي مفتوحة المصدر تستحق التثبيت في عام 2026.

ما الذي تثبّته فعليًا؟

كل وكيل عبارة عن ملف Markdown، وليس مكوّنًا إضافيًا أو سطرًا واحدًا في موجه النظام. يحتوي الملف الجيد على:

• هوية وصوت.
• مهمة أساسية.
• عملية عمل محددة.
• مخرجات تقنية مع أمثلة.
• معايير واضحة للنجاح.

بحساب ملفات Markdown في شجرة المستودع في 1 سبتمبر 2026، يوجد 312 ملفًا في 20 مجلدًا تصنيفيًا رئيسيًا، أو 306 ملفات عند استبعاد examples/:

القسم	ملفات الوكلاء
هندسة برمجيات	59
متخصص	58
تسويق	36
تطوير الألعاب	21
تكاملات	18
استراتيجية	16
نظم المعلومات الجغرافية	13
أمان	12
تصميم	10
مبيعات	9
اختبار	9
إعلام مدفوع	7
إدارة المشاريع	7
أكاديمي	6
الحوسبة المكانية	6
دعم فني	6
مالية	5
منتج	5
رعاية صحية	3

لا يزال ملف README يذكر «أكثر من 230 وكيلًا»، لكن هذا الوصف قديم؛ فقد تجاوزت الشجرة 300 وكيل.

سيبدأ معظم المطورين من قسم هندسة البرمجيات. وإلى جانب «مطور الواجهة الأمامية» و«مهندس الواجهة الخلفية»، ستجد وكلاء متخصصين في:

• Cisco IOS-XE وJuniper Junos وPalo Alto PAN-OS.
• ESP32 وSTM32 وشرائح Nordic.
• الاستجابة للحوادث والتحقيقات اللاحقة.
• تأهيل قواعد البيانات للقراءة فقط، مع تسجيل الحقائق بدل اقتراح التغييرات.

الوكيل الأخير مثال مهم: إضافة تفويض صريح بعدم التعديل تجعل الشخصية مختلفة فعليًا عن الوكيل العام، ولا تتطلب سوى ملف واحد.

ثبّت ما تحتاجه فقط

يوفّر المستودع نصوصًا للتحويل والتثبيت. يكتشف المثبّت التفاعلي ما هو موجود ويسألك عمّا تريد تثبيته:

git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents
./scripts/install.sh

لكن الاستهداف الصريح لأداة وأقسام محددة هو الخيار الأفضل:

# كل شيء في Claude Code
./scripts/install.sh --tool claude-code

# قسمان فقط
./scripts/install.sh --tool claude-code --division engineering,security

# وكلاء محددون بالاسم
./scripts/install.sh --tool cursor --agent frontend-developer,ui-designer

# افحص المحتوى قبل التثبيت
./scripts/install.sh --list teams
./scripts/install.sh --tool opencode --division engineering --dry-run

الأدوات المدعومة تشمل:

• Claude Code
• Cursor
• Codex
• Gemini CLI
• OpenCode
• GitHub Copilot
• Windsurf
• Aider
• Kimi Code
• Hermes
• Antigravity
• Osaurus
• Mistral Vibe

يتوفر أيضًا تطبيق سطح مكتب في agencyagents.app لأنظمة macOS وLinux وWindows، مع تصفح وتثبيت بنقرة واحدة وتحديث تلقائي، إضافة إلى Homebrew cask.

انتبه إلى حد OpenCode

يسجل OpenCode حاليًا نحو 119 وكيلًا فقط، ويتجاهل الباقي بصمت. يوثّق المستودع هذا القيد باعتباره خطأ في الإصدار الأعلى. استخدم --division للبقاء تحت الحد؛ كما يحذّرك المثبّت عندما يتجاوز اختيارك السعة.

التثبيت الصامت لعدد أقل من الوكلاء هو أسوأ سيناريو: قد يختفي الوكيل الذي تحتاجه من دون أي رسالة خطأ.

ولا يُنصح بتثبيت 300 شخصية حتى في الأدوات الأخرى. ثبّت القسم المرتبط بعملك، واقرأ أربعة أو خمسة ملفات، ثم احذف ما لا يطابق طريقة عمل فريقك.

ما الذي تغيّره الشخصية؟

الشخصية إطار عمل يحدد:

• ما الذي يبحث عنه الوكيل.
• شكل الإجابة أو المخرجات.
• متى يعتبر المهمة مكتملة.

كثير من المخرجات الضعيفة لا تنتج عن ضعف النموذج، بل عن تحسينه للشكل الخطأ من الإجابة. فطلب مراجعة تدفق مصادقة من وكيل عام يعطي نصيحة معقولة، بينما يعطي مراجع أمني مزود بنموذج تهديد وقائمة تحقق نتائج قابلة للتنفيذ.

لكن الشخصية لا تمنح الوكيل حقائق لا يملكها.

إذا طلبت من «مهندس الواجهة الخلفية» كتابة عميل لخدمة الفوترة الداخلية، فقد ينتج رمزًا نظيفًا لكنه يفترض شكل استجابة غير موجود. لن يعرف أن خدمتك:

• تعيد 409 عند تكرار مفتاح الاستمرارية.
• تستخدم غلاف خطأ مختلفًا.
• توفر مؤشر ترقيم معتمًا بدل الإزاحة.

الشخصية حسّنت تنظيم الرمز، لكنها لم تجعله صحيحًا.

وينطبق الأمر نفسه على الاختبار. قد تكتب شخصية ضمان الجودة اختبارات شاملة وفق تصورها لواجهة API، فتنجح الاختبارات من دون أن تثبت توافقها مع الواجهة الحقيقية. راجع:

• اختبار وكلاء الذكاء الاصطناعي غير الحتميين
• ما يحدث عندما تؤدي تغييرات واجهة برمجة التطبيقات إلى تعطيل وكلاء الذكاء الاصطناعي

الشخصية تحدد السلوك، والمواصفات تحدد الحقيقة

الحل هو إعطاء الوكيل عقودًا حقيقية بدل الاعتماد على الشخصية وحدها.

إذا صممت API باستخدام Apidog، تصبح مواصفة OpenAPI مصدر الحقيقة، بما تتضمنه من:

• مخططات فعلية.
• رموز حالة فعلية.
• أغلفة أخطاء فعلية.
• سلوك ترقيم فعلي.

يقرأ الوكيل هذه المواصفة بدل إعادة بناء الواجهة من مواقع الاستدعاء. كما تُنشأ المحاكيات من المواصفة نفسها، بما في ذلك فروع الأخطاء التي قد لا يفكر الوكيل في اختبارها. وعندما يختلف التنفيذ عن المواصفة، يفشل اختبار العقد بصوت واضح داخل CI.

هذا هو النموذج الذهني المفيد:

الشخصية تحدد كيف يعمل الوكيل.

المواصفات تحدد ما هو صحيح.

قراءة ذات صلة:

• استخدام مواصفات OpenAPI كأدوات للوكيل
• تصميم مخططات أدوات API للوكلاء

ولربط مواصفة حية بسياق وكيلك، نزّل Apidog ووجّهه إلى مشروعك الحالي.

الحد الثاني: الشخصية ليست فريقًا

توحي مكتبة الشخصيات بأنك تملك وكالة كاملة، لكن الواقع مختلف:

• تنشّط شخصية واحدة في جلسة واحدة.
• تنفذ مهمة.
• تنتهي الجلسة.
• تعيد كتابة التنشيط في اليوم التالي.

لا يوجد تعيين أو سجل دائم أو مساحة يستطيع الزملاء مراجعتها. تسعة أقسام من المستودع تصف أدوارًا لا معنى لها إلا داخل منظمة، بينما أداة التثبيت نفسها لا تعرف مفهوم المنظمة.

إذا أردت أن تستمر الشخصية بعد جلسة طرفية واحدة، فأنت تحتاج إلى طبقة لإدارة العمل. هذا هو دور Sharkly:

• الوكيل: تكوين محفوظ يتضمن التعليمات، وبيئة التشغيل، والمهارات، والمستودعات، والبيئة. لا تعيد كتابة الشخصية في كل مرة.
• الطاقم (Crew): قائد مع وكلاء وأشخاص آخرين. يقرأ القائد سياق المهمة، يختار المشاركين، ثم يجمع النتائج في مكان واحد.
• تعيين العمل: تعطي المهمة لوكيل كما تعطيها لزميل، داخل مساحة ومشروع وسير عمل، مع مزامنة Jira عند الحاجة.
• أحضر ما تملكه: صِل جهاز كمبيوتر، مثل حاسوبك المحمول أو خادم أو حاوية، ويستخدم Sharkly بيئة التشغيل الموجودة عليه. يعمل اشتراكك في Claude Code أو Codex؛ لا توجد إعادة بيع للرموز.
• نتائج قابلة للمراجعة: يظهر التقدم واستدعاءات الأدوات والنتائج داخل المهمة، ويصل إخراج الوكيل كتعليقات يمكن الرد عليها. إضافة المهمة إلى Backlog لا تبدأ تشغيلًا تلقائيًا.

الخلاصة: تمنحك agency-agents الوصف الوظيفي، بينما يمنحك Sharkly المكان الذي تُعيّن فيه هذه الوظائف وتُشغّل وتُراجع. استخدم المستودع كمكتبة لتعريف الأدوار، لا كمجلد تثبته ثم تنساه.

اكتب شخصيتك الخاصة باستخدام القالب

أكثر ما يستحق الاحتفاظ به في المستودع هو التنسيق. بعد قراءة عدة ملفات، يمكنك كتابة شخصية مناسبة لفريقك خلال نحو 15 دقيقة، وغالبًا ستكون النسخة الداخلية أكثر فائدة من النسخة العامة.

استخدم هذا الهيكل:

1. الهوية والصوت: من هو الوكيل وكيف يتحدث.
2. المهمة الأساسية: جملة واحدة تصف معنى النجاح.
3. عملية العمل: خطوات مرتبة يتبعها الوكيل.
4. المخرجات: القطع المطلوبة وتنسيقها.
5. معايير النجاح: كيف يعرف الوكيل أنه انتهى.

قسم العملية هو الأهم. شخصية مراجعة تتبع سبع خطوات محددة تنتج نتائج متسقة، بينما الشخصية التي لا تملك عملية واضحة تعتمد على ما يراه النموذج مناسبًا في تلك الجلسة.

مثال: مراجع عقود API

# مراجع عقود API

## المهمة
التحقق من أن نقاط النهاية الجديدة أو المتغيرة تتطابق مع مواصفات OpenAPI في هذا
المستودع قبل أن تصل إلى المراجعة. الإبلاغ عن عدم التطابق. عدم تحرير الكود.

## العملية
1. قراءة المواصفات لكل نقطة نهاية تم لمسها بواسطة التغيير الحالي (diff).
2. لكل منها، مقارنة المعالج بالمواصفات: رموز الحالة،
   مخطط الاستجابة، مغلف الخطأ، الرؤوس المطلوبة، نمط الترقيم.
3. تشغيل اختبارات العقد. تسجيل الفشل حرفيًا.
4. التحقق من إضافة نقاط النهاية الجديدة إلى المواصفات، وليس فقط إلى الموجه.
5. الإشارة إلى أي حقل استجابة موجود في الكود وغير موجود في المواصفات.

## المخرجات
جدول: نقطة النهاية، الطريقة، نوع عدم التطابق، سطر المواصفات، سطر الكود، الخطورة.
لا يوجد ملخص نصي. لا يوجد إصلاحات مقترحة إلا إذا طُلب ذلك.

## الانتهاء عند
ظهور كل نقطة نهاية في التغيير (diff) في الجدول مع حكم، و
تضمين مخرجات اختبار العقد كدليل.

هذا الملف القصير أكثر فائدة لفريق الواجهة الخلفية من شخصية عامة، لأنه يحدد مواصفاتك واختباراتك وتعريفك للانتهاء. كما أن توجيه الوكيل إلى إنتاج دليل، لا رأي، يجعل النتيجة قابلة للتنفيذ.

ينجح الأسلوب نفسه مع:

• الاستجابة للحوادث.
• أعمال الترحيل.
• ترقيات التبعيات.
• تأهيل المطورين.
• تسليم المهام بين الوكلاء.

عندما يجب أن يستمر إخراج الوكيل بعد تسليمه إلى إنسان أو وكيل آخر، يصبح عقد التنسيق أساسيًا. راجع تسليم الوكيل وتمرير السياق.

هل عدد النجوم مهم؟

149,312 نجمة رقم كبير، لكنه ليس دليلًا على الاستخدام المستمر. تحصل مستودعات الشخصيات على النجوم بسرعة لأنها سهلة الفهم والمشاركة، وتجربتها مجانية. النجمة تعني أن شخصًا رأى فكرة جيدة، لا أنه ما زال يستخدمها.

ما يمنح هذا المستودع مصداقية أكبر هو شكل العمل:

• تاريخ مساهمات حقيقي منذ أكتوبر 2025.
• ترخيص MIT.
• توثيق حد OpenCode والقيود الأخرى.
• ملفات تحتوي على محتوى متخصص، لا موجهات عامة معاد تدويرها.

افتح ثلاثة ملفات في قسم تعرفه جيدًا. إذا كان ملف «مطور الواجهة الأمامية» يتضمن ما يتوقعه مطور واجهة أمامية جيد، فهذه إشارة إيجابية. أما إذا بدا كإعلان وظيفي، فتجاوز المستودع.

طريقة عملية للحصول على قيمة حقيقية

اتبع هذا المسار:

1. ثبّت قسمًا واحدًا: اختر القسم الذي يرتبط بعملك اليومي؛ غالبًا سيكون الهندسة.
2. اقرأ الملفات: اقرأ أربعة أو خمسة ملفات كاملة، وركّز على خطوات العملية.
3. عدّلها: أضف المكدس التقني، والاتفاقيات، وتعريف فريقك للانتهاء.
4. استخدم مدخلات حقيقية: أعطِ المراجع الأمني مواصفات OpenAPI الفعلية بدل الاكتفاء بقائمة تحقق عامة.
5. حوّل الشخصيات المتكررة إلى وكلاء دائمين: الشخصية التي تستخدمها مرتين أسبوعيًا يجب حفظها في نظام إدارة العمل بدل نسخها بين الأجهزة.

هنا تحديدًا تقرر الفرق ما إذا كانت الفكرة ستتوسع أم ستُترك تدريجيًا.

الأسئلة الشائعة

هل يعمل agency-agents مع Cursor وCodex أم مع Claude Code فقط؟

يعمل مع كل هذه الأدوات. ينشئ convert.sh ملفات التكامل الخاصة بكل أداة، بينما يستهدف install.sh --tool أداة محددة. تشمل الأدوات المدعومة Claude Code وCursor وCodex وGemini CLI وOpenCode وCopilot وWindsurf وAider وKimi Code وغيرها.

ولمقارنة أدوات العمل مع API، راجع نظرتنا على عملاء API في Cursor وCopilot.

هل يجب تثبيت الوكلاء الـ300 جميعًا؟

لا. يسجل OpenCode نحو 119 وكيلًا فقط ويتجاهل الباقي بصمت. وحتى في الأدوات الأخرى، لن تستخدم معظم الشخصيات. ثبّت حسب القسم باستخدام --division.

هل تجعل الشخصيات الوكيل أذكى؟

تجعله موجّهًا بصورة أفضل، لكنها لا تزيد دقته في الحقائق. لمعرفة ما تعيده API الخاصة بك، يحتاج الوكيل إلى مواصفات حقيقية. اقرأ أيضًا: هل ما زلت بحاجة إلى أداة API في عصر وكلاء الذكاء الاصطناعي؟.

هل تشغيل نص التثبيت آمن؟

يكتب النص ملفات تعريف الوكلاء في أدلة إعداد الأداة، وهذا هو الغرض منه. المستودع مفتوح المصدر ومرخص MIT، ويعرض الخيار --dry-run ما سيحدث قبل الكتابة. ابدأ بالتجربة الجافة، ثم راجع مبادئ حواجز أمان وكلاء الذكاء الاصطناعي.

ما الفرق بينه وبين إطار عمل الوكلاء؟

إذا أردت تشغيل الشخصيات عدة مرات بالتوازي بدل تشغيل شخصية واحدة في كل جلسة، فراجع Orca.

أما إطار مثل Strands أو AgentKit فيوفر تنسيق وقت التشغيل داخل الكود. يمنحك agency-agents ملفات Markdown تغيّر سلوك وكيل موجود. إنها طبقات مختلفة وليست بدائل مباشرة.

الخلاصة

agency-agents تطبيق ممتاز لفكرة محددة: يعمل الوكيل بصورة أفضل عندما يعرف الدور الذي يؤديه. ثبّت قسمًا واحدًا، اقرأ الملفات، وعدّلها لتناسب فريقك، وستحصل على قيمة حقيقية خلال نحو 20 دقيقة.

لكن لا تتوقع أن تحل الشخصيات مشكلتين مختلفتين:

1. لا تعرف ما الذي تعيده API الخاصة بك؛ لذلك تحتاج إلى مواصفات مصدر حقيقة مثل Apidog.
2. لا توفر استمرارية أو تعيينًا أو مراجعة مشتركة؛ لذلك تحتاج إلى طبقة إدارة عمل مثل Sharkly.

المكتبة بداية جيدة. لكنها ليست منظمة، وليست مصدرًا للحقيقة.