Claude Code: الوكلاء الفرعيون
آخر تحديث: 2026-08-31
الوكلاء الفرعيون يحولون Claude Code إلى "مدير فريق" — الوكيل الرئيسي يفكك المهام، والوكلاء الفرعيون ينفذون بالتوازي، الكفاءة تتضاعف.
💡 نصيحة: الوكلاء الفرعيون ليسوا نسخاً متعددة من Claude Code، بل آلية تنفيذ متوازية داخل جلسة واحدة. الوكيل الرئيسي يخطط وينسق؛ الوكلاء الفرعيون ينفذون.
📋 المتطلبات المسبقة: الفصل 12 - MCP
1. ما ستتعلمه
- كيف يعمل الوكلاء الفرعيون
- متى تستخدم وكلاء فرعيين
- تنفيذ المهام المتوازية
- أنماط التعاون بين الوكلاء
- الجدولة وإدارة الموارد
2. مبادئ عمل الوكلاء الفرعيين
(1) نموذج البنية
graph TB
M[Main Agent<br/>Plan+Coordinate] --> S1[Sub-agent 1<br/>Frontend refactor]
M --> S2[Sub-agent 2<br/>Backend API]
M --> S3[Sub-agent 3<br/>Test writing]
S1 --> R[Result Aggregation]
S2 --> R
S3 --> R
(2) سير التنفيذ
TEXT
📖 للعرض فقط
1. User gives complex task
2. Main agent decomposes into independent sub-tasks
3. Creates sub-agent for each sub-task
4. Sub-agents execute in parallel (independent contexts)
5. Main agent aggregates all sub-agent results
6. Checks consistency, handles conflicts
7. Outputs final result
▶ مثال 1: تفعيل تلقائي للوكلاء الفرعيين
TEXT
📖 للعرض فقط
> Add complete user management module: data model, API, frontend, tests
Claude Code (Main Agent):
Task decomposition:
- Sub-task 1: Create data model (User model + migration)
- Sub-task 2: Create API endpoints (CRUD)
- Sub-task 3: Create frontend pages
- Sub-task 4: Write tests
[4 sub-agents launch in parallel]
Sub-agent 1: ✅ Data model created
Sub-agent 2: ✅ API endpoints created
Sub-agent 3: ✅ Frontend pages created
Sub-agent 4: ✅ Tests written
Main Agent: Aggregating, checking consistency...
→ Found API format mismatch with frontend expectations
→ Auto-correcting frontend API calls
→ Running full tests
✅ All 24 tests passed
3. متى تستخدم وكلاء فرعيين
| السيناريو | مناسب؟ | السبب |
|---|---|---|
| تعديلات متعددة الملفات مستقلة | ✅ نعم | الملفات لا تؤثر على بعضها |
| تطوير واجهة+خلفية متوازي | ✅ نعم | حزم تقنية مستقلة |
| كتابة اختبارات دفعية | ✅ نعم | كل ملف اختبار مستقل |
| إعادة هيكلة عميقة لملف واحد | ❌ لا | لا حاجة للتتوازي |
| مهام متسلسلة مترابطة | ❌ لا | لا يمكن التوازي |
| تعديلات صغيرة | ❌ لا | التكلفة > الفائدة |
4. تنفيذ المهام المتوازية
▶ مثال 2: إصلاح أخطاء متوازي
TEXT
📖 للعرض فقط
> Fix these bugs in parallel:
> 1. src/auth/jwt.ts: token refresh logic error
> 2. src/utils/date.ts: timezone handling issue
> 3. src/api/orders.ts: missing pagination validation
> 4. src/services/payment.ts: amount precision issue
Claude Code launches 4 sub-agents:
Sub-agent 1 [jwt.ts] → ✅ Fixed (2min)
Sub-agent 2 [date.ts] → ✅ Fixed (3min)
Sub-agent 3 [orders.ts] → ✅ Fixed (1min)
Sub-agent 4 [payment.ts] → ✅ Fixed (4min)
Total: 4min (serial would need 10min)
Savings: 60%
5. التعاون بين الوكلاء
| النمط | الوصف | حالة الاستخدام |
|---|---|---|
| مستقل بالكامل | لا تفاعل بين الوكلاء الفرعيين | مهام مستقلة دفعية |
| اتفاقيات مشتركة | مشاركة CLAUDE.md وأسلوب الكود | معايير فريق متسقة |
| تكامل النتائج | الوكيل الرئيسي يدمج نتائج الوكلاء الفرعيين | يحتاج فحص تناسق |
| تعاون تكراري | مخرجات وكيل فرعي تغذي آخر | توجد تبعيات |
6. اعتبارات الموارد
| البُعد | وكيل واحد | 4 وكلاء فرعيين |
|---|---|---|
| استدعاءات API | تسلسلية | متوازية |
| استهلاك Token | 100K | 4 × 30K = 120K |
| الوقت | 10 دقائق | 3 دقائق |
| التكلفة | $2.00 | $2.40 |
❓ أسئلة شائعة
س هل الوكلاء الفرعيون يتفعلون تلقائياً؟
ج نعم. يكتشف Claude Code تلقائياً متى يمكن توازي المهام. يمكنك أيضاً طلب التوازي صراحةً.
س هل يوجد حد للوكلاء الفرعيين؟
ج لا حد صارم، لكن كل واحد يستهلك سياقاً مستقلاً واستدعاءات API. يُوصى بأقصى 5-6 متوازية لتجنب استهلاك مفرط للموارد.
س هل يمكن للوكلاء الفرعيين التواصل؟
ج ليس مباشرة. ينسقون عبر الوكيل الرئيسي — الذي يوزع المهام ويجمع النتائج ويعالج التعارضات.
س هل التنفيذات المتوازية تتعارض؟
ج ربما عند تعديل نفس الملف. الوكيل الرئيسي يكتشف ويحل التعارضات؛ يُوصى بجعل المهام المتوازية تعمل على ملفات مختلفة.
س هل الوكلاء الفرعيون أكلف؟
ج أكثر قليلاً (~10-20% Token إضافية)، لكن وفورات الوقت كبيرة (50-70%). يُوصى بها للسيناريوهات الحساسة للوقت.
📖 ملخص
- الوكلاء الفرعيون آلية تنفيذ متوازية داخلية لـ Claude Code
- الوكيل الرئيسي يفكك، الوكلاء الفرعيون ينفذون بالتوازي، الوكيل الرئيسي يجمع
- الأفضل لتعديلات متعددة الملفات المستقلة، العمليات الدفعية، تطوير واجهة+خلفية متوازي
- غير مناسب للمهام المتسلسلة أو التعديلات البسيطة
- التوازي يوفر الوقت لكن يزيد التكلفة قليلاً؛ احذر التعارضات
📝 تمارين
- أساسي (⭐): أعطِ Claude Code مهمة قابلة للتتوازي، راقب التفعيل التلقائي للوكلاء الفرعيين.
- متوسط (⭐⭐): صمم سيناريو بـ 4 وحدات مستقلة، قارن الوقت التسلسلي مقابل المتوازي.
- متقدم (⭐⭐⭐): حلل استهلاك Token وتكلفة الوكلاء الفرعيين، حدد متى يكون التوازي مجدياً.