# TeamCreate

يُنشئ فريق تعاون جديداً بقائمة مهام مشتركة وقناة رسائل بين الوكلاء. الفريق هو الأصل التنسيقي للعمل متعدد الوكلاء — تعمل الجلسة الرئيسية بوصفها قائداً وتُطلق زملاء فريق مسمَّين عبر أداة `Agent`.

## متى يُستخدم

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

لا تستخدمه لبحث مُفوَّض واحد أو تفرُّع موازٍ لمرة واحدة — استدعاءات `Agent` العادية أخف وكافية.

## المعاملات

- `team_name` (سلسلة، مطلوب): معرف فريد للفريق. يُستخدم كاسم دليل تحت `~/.claude/teams/` وكوسيطة `team_name` عند إطلاق زملاء الفريق.
- `description` (سلسلة، مطلوب): بيان قصير لهدف الفريق. يُعرض على كل زميل فريق عند الإطلاق ويُكتب في إعداد الفريق.
- `agent_type` (سلسلة، اختياري): شخصية الوكيل الفرعي الافتراضية المطبقة على زملاء الفريق الذين لا يتجاوزونها. القيم النموذجية هي `general-purpose` أو `Explore` أو `Plan`.

## أمثلة

### مثال 1: إنشاء فريق إعادة هيكلة

```
TeamCreate(
  team_name="refactor-crew",
  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
  agent_type="general-purpose"
)
```

بعد الإنشاء، أطلق زملاء فريق بـ `Agent` باستخدام `team_name: "refactor-crew"` وقيم `name` متميزة مثل `db-lead` و`migrations` و`tests`.

### مثال 2: إنشاء فريق تحقيق

```
TeamCreate(
  team_name="perf-investigation",
  description="Identify and rank the top three performance regressions introduced in the last release.",
  agent_type="Explore"
)
```

يرث كل زميل فريق مُطلق `Explore` بوصفه شخصيته الافتراضية، بما يتوافق مع الطبيعة التحقيقية للقراءة فقط للعمل.

## ملاحظات

- يمكن قيادة فريق واحد فقط في كل مرة من جلسة معينة. أنهِ أو احذف الفريق الحالي قبل إنشاء آخر.
- الفريق 1:1 مع قائمة مهام مشتركة. يمتلك القائد إنشاء المهام وتعيينها وإغلاقها؛ بينما يُحدِّث زملاء الفريق حالة المهام التي يعملون عليها.
- يُستمر إعداد الفريق في `~/.claude/teams/{team_name}/config.json`، ويعيش دليل المهام بجواره. هذه الملفات تبقى عبر الجلسات حتى تُزال صراحةً بـ `TeamDelete`.
- يُطلق زملاء الفريق باستخدام أداة `Agent` مع `team_name` مطابق بالإضافة إلى `name` متميز. يصبح `name` هو العنوان المستخدم بواسطة `SendMessage`.
- اختر `team_name` آمناً لنظام الملفات (أحرف وأرقام وشرطات وشرطات سفلية). تجنب المسافات أو الشرطات المائلة.
- اكتب `description` بحيث يُفهم زميل فريق جديد، يقرؤه بدون سياق، هدف الفريق دون مزيد من السياق. يصبح جزءاً من موجه بدء كل زميل فريق.
