كلود كود يفتتح وضع الفريق! يجب أن تستخدم فرق الوكيل!

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

أنا "استخدمها أولاً"! (ممتع جدًا! ممتع جدًا! ممتع جدًا!)

شروط تشغيل فرق الوكيل:  
1. تحديث كلود كود إلى أحدث إصدار (claude update)  

2. في settings.json أضف سطرًا:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 

3. أعد تشغيل كلود كود～  

4. ثم استخدم اللغة الطبيعية مباشرة لجعل كلود كود ينشئ فرق وكيل (بالطبع، اشرح ما يجب على فرق الوكيل فعله)  

بالإضافة إلى ذلك، النماذج الأخرى لا تؤثر على عمل فرق الوكيل (أستخدم KIMi for coding)

لمزيد من المعلومات حول فرق الوكيل، راجع النص التالي (مكتوب من قبل Anthropic رسميًا)!

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

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

يغطي هذا المستند:

• • متى تستخدم فرق الوكيل، بما في ذلك أفضل حالات الاستخدام والمقارنة مع الوكلاء الفرعيين

• • بدء الفريق

• • التحكم بالأعضاء، بما في ذلك أوضاع العرض، توزيع المهام والتفويض

• • أفضل الممارسات للعمل المتوازي

متى تستخدم فرق الوكيل

فرق الوكيل أكثر فعالية في المهام حيث يمكن للاستكشاف المتوازي أن يضيف قيمة حقيقية. أقوى حالات الاستخدام تشمل:

• • البحث والمراجعة —— يمكن لأعضاء متعددين التحقيق في جوانب مختلفة للمشكلة في نفس الوقت، ثم مشاركة وتحدي اكتشافات بعضهم البعض

• • وحدات أو ميزات جديدة —— يمكن للأعضاء امتلاك أجزاء مستقلة، دون تداخل

• • تصحيح الأخطاء بفرضيات متنافسة —— يمكن للأعضاء اختبار نظريات مختلفة بالتوازي، والعثور على الإجابة بشكل أسرع

• • التنسيق عبر الطبقات —— التغييرات عبر الواجهة الأمامية، الخلفية والاختبار، كل منها مسؤول عنه عضو مختلف

فرق الوكيل تزيد من تكاليف التنسيق (هل تجرؤ على استخدام Opus4.6 لفتح فرق الوكيل🤣)، وتستهلك رموزًا بشكل أكبر مقارنة بجلسة واحدة. تكون أكثر فعالية عندما يمكن للفرق العمل بشكل مستقل. للمهام المتسلسلة، أو تحرير نفس الملف، أو العمل مع العديد من التبعيات، الجلسة الفردية أو الوكيل الفرعي أكثر فعالية.

المقارنة مع الوكلاء الفرعيين

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

الوكلاء الفرعيون

فرق الوكيل

السياق

نافذة السياق الخاصة بهم؛ النتائج تُعاد إلى المنشئ

نافذة السياق الخاصة بهم؛ مستقلون تمامًا

الاتصال

يبلغون فقط الوكيل الرئيسي بالنتائج

يمكن للأعضاء إرسال رسائل مباشرة لبعضهم البعض

التنسيق

الوكيل الرئيسي يدير كل العمل

قائمة المهام المشتركة، تنسيق ذاتي

الأكثر ملاءمة

مهام مركزة حيث تهتم فقط بالنتائج

العمل المعقد الذي يحتاج إلى مناقشة وتعاون

تكلفة الرموز

أقل: النتائج تُجمع مرة أخرى إلى السياق الرئيسي

أعلى: كل عضو هو مثيل مستقل من كلود

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

تمكين فرق الوكيل

فرق الوكيل معطلة افتراضيًا. قم بتمكينها عن طريق تعيين متغير البيئة  CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS إلى  1 ، يمكن في بيئة shell أو عبر settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

بدء أول فريق وكيل لك

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

هذا المثال يعمل جيدًا، لأن الأدوار الثلاثة مستقلة، ويمكنها استكشاف المشكلة دون انتظار بعضها البعض:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(إنشاء فريق وكيل لاستكشاف هذا من زوايا مختلفة: عضو واحد مسؤول عن تجربة المستخدم، وآخر عن الهندسة التقنية، وثالث يلعب دور المحامي الشيطان.)

من هناك، ينشئ كلود فريقًا مع قائمة مهام مشتركة، ويولد أعضاء لكل منظور، ويدعهم يستكشفون المشكلة، ويجمع النتائج، ويحاول تنظيف الفريق بعد الانتهاء.

محطة الرئيس تسرد جميع الأعضاء ومحتوى عملهم. استخدم Shift+Up/Down لاختيار الأعضاء وإرسال رسائل مباشرة لهم.

التحكم بفريق الوكيل الخاص بك

استخدم اللغة الطبيعية لإخبار الرئيس بما تريد. يقوم بمعالجة تنسيق الفريق، وتوزيع المهام، والتفويض بناءً على تعليماتك.

اختيار وضع العرض

فرق الوكيل تدعم وضعي عرض:

• • الوضع داخل العملية —— جميع الأعضاء يعملون داخل محطتك الرئيسية. استخدم Shift+Up/Down لاختيار الأعضاء وإدخال الرسائل مباشرة. مناسب لأي محطة، لا يحتاج إلى إعداد إضافي.

• • وضع تقسيم الشاشة —— لكل عضو نافذته الخاصة. يمكنك رؤية إخراج الجميع في نفس الوقت، وانقر على النافذة للتفاعل المباشر. يتطلب tmux أو iTerm2.

الافتراضي هو "auto"، إذا كنت تعمل في جلسة tmux، يستخدم تقسيم الشاشة، وإلا يستخدم الوضع داخل العملية.

لإجبار الوضع داخل العملية لجلسة فردية، مرر العلم:

claude --teammate-mode in-process

تحديد الأعضاء والنماذج

يقرر كلود بناءً على مهامك عدد الأعضاء لتوليدهم، أو يمكنك تحديد ما تريد بدقة:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(إنشاء فريق مكون من 4 أعضاء لإعادة هيكلة هذه الوحدات بالتوازي. استخدم Sonnet لكل عضو.)

طلب موافقة الأعضاء على الخطط

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

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(توليد عضو مهندس لإعادة هيكلة وحدة المصادقة. اطلب موافقة على الخطة قبل إجراء أي تغييرات.)

عندما يكمل العضو التخطيط، يرسل طلب موافقة على ا��خطة إلى الرئيس. يراجع الرئيس الخطة ويوافق أو يرفض ويقدم ملاحظات.

استخدام وضع التفويض

بدون وضع التفويض، يبدأ الرئيس أحيانًا في تنفيذ المهام بنفسه، بدلاً من انتظار الأعضاء للانتهاء. يمنع وضع التفويض هذا عن طريق تقييد الرئيس على أدوات التنسيق فقط. اضغط  Shift+Tab للتغيير إلى وضع التفويض.

التحدث مباشرة مع الأعضاء

كل عضو هو جلسة كاملة ومستقلة من كلود كود. يمكنك إرسال رسائل مباشرة لأي عضو:

• • الوضع داخل العملية: استخدم Shift+Up/Down لاختيار العضو، ثم أدخل لإرسال الرسالة. اضغط Enter لعرض جلسة العضو، ثم اضغط Escape لقطع دوره الحالي. اضغط Ctrl+T للتبديل بين قائمة المهام.

• • وضع تقسيم الشاشة: انقر على نافذة العضو للتفاعل المباشر مع جلسته.

توزيع وطلب المهام

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

يمكن للرئيس توزيع المهام صراحة، أو يمكن للأعضاء طلبها بعد الانتهاء.

إغلاق الأعضاء

لإنهاء جلسة العضو بسلاسة:

Ask the researcher teammate to shut down
(اطلب من العضو الباحث الإغلاق)

يرسل الرئيس طلب إغلاق. يمكن للعضو الموافقة والخروج بسلاسة، أو الرفض وتوضيح السبب.

تنظيف الفريق

بعد الانتهاء، اطلب من الرئيس التنظيف:

Clean up the team
(تنظيف الفريق)

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

كيف تعمل فرق الوكيل

الهيكل

فريق الوكيل يتضمن:

• • الرئيس: الجلسة الرئيسية لكلود كود التي تنشئ الفريق، وتولد الأعضاء، وتنسق العمل

• • الأعضاء: مثيلات مستقلة من كلود كود تعالج المهام الموزعة

• • قائمة المهام: القائمة المشتركة لعناصر العمل التي يطلبها الأعضاء ويكملونها

• • صندوق البريد: نظام الرسائل للاتصال بين الوكيل

يدير النظام تبعيات المهام تلقائيًا. يتم تخزين الفريق والمهام محليًا:

• • تكوين الفريق: ~/.claude/teams/{team-name}/config.json

• • قائمة المهام: ~/.claude/tasks/{team-name}/

السياق والاتصال

كل عضو له نافذة السياق الخاصة به. عند التوليد، يحمل الأعضاء نفس سياق المشروع كالجلسات العادية: CLAUDE.md، خوادم MCP والمهارات. لا يتم نقل تاريخ محادثة الرئيس.

كيف يشارك الأعضاء المعلومات:

• • نقل الرسائل التلقائي: عندما يرسل العضو رسالة، يتم نقلها تلقائيًا إلى المستلم

• • إشعار الخمول: عندما يكمل العضو ويتوقف، يتم إشعار الرئيس تلقائيًا

• • قائمة المهام المشتركة: جميع الوكيل يمكنهم رؤية حالة المهام وطلب العمل المتاح

استخدام الرموز

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

أمثلة حالات الاستخدام

تشغيل مراجعة التعليمات البرمجية بالتوازي

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

Create an agent team to review PR #142. Spawn three reviewers: one focused on security implications, one checking performance impact, one validating test coverage. Have them each review and report findings.
(إنشاء فريق وكيل لمراجعة PR #142. توليد ثلاثة مراجعين: واحد يركز على الآثار الأمنية، وآخر يتحقق من تأثير الأداء، وثالث يتحقق من تغطية الاختبار. دع كل منهم يراجع ويبلغ عن النتائج.)

التحقيق بفرضيات متنافسة

عندما يكون السبب الجذري غير واضح، يميل الوكيل الفردي إلى العثور على تفسير معقول والتوقف عن البحث.

Users report the app exits after one message instead of staying connected. Spawn 5 agent teammates to investigate different hypotheses. Have them talk to each other to try to disprove each other's theories, like a scientific debate. Update the findings doc with whatever consensus emerges.

أفضل الممارسات

إعطاء الأعضاء سياقًا كافيًا

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

تعديل حجم المهام بشكل مناسب

• • صغير جدًا: تتكلف التنسيق أكثر من الفائدة

• • كبير جدًا: يعمل الأعضاء لفترة طويلة دون فحص، مما يزيد من خطر الجهود المهدرة

• • مناسب: وحدة مستقلة تنتج تسليمًا واضحًا

انتظار انتهاء الأعضاء

أحيانًا يبدأ الرئيس في تنفيذ المهام بنفسه، بدلاً من انتظار الأعضاء للانتهاء. إذا لاحظت ذلك:

Wait for your teammates to complete their tasks before proceeding
(انتظر حتى يكمل أعضاء فريقك مهامهم قبل المتابعة)

تجنب تضارب الملفات

عضوان يحرران نفس الملف يؤدي إلى التجاوز. قسم العمل بحيث يمتلك كل عضو مجموعة ملفات مختلفة.

المراقبة والتوجيه

تحقق من تقدم الأعضاء، أعد توجيه الطرق غير الفعالة، واجمع النتائج مع التقدم.

القيود

فرق الوكيل تجريبية. القيود الحالية:

• • أعضاء الوضع داخل العملية لا يدعمون استئناف الجلسة: لا يستأنف /resume و /rewind الأعضاء داخل العملية

• • حالة المهام قد تتأخر: أحيانًا لا يتمكن الأعضاء من وضع علامة على اكتمال المهام

• • الإغلاق قد يكون بطيئًا: يكمل الأعضاء الطلب الحالي قبل الإغلاق

• • فريق واحد لكل جلسة: يمكن للرئيس إدارة فريق واحد فقط في كل مرة

• • لا يدعم الفرق المتداخلة: لا يمكن للأعضاء توليد فرقهم الخاصة

• • الرئيس ثابت: الجلسة التي تنشئ الفريق هي الرئيس خلال حياتها

• • تقسيم الشاشة يتطلب tmux أو iTerm2: لا يدعم محطة VS Code المتكاملة، أو Windows Terminal، أو Ghostty