إعداد سير العمل متعدد الوكلاء

نمط المنسق

في سير العمل متعدد الوكلاء، تحتاج منسقًا رئيسيًا. Claude Code يتفوق في هذا الدور لأنه:

• وصول كامل لنظام الملفات لجمع السياق
• تكاملات MCP للأدوات الخارجية
• قدرة إنشاء الوكلاء الفرعيين
• ذاكرة مستمرة عبر الجلسات

إعداد البيئة

الخطوة 1: تكوين Claude Code كمنسق

أنشئ تكوينًا على مستوى المشروع:

# إنشاء مجلد .claude
mkdir -p .claude

# إنشاء إعدادات المشروع
cat > .claude/settings.json << 'EOF'
{
  "permissions": {
    "allow": [
      "Bash(git:*)",
      "Bash(npm:*)",
      "Read",
      "Write",
      "Edit"
    ]
  },
  "context": {
    "include": ["src/**", "tests/**", "docs/**"],
    "exclude": ["node_modules/**", "dist/**"]
  }
}
EOF

الخطوة 2: تحديد أدوار الوكلاء

أنشئ ملف .claude/agents.md لتوثيق مسؤوليات الوكلاء:

# أدوار الوكلاء

## Claude Code (المنسق)
- تحليل قاعدة الكود وقرارات الهندسة
- عمليات إعادة الهيكلة المعقدة
- عمليات Git وإدارة الفروع
- تفويض المهام وتتبع التقدم
- المراجعة النهائية والتكامل

## Cursor (المطور الفوري)
- البرمجة النشطة في IDE
- التكرارات والإصلاحات السريعة
- مساعدة الإكمال التلقائي الفوري
- التنفيذات الخاصة بالملفات

## Devin (العامل المستقل)
- تنفيذ الميزات من البداية للنهاية
- مهام البحث التي تتطلب وصول الويب
- تطوير النماذج الأولية
- توليد التوثيق

الخطوة 3: إعداد تكامل Cursor

قم بتكوين Cursor للعمل جنبًا إلى جنب مع Claude Code:

// .cursor/settings.json
{
  "ai.model": "claude-sonnet-4-20250514",
  "ai.contextFiles": [
    ".claude/agents.md",
    "ARCHITECTURE.md"
  ],
  "ai.excludeFiles": [
    "node_modules/**",
    ".git/**"
  ]
}

تكوين سير العمل

إنشاء بروتوكول التسليم

<!-- .claude/handoff-protocol.md -->

# بروتوكول تسليم الوكلاء

## تنسيق نقل السياق
عند التسليم لوكيل آخر، ضمّن:

1. **الحالة الحالية**: ما تم إنجازه
2. **الخطوات التالية**: ما يجب فعله
3. **الملفات ذات الصلة**: الملفات التي يجب على الوكيل قراءتها
4. **القيود**: أي حدود أو متطلبات
5. **معايير النجاح**: كيف تعرف متى ينتهي

## مثال على التسليم

### من Claude Code إلى Cursor:
"لقد أنشأت هيكل مسار API في `src/api/`.
الرجاء تنفيذ المعالج في `src/api/users/route.ts`:
- استخدم middleware المصادقة الحالي
- اتبع النمط في `src/api/posts/route.ts`
- أرجع استجابات خطأ مناسبة
النجاح: جميع أنواع TypeScript تمر، الاختبارات خضراء"

جلسة وكلاء متعددين عملية

السيناريو: بناء ميزة لوحة التحكم

المرحلة 1: تحليل Claude Code

# Claude Code يحلل ويخطط
claude "حلل قاعدة الكود وأنشئ خطة لإضافة
لوحة تحكم تحليلات المستخدم. حدد:
1. مصادر البيانات الموجودة
2. أنماط المكونات للاتباع
3. مسارات API المطلوبة
4. الملفات للإنشاء/التعديل"

المرحلة 2: تنفيذ Cursor

مع خطة Claude Code، انتقل إلى Cursor:

في Cursor: "بعد الخطة في .claude/dashboard-plan.md،
نفذ مكون DashboardPage. استخدم مكونات
Card و Chart الموجودة من نظام التصميم لدينا."

المرحلة 3: مراجعة Claude Code

# العودة إلى Claude Code للمراجعة
claude "راجع تنفيذ لوحة التحكم في
src/components/Dashboard/. تحقق من:
- التناسق مع الأنماط الموجودة
- مشاكل الأداء
- معالجة الأخطاء المفقودة
- تغطية الاختبار"

استراتيجيات المزامنة

المزامنة القائمة على Git

# Claude Code ينشئ فرع الميزة
git checkout -b feature/dashboard

# العمل في Cursor (حفظ تلقائي)
# Claude Code يمكنه تتبع التغييرات
git status
git diff

# Claude Code يُنفذ commits لوحدات منطقية
git add -p  # Staging تفاعلي
git commit -m "feat: add dashboard component structure"

التواصل القائم على الملفات

# Claude Code يكتب التعليمات
echo "## المهمة الحالية
نفذ مكون الرسم البياني في src/components/Chart.tsx
انظر المرجع: src/components/Graph.tsx" > .claude/current-task.md

# Cursor يقرأ وينفذ
# Claude Code يراقب التقدم
watch -n 5 'stat -f "%m" src/components/Chart.tsx'

حل التعارضات

عندما ينتج الوكلاء تغييرات متعارضة:

1. فضّل قرار المنسق (Claude Code)
2. استخدم git diff لتحديد التعارضات
3. اجعل Claude Code يدمج بذكاء

claude "هناك تغييرات متعارضة في src/api/handler.ts.
Cursor أضاف التحقق لكنه يتعارض مع معالجة
الأخطاء التي أضفتها. ادمج هذه التغييرات، محتفظًا
بكلتا الميزتين مع الحفاظ على التناسق."

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

1. كاتب نشط واحد: وكيل واحد فقط يعدل الملف في كل مرة
2. Commits متكررة: نفذ commit قبل التبديل بين الوكلاء
3. تسليمات واضحة: وثق ما تم وما هو التالي
4. سياق مشترك: حافظ على تحديث مجلد .claude/
5. نقاط مزامنة منتظمة: توقف للتحقق من توافق جميع الوكلاء

الخطوات التالية

في الدرس التالي، سنستكشف التنسيق المتقدم مع Devin وسلاسل الوكلاء المستقلين لتطوير الميزات المعقدة. :::