Claude Code: الوكلاء الفرعيون

آخر تحديث: 2026-08-31

الوكلاء الفرعيون يحولون Claude Code إلى "مدير فريق" — الوكيل الرئيسي يفكك المهام، والوكلاء الفرعيون ينفذون بالتوازي، الكفاءة تتضاعف.

💡 نصيحة: الوكلاء الفرعيون ليسوا نسخاً متعددة من Claude Code، بل آلية تنفيذ متوازية داخل جلسة واحدة. الوكيل الرئيسي يخطط وينسق؛ الوكلاء الفرعيون ينفذون.

📋 المتطلبات المسبقة: الفصل 12 - MCP

1. ما ستتعلمه


2. مبادئ عمل الوكلاء الفرعيين

(1) نموذج البنية

100%
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%). يُوصى بها للسيناريوهات الحساسة للوقت.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): أعطِ Claude Code مهمة قابلة للتتوازي، راقب التفعيل التلقائي للوكلاء الفرعيين.
  2. متوسط (⭐⭐): صمم سيناريو بـ 4 وحدات مستقلة، قارن الوقت التسلسلي مقابل المتوازي.
  3. متقدم (⭐⭐⭐): حلل استهلاك Token وتكلفة الوكلاء الفرعيين، حدد متى يكون التوازي مجدياً.
Web-Tutorial.com

فريق Web-Tutorial التقني

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

100%