# Orkestra: تنسيق وكلاء الذكاء الاصطناعي على نطاق واسع

Canonical source: https://maguyva.ai/ar/blog/orkestra-agent-orchestration

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Date: 2026-01-06 · Author: Maguyva Team

> يوجِّه منسِّق واحد العمل إلى وكلاء ذكاء اصطناعي متخصصين، لكل منهم مهارات وذاكرة مميزة. كيف ينسِّق Orkestra 46 وكيلًا و466 مهارة في الإنتاج.

> *تعكس الأرقام في هذا المنشور حالة النظام وقت النشر (يناير 2026). راجع [صفحة فريقنا](/ar/team) للأرقام الحالية.*

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

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

لذا بنينا Orkestra.

## ما هو Orkestra؟

Orkestra نظام تنسيق وكلاء لـClaude Code وأدوات البرمجة المماثلة بالذكاء الاصطناعي. ينسِّق وكلاء متخصصين متعددين، لكل منهم خبرة مميزة، تحت منسِّق واحد يوجِّه العمل إلى المتخصص الصحيح.

تخيَّله كوكالة توظيف لوكلاء الذكاء الاصطناعي. يتلقى المنسِّق مهمة، ويحدِّد أي متخصص ينبغي أن يتولاها، ويُفوِّض إليه بالسياق الصحيح. عندما ينتهي العمل، تتدفق النتائج مرة أخرى إلى المنسِّق للتوليف.

تحكي الأرقام القصة:

| المكوِّن | العدد |
|-----------|-------|
| الوكلاء المتخصصون | 46 |
| المهارات القابلة لإعادة الاستخدام | 466 |
| أنماط الهوية الأصلية | 27 |
| العقليات (Mindsets) | 11 |
| أساليب التواصل | 10 |
| مجالات المعرفة | 21 |

## نظام الشخصية: D&D للوكلاء

البصيرة الأساسية وراء Orkestra هي أن سلوك الوكيل ينبثق من ثلاثة عناصر أولية قابلة للتركيب:

**الهوية (Identity)** تُحدِّد *ماهية* الوكيل. المعماري (architect) يصمِّم بنى الأنظمة. مصحِّح الأخطاء (debugger) يتتبَّع الإخفاقات إلى أسبابها الجذرية. الحارس (guardian) يفرض الامتثال وحدود الأمان. لدينا 27 نمطًا أصليًا للهوية يمكن مزجها.

**العقلية (Mindset)** تُحدِّد *كيفية* تفكير الوكيل. العقلية التحليلية تُرسِّخ التأكيدات في الأدلة وتُقدِّر عدم اليقين كميًا. العقلية المتشكِّكة تُشكِّك في الافتراضات وتبحث عن أدلة نقض. العقلية الاستكشافية تتبنّى الغموض وتُجرِّب مناهج متعددة.

**الأسلوب (Style)** يُحدِّد *كيفية* تواصل الوكيل. الأسلوب التقني يتضمَّن قيمًا دقيقة ويشير إلى ملفات محدَّدة. الأسلوب الموجَز يحذف الحشو ويبدأ بالإجابة. الأسلوب الدبلوماسي يوازن بين الصراحة واللباقة.

يجمع الوكيل بين هذه العناصر الأولية:

```yaml
# architecture-advisor.yaml
identity:
  - knowledge-architect
  - architect
  - strategist
mindset: analytical
style: concise
```

هذا التركيب يُنشئ وكيلًا يصمِّم الأنظمة (architect)، ويربط المعرفة عبر المجالات (knowledge-architect)، ويضع التوجه الاستراتيجي (strategist)، ويفكِّر بالأدلة والبيانات (analytical)، ويتواصل دون حشو (concise).

القوة تكمن في الانفجار التوافقي. 27 هوية × 11 عقلية × 10 أساليب يُنتج نحو 3,000 شخصية وكيل ممكنة. لكنك تُعرِّف فقط التوليفات المهمة لعملك.

## المهارات: وحدات قدرة قابلة لإعادة الاستخدام

المهارات هي المعرفة وسير العمل التي يستطيع الوكلاء استدعاءها. تتبع نظامًا متدرِّجًا حسب النطاق:

| الطبقة | الاسم | النطاق | مثال |
|------|------|-------|---------|
| K0 | الأساسيات | منهجية عالمية | انضباط الاختبار أولًا، الإنجاز القائم على الأدلة |
| K1 | الهويات | سير عمل قائم على الدور | معايير واجهة سطر الأوامر، دليل الأداء |
| K2 | المجالات | معرفة خاصة بالمجال | أنماط ترحيل قواعد البيانات، التحقق من المصادقة |
| K3 | المكدسات (Stacks) | خاص بالتقنية | نشر Cloudflare، عمليات Supabase |
| K4 | المشروع | خاص بقاعدة الكود هذه فقط | سير عمل وأعراف خاصة بالمشروع |

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

تتضمن كل مهارة:
- شروط تفعيل واضحة ("استخدم عند ترحيل مخططات قاعدة البيانات")
- توجيهًا خطوة بخطوة
- الأدوات المسموح بها لسير العمل
- معايير النجاح ومسارات التعافي من الفشل

تُغطِّي الـ466 مهارة في سجلنا كل شيء من عزل شجرة عمل git إلى سير عمل البحث على الويب إلى التحقق من صحة النشر.

## لماذا يهم التنسيق

تصطدم بنى الوكيل الواحد بالجدران بسرعة:

**تشتت السياق.** نافذة سياق بـ200 ألف رمز تبدو كبيرة حتى تُحمِّل مخططات قواعد البيانات، وتوثيق API، وتجهيزات الاختبار، ومعرفة المجال. يستطيع المتخصصون العمل بسياق موجَّه.

**تعارضات التعليمات.** أن تطلب من وكيل "كن دقيقًا لكن سريعًا" و"تحقق من كل شيء لكن لا تُفرِط في الهندسة" يخلق توترًا. يحلّ المتخصصون هذا بامتلاك نطاق واضح.

**عمق الخبرة.** يعرف الوكيل العام القليل عن كل شيء. الوكيل المتخصص، المُركَّب بالهوية والمهارات الصحيحة، يعرف مجاله بعمق.

يُنفِّذ Orkestra تنسيقًا مسطَّحًا: منسِّق واحد ينسِّق متخصصين متعددين. لا يستطيع المتخصصون توليد متخصصين فرعيين. هذا يمنع انفجار التعقيد مع تمكين العمل المتوازي.

يمتلك المنسِّق وصولًا إلى سعة فعلية تبلغ 2.2 مليون رمز: نافذته الخاصة البالغة 200 ألف رمز بالإضافة إلى 10 وكلاء فرعيين متزامنين بـ200 ألف رمز لكل منهم. يُنجَز العمل الذي كان سيُنهك وكيلًا واحدًا بسهولة عند توزيعه على الأسطول.

## خط أنابيب التصيير

تعيش تعريفات الوكلاء في YAML. يقرأ Claude Code Markdown. يسدّ Orkestra هذه الفجوة بخط أنابيب تصيير حتمي:

```
YAML Registries → Jinja Templates → .claude/agents/*.md
```

يحرِّر المشغِّلون مصدر YAML. شغِّل `orkestra sync`. يظهر Markdown المُصيَّر في `.claude/agents/`. يلتقط Claude Code التغييرات.

يخدم هذا الفصل جمهورين مختلفين:
- **مصدر YAML** يتضمَّن بيانات وصفية لدورة الحياة، وعلامات، وقواعد تحقق، وملاحظات تقادم للأدوات
- **Markdown المُصيَّر** يتضمَّن فقط ما يحتاجه النموذج: الوصف، والأدوات، والمهارات، والتوجيه السلوكي

يُركِّب خط الأنابيب الهويات، والعقليات، والأساليب، والمهارات في مطالبة واحدة متماسكة. يحصل وكيل architect-analytical-concise على مطالبة نظام مختلفة تمامًا عن وكيل debugger-skeptical-technical، حتى إن تشاركا بعض المهارات الأساسية.

## معرفة المجال: نمط الملفات الأربعة

يتبع كل مجال معرفة بنية متسقة:

```
domain-name/
  decisions.md      # Key choices, rationale, consequences
  patterns.md       # Step-by-step guidance and examples
  anti-patterns.md  # Failure modes and remediation
  evolution.md      # Dated log of changes
```

تخدم هذه البنية تحميل سياق الوكيل. يُحمِّل وكيل يعمل على المصادقة `authentication/patterns.md` للتوجيه و`authentication/anti-patterns.md` لتجنّب المزالق المعروفة. الملفات مُحجَّمة لتحميل سياق كفء: مركَّزة بما يكفي لتكون مفيدة، وشاملة بما يكفي لتكون موثوقة.

نحافظ على 21 مجالًا رئيسيًا تتضمَّن التحليلات، والمصادقة، وعلوم البيانات، والبنية التحتية، والتعلم الآلي، والأداء، والأمان، وغيرها. يمكن أن يمتلك كل مجال مجالات فرعية لتفصيل أدق.

## القيم: نظام التشغيل

يتشارك جميع الوكلاء طبقة أساسية من القيم تُحدِّد كيفية عملهم:

**البساطة أولًا.** استخدم أبسط حل يعمل. أضِف تعقيدًا فقط عندما يكون مُبرَّرًا.

**أصلِح الأسباب الجذرية.** لا ترقِّع أبدًا حول الإخفاقات. إذا فشل خط أنابيب، صحِّح خط الأنابيب. إذا فشل اختبار، أصلِح الكود أو الاختبار.

**قائم على الأدلة.** صنِّف الادعاءات كـ"مُتحقَّق منها" (بمعايير قياسية) أو "مُقدَّرة" (بافتراضات). اكتشاف نمط لا يساوي تأكيد مشكلة.

**اقتصاديات السياق.** تكلِّف أدوات MCP 0.1% من السياق. تكلِّف قراءات الملفات 2% لكل واحدة. طبِّق خبرة المجال قبل استكشاف الكود.

تنتشر هذه القيم إلى كل متخصص عبر خط أنابيب التصيير. لا يستطيع وكيل تجاوزها بالتركيب.

## سطر الأوامر: مستوى التحكّم

يأتي Orkestra مع سطر أوامر لإدارة نظام الوكلاء البيئي:

```bash
# Discovery
orkestra agents search "database"
orkestra agents info database-architect

# Validation
orkestra validate --show-warnings

# Rendering
orkestra sync --dry-run
orkestra sync

# Skills
orkestra skills list
orkestra skills info schema-migration-workflow

# Decisions
orkestra decisions search "authentication"
```

سطر الأوامر هو مصدر الحقيقة للوكلاء المتاحين، والمهارات التي يمتلكونها، وما إذا كان النظام سليمًا. يُشغِّل التحقق قبل المزامنة لاكتشاف المشكلات مبكرًا.

## اعتبارات المصدر المفتوح

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

يُطبَّق نظام تركيب الشخصية (الهوية + العقلية + الأسلوب) على أي فريق يُعرِّف شخصيات الوكلاء.

يوفِّر نظام طبقات المهارات (K0-K4) نموذجًا ذهنيًا لتنظيم القدرات القابلة لإعادة الاستخدام حسب النطاق.

يفصل نمط خط أنابيب التصيير (مصدر YAML + قوالب + نواتج مُولَّدة) الاهتمامات بين الأدوات واستهلاك النموذج.

يتجنب نموذج التنسيق المسطَّح (منسِّق واحد، متخصصون كثيرون) التعقيد مع تمكين التوازي.

ما إذا كان Orkestra سيصبح مفتوح المصدر يعتمد على ما إذا كانت هذه الأنماط ذات قيمة لآخرين يبنون باستخدام Claude Code. إذا كنت تصطدم بالجدران التي وصفناها، فقد تساعدك هذه البنية.

## ما تعلمناه

علَّمنا بناء Orkestra أن التنسيق لا يدور حول جعل الوكلاء أذكى. إنه يدور حول جعلهم أكثر تركيزًا.

وكيل واحد بتعليمات مثالية لا يزال ينفد سياقه. وكيل واحد بكل المهارات لا يزال يرتبك بشأن أيها يُطبِّق. وكيل واحد يحاول أن يكون كل شيء يُنتج نتائج متوسطة في كل مكان.

أربعون متخصصًا، كل منهم ممتاز في مجاله، ينسِّقهم منسِّق يعرف متى يُفوِّض: هكذا نُنجز العمل ونُطلقه.

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

---

*يُشغِّل Orkestra نظام الوكلاء البيئي خلف Maguyva، منصة ذكاء الكود لدينا. تريد معرفة المزيد؟ تواصل مع الفريق.*