فريق وكلاء

الهدف

تفهم فكرة الوكلاء الفرعيين (Subagents) في كلود كود، تبني فريقًا بأدوار متخصصة، وتعرف متى يفيد الفريق ومتى يكفي وكيل واحد.

الشرح

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

الفوائد

• تخصص: كل وكيل تعليمات دقيقة لدوره.
• سياق نظيف: الباحث يقرأ ٥٠ ملفًا، والرئيسي يستلم الخلاصة فقط.
• توازٍ: عدة وكلاء يشتغلون في نفس الوقت.
• فصل المراجعة عن التنفيذ: المراجع ما شاف كيف كُتب الكود، فيحكم بحياد.

التعريف

ملف لكل وكيل في .claude/agents/:

---
name: reviewer
description: يراجع أي كود جديد قبل الدمج. يُستخدم بعد كل ميزة أو إصلاح.
tools: Read, Grep, Glob
---
أنت مراجع كود صارم. راجع التغييرات الأخيرة وابحث عن: أخطاء منطقية، ثغرات أمنية (خاصة المدخلات والمفاتيح)، حالات حدّية غير معالجة، ومخالفات لقواعد CLAUDE.md.
أعد تقريرًا مرتبًا بالخطورة: حرج / مهم / تحسين. لا تعدّل أي ملف.

لاحظ: المراجع عنده أدوات قراءة فقط. ما يقدر يعدّل. هذا مقصود.

فريق نموذجي لمشروع

كيف تستخدمهم؟

تطلب من كلود الرئيسي: «أضف ميزة [X]: استخدم researcher لفهم الجزء الحالي، ثم builder للتنفيذ، ثم tester، ثم reviewer، ولا تعتبرها منتهية حتى يوافق المراجع». يوزّع العمل ويجمع النتائج. وتقدر تطلب وكيلًا مباشرة: «خلّ reviewer يراجع آخر commit».

خارج البرمجة

نفس الفكرة لأي مهمة كبيرة: وكيل يجمع بيانات المنافسين، وكيل يحلّل، وكيل يكتب التقرير، وكيل يدقّق الأرقام. الوكيل الفرعي يُستخدم في كلود كود (ويشمل مهام الملفات والبحث وليس الكود فقط).

متى لا تحتاج فريقًا؟

المهام الصغيرة والمتوسطة: وكيل واحد أسرع. الفريق للمهام اللي فيها أدوار واضحة أو حجم كبير أو حاجة لمراجعة محايدة.

خطوة بخطوة

1. أنشئ .claude/agents/reviewer.md بأدوات قراءة فقط.
2. اطلب مراجعة لآخر تعديل، وقيّم التقرير.
3. أضف builder وtester بتعليمات واضحة.
4. نفّذ ميزة كاملة بالتسلسل: بحث ← بناء ← اختبار ← مراجعة.
5. احتفظ بالوكلاء في Git لفريقك.

برومبتات جاهزة

أنشئ فريق وكلاء فرعيين في .claude/agents/ لمشروعي: researcher (قراءة وبحث)، builder (تنفيذ)، tester (اختبارات)، reviewer (قراءة فقط، تقرير بالخطورة). اكتب لكل واحد وصفًا يحدد متى يُستخدم وتعليمات دقيقة لدوره، مع احترام قواعد CLAUDE.md. ثم نفّذ ميزة تجريبية صغيرة باستخدام الأربعة بالتسلسل.

نفّذ المهمة [X] بالتسلسل: researcher يفهم الوضع الحالي ويلخّصه، builder ينفّذ حسب الملخص، tester يكتب ويشغّل الاختبارات، reviewer يراجع. لا تعتبر المهمة منتهية حتى يقول reviewer إنه لا توجد ملاحظات حرجة. اعرض لي تقرير المراجع في النهاية.

أخطاء شائعة

• وكلاء بنفس التعليمات: بلا فائدة.
• إعطاء المراجع صلاحية تعديل: يفقد حياده.
• فريق لمهمة من ٥ دقائق.

تمرين

أنشئ وكيل reviewer واطلب مراجعة أداة الفواتير (الدرس ٢). طبّق ملاحظاته الحرجة. ثم أضف tester واطلب اختبارات لها.

الخلاصة

وكلاء فرعيون = نسخ متخصصة بسياق مستقل وأدوات محددة. ابدأ بالمراجع (قراءة فقط)، ثم باحث وبانٍ ومختبر. للمهام الكبيرة فقط.