# مولّد فريق وكلاء Claude Code: من وصف المنتج إلى مجلد .claude مفحوص

> Claude Agents Team إضافة مفتوحة المصدر لـ Claude Code تكتب فريق وكلاء كاملًا من وصف المنتج، وتفحص كل ملف قبل أن تنتهي.

*2026-10-19T12:49:04Z*

# مولّد فريق وكلاء Claude Code: من وصف المنتج إلى مجلد .claude مفحوص

عندما تستخدم Claude Code في مشروع حقيقي، ستحتاج عاجلًا أو آجلًا إلى فريق وكلاء: منسّق، وبضعة وكلاء متخصصين، ومهارات، وقواعد مشتركة، وhooks. كتابة مجلد `.claude` هذا يدويًا تستغرق ساعات، ومن السهل أن تقع فيه أخطاء دقيقة.

Claude Agents Team إضافة مفتوحة المصدر لـ Claude Code تولّد المجلد كاملًا من وصف المنتج، ثم تفحص كل ملف كتبته قبل أن تنتهي.

![غلاف المقال: ولّد فريق Claude Code كاملًا من وصف المنتج](/uploads/sites/d2901c92-cbd7-4bc0-a576-f63b4938258b/media/claude-agents-team-launch-ar.png)

**الخلاصة:** شغّل `/team-gen` مع وصف المنتج، فتحصل في `.claude/` على منسّق ووكلاء متخصصين ومهارات وقواعد وhooks. أما `/evaluate-agent` فيقيّم أي ملف وكيل أو مهارة وفق مجموعة قواعد تستند كل قاعدة فيها إلى مصدر موثّق. ويعقد `/meet` اجتماعًا بين الوكلاء حول موضوع ما ويكتب المحضر.

## المشكلة

فريق الوكلاء أكثر من قائمة prompts. كل وكيل يحتاج إلى frontmatter سليم، ووصف يخبر Claude متى يفوّض إليه، وقائمة أدوات مناسبة، ونموذجًا يلائم المهمة. ويحتاج الفريق إلى منسّق يوزّع العمل، وقواعد يلتزم بها الجميع، وhooks تفرضها.

يذكر ملف README بوضوح من أين جاءت الفكرة: صاحب المشروع يدير ثلاثة فرق وكلاء كبيرة (نحو 14 و42 و40 وكيلًا)، وكان يبني كل واحد منها من الصفر يدويًا. فاستخرجت الإضافة الأنماط التي نجحت، وتتيح لك تركيب فرق جديدة منها، وتنبّهك حين يكون وكيل دون المستوى المطلوب.

## كيف تعمل

ثلاث ركائز في إضافة واحدة.

### 1. `/team-gen`: الوصف يصبح فريقًا

تعطيه ملف PRD أو وصفًا مباشرًا. يستخرج منه ما يحتاجه (الخدمات، والتقنيات، وحجم الفريق المطلوب، والقيود)، ويسألك عند الغموض بدل أن يخترع. ثم يختار من مكتبة الأنماط ويملأ القوالب ويكتب المجلد.

تضم المكتبة 8 أنماط وكلاء و4 أنماط مهارات، و13 قالب قواعد، و4 قوالب hooks (الأرقام من مجلد `templates/` في المستودع):

| النمط | النموذج | ملاحظات |
|---|---|---|
| orchestrator | Opus | موجود دائمًا. يتولى التوجيه ودورة حياة الخطة. |
| tech-leader | Opus | اختياري. مراجعة معمارية للقراءة فقط. |
| domain-engineer | Sonnet | وكيل لكل خدمة أو مسار. |
| designer | Sonnet | عندما يكون للمنتج واجهة فعلية. |
| qa-engineer | Sonnet | موجود دائمًا. |
| security-engineer | Sonnet | عند وجود مصادقة أو مدفوعات أو بيانات شخصية أو اتصالات خارجية. |
| devops-engineer | Sonnet | عندما يملك الفريق CI/CD أو البنية التحتية. |
| monitor | Haiku | وكيل خلفية للفرق الأكبر أو التي تعمل دائمًا. |

تجمع المهارة ملف `team.json` وتسلّمه إلى سكربت البناء. ويمكنك حفظه في `.claude/team.json` ليصبح إعادة التوليد لاحقًا أمرًا واحدًا.

### 2. المقيِّم: كل ملف يُقيَّم

المقيِّم هو الأساس الذي تُبنى حوله بقية الإضافة. يقيّم ملف الوكيل أو المهارة عبر ست محاور: frontmatter، والوصف، وسلامة الأدوات، وملاءمة النموذج، وبنية النص، والأنماط السيئة. وكل قاعدة تستند إلى مواصفات Anthropic أو إلى أعمال سابقة منشورة (يشير الـ rubric إلى LangChain `agentevals` وBraintrust وGalileo وكتابة Anthropic عن التقييم).

وله ثلاث مراحل:

- **الفاحص الساكن (static linter).** حتمي ومجاني ويصلح لـ CI.
- **LLM-as-judge** (الخيار `--deep`). استدعاء منفصل لكل محور، لالتقاط الفروق الدقيقة مثل الأوصاف الغامضة أو التناقضات. ويستخدم واجهة Anthropic البرمجية.
- **الفحص السلوكي.** يقارن ما فعله الوكيل في سجل التنفيذ بما وعد به تعريفه.

يشغّل المولّد الفاحص الساكن على كل ملف ينتجه. وإذا جاء حكم `reject` على أي ملف يفشل التشغيل، ورمز الخروج هو أسوأ حكم صدر. هكذا يبدو ناتج التشغيل في README:

```text
=== Self-evaluation ===
  shop-orch.md           A  100/100  ship
  api-engineer.md        A   97/100  ship
  ...
=== Self-eval worst verdict: exit 0 ===
```

### 3. `/meet`: اجتماع فريق مع محضر

بعد أن يوجد الفريق، يرسل الأمر `/meet "Should we ship the v2 migration this quarter?"` الموضوع إلى كل وكيل بالتوازي. يجيب كل وكيل من مجاله: فحص القيود، وأهم ثلاث مخاطر، والاعتماديات، والأسئلة المفتوحة، وتقدير الجهد. ثم يجمع المنسّق قائمة مرتبة بأهم عشر مخاطر، والخلافات، والأسئلة المفتوحة، ويكتب المحضر في `.meetings/YYYY-MM-DD-<topic>.md`.

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

## البدء

التثبيت من المستودع (الأوامر من README):

```bash
git clone https://github.com/fadymondy/agents-team.git
claude plugin install ./agents-team/plugins/agents-team
```

ثم:

```bash
# Generate a team from a PRD
/team-gen ./my-product-spec.md --target .

# Hold a meeting on a topic
/meet "Should we ship the v2 migration this quarter?"

# Lint an agent
/evaluate-agent .claude/agents/code-reviewer.md
```

يضم المستودع مثال PRD ومواصفات في مجلد `examples/` إن أردت تجربة المولّد من البداية إلى النهاية أولًا.

## حدود صريحة

- **يكتب ملفات لا ضمانات.** تقدير A يعني أن الملفات اجتازت القواعد، ولا يثبت أن الفريق سيتصرف جيدًا على قاعدة الكود عندك.
- **الفحص السلوكي في بدايته.** يصفه README في إصداره الأول بأنه للإعادة فقط (replay)، أي يقيّم سجل تنفيذ بعد وقوعه.
- **الحَكَم يكلّف توكنات.** الأمر `/evaluate-agent --deep` يستدعي واجهة Anthropic ويحتاج `ANTHROPIC_API_KEY`. أما الفاحص الساكن فلا.
- **له رأي.** القواعد والأنماط تعكس طريقة صاحب المشروع في إدارة الفرق: التخطيط أولًا، وإنجازات صغيرة، ولا دفع للكود بلا إذن، ووكيل جودة ووكيل أمان افتراضيًا. احذف ما لا تريده.
- **ليس ميزة agent teams المدمجة في Claude Code.** الإضافة تولّد ملفات التعريف فقط، ولا تغيّر طريقة جدولة Claude Code للوكلاء أو تشغيله لهم.

## أسئلة شائعة

**هل هي نفسها agent teams المدمجة في Claude Code؟** لا. هي إضافة مستقلة مفتوحة المصدر تولّد ملفات الفريق في مجلد `.claude` وتفحصها.

**هل يستدعي الفاحص نموذجًا لغويًا؟** لا. الفاحص الساكن حتمي ومجاني. الحَكَم الاختياري `--deep` وحده يستخدم الواجهة البرمجية.

**ماذا لو رُسب ملف مولَّد في الفحص؟** حكم `reject` على أي ملف يُفشل التشغيل.

**هل أستطيع تعديل الناتج؟** نعم. هو Markdown وJSON عاديان. عدّل `team.json` وأعد التوليد، أو عدّل وكيلًا وأعد فحصه بـ `/evaluate-agent`.

**كم تكلفتها؟** هي مفتوحة المصدر برخصة MIT، وتعمل داخل جلسة Claude Code الخاصة بك.

## روابط

- Product Hunt: [Claude Agents Team](https://www.producthunt.com/products/claude-agents-team)
- الشيفرة: [github.com/fadymondy/agents-team](https://github.com/fadymondy/agents-team)
- الوثائق: [team-gen](https://github.com/fadymondy/agents-team/blob/main/docs/team-gen.md) و[meet](https://github.com/fadymondy/agents-team/blob/main/docs/meet.md) و[evaluator](https://github.com/fadymondy/agents-team/blob/main/docs/evaluator.md)
- لماذا بنيته: [لماذا بنيت Claude Agents Team](https://fadymondy.com/ar/blog/why-i-built-claude-agents-team)
- English version: [النسخة الإنجليزية](https://agents-team.fadymondy.com/en/blog/claude-code-agent-team-generator)

---

Source: https://agents-team.fadymondy.com/ar/blog/claude-code-agent-team-generator