Claude Code Subagents and Agent Teams: A Practical Guide

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

دعنا نَفْتحُه بدون الهرجون.

يا له من مرشد

والعامل الفرعي هو مساعد متخصص له سياقه الخاص، ومساره الخاص، وتصاريح أدواته الخاصة.

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

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

تُعلنُ مساعديكَ في ملف مشروعِكَ .claude/agents/. كل شخص لديه اسم، وصف يقول متى يستخدمه، ونظام سريع.

---
name: test-writer
description: Use when tests need to be written or fixed
---
You write tests. You aim for edge-case coverage,
not the happy path. You never touch production code.

كيزك، الخطوة التالية

Agent Teams is the multi-agent orchestrator built into QZAQ. لا تزال تجريبية، معوقة بالفشل، ولكن نقطة دخول صلبة.

The idea: a lead agent divides a big task, delegates each piece to a specialized agent (with its own model, prompts, tools), the specialists work in parallel on a shared file system, and the results flow back to the lead.

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

وفوق النسيج المبني، هناك أطراف ثالثة مثل Multiclaude و Gas Town. هم مُشَاهَرون، الذي يَجْعلُهم نقاطَ بداية جيدةِ عندما تَبْدأُ: هم يُقرّرونَك حتى بَنيتَ عاداتَكَ الخاصةَ.

عندما تحتاجه (وعندما لا تحتاجه)

لنكن واضحين، التفتيش المتعدد الوكلاء لا فائدة منه لـ 95 في المائة من المهام المُساعدة من العملاء لمعظم عملك اليومي عميل واحد أسرع وأبسط.

في الوقت الراهن، لا تزال متعددة العناصر وسيلة باهظة الثمن وتجربة للهجوم على مشاريع كبيرة.

تحتاجه عندما:

• The project divideds into genuinely independent pieces that touch different files.
• نافذة سياقية واحدة لا يمكن أن تحمل كل شيء.
• تريد أن توازي مفاعلاً واسعاً أو هجرة على نطاق واسع.

أنت لا تحتاجه لإصلاح البق، سمة مركّزة، أو أي شيء يناسب رأس واحد.

الفخ يُشغّلُ a عشْرة وَجِدَة "بيم" لa شيء واحد وكيل يَعمَلُ في خمس دقائقِ. تَدْفعُ في الخنازيرِ والتعقيدِ للموازاةِ المهمّةِ مَا طَلبَ.

المشكلة الحقيقية: الرؤية

إليك ما لا يُتحدث عنه بما فيه الكفاية في اللحظة التي تدير فيها العديد من المُساعدين أو فريق العميل، تفقد الخيط.

مندوبين رئيسيين لخمسة أخصائيين أيهما يعمل؟ أيهما انتهى؟ الذي ينتظر قرار؟ في محطة طرفية ترى حائطاً من النص المزخر ولا يمكنك معرفة من يفعل ماذا.

هذا هو المكان الذي يغيّر فيه لوحة مرئية كل شيء. وتُظهر شركة AgentsRoom كل وكيل وكل من الجهات الفرعية كإطار خاص بها، مع تحديد مركزها. إذا شاهدت الوفد يحدث، ترى من ينتظر ردك، ترى من تحطم. ويصبح جدار النص خريطة قابلة للقراءة.

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

من أين نبدأ

لا تقفز مباشرة إلى فريق من ثمانية.

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

بمجرد أن يشعر ذلك الميكانيكي بالطبيعية، تشغيل Agent Teams للعمل الذي ينقسم بشكل نظيف. راقبوا من يفعل ماذا، وافقوا على خطط قبل التنفيذ، وتوقفوا عن استعراض اللحظة.

مكافأة متعددة الوكلاء الناس الذين يهيّلون قبل إطلاقهم ليس من يطلقون أكثر العملاء.