سلاسل الوكلاء المستقلين مع Devin

صعود الوكلاء المستقلين

Devin 2.0 يمثل نموذجًا جديدًا: ذكاء اصطناعي يمكنه العمل بشكل مستقل على مهام معقدة لفترات طويلة. على عكس المساعدين التفاعليين، الوكلاء المستقلون:

• يخططون نهج متعدد الخطوات بشكل مستقل
• يتصفحون موارد الويب للبحث
• ينفذون أوامر shell ويديرون البيئات
• يكررون الحلول دون توجيه مستمر

متى تنشر الوكلاء المستقلين

السيناريوهات المثالية:

• تنفيذ الميزات بمتطلبات واضحة
• المهام كثيفة البحث (تكاملات API، تقييم المكتبات)
• إعادة الهيكلة المتكررة عبر ملفات كثيرة
• توليد التوثيق من الكود
• إنشاء مجموعة الاختبارات

تجنب لـ:

• القرارات التي تتطلب سياق الأعمال
• العمليات الحساسة أمنيًا
• قرارات UX المواجهة للعملاء
• تغييرات الهندسة المعمارية

إعداد تكامل Devin

تحديد حدود واضحة

<!-- .claude/devin-tasks.md -->

# إرشادات مهام Devin

## أنواع المهام المعتمدة
- ✅ تنفيذ عمليات CRUD للنماذج المحددة
- ✅ إضافة اختبارات الوحدة للدوال الموجودة
- ✅ دمج APIs الطرف الثالث مع التوثيق المقدم
- ✅ إعادة هيكلة الكود متبعًا الأنماط المنشأة
- ✅ توليد أنواع TypeScript من مخططات JSON

## المهام المقيدة
- ❌ تغييرات مخطط قاعدة البيانات
- ❌ تعديلات المصادقة/التفويض
- ❌ تغييرات تكوين النشر
- ❌ ترقيات الإصدار الرئيسي للاعتماديات

إنشاء قوالب المهام

<!-- .claude/templates/devin-task.md -->

# مهمة Devin: [اسم المهمة]

## الهدف
[هدف واضح في جملة واحدة]

## السياق
- المستودع: [رابط-المستودع]
- الفرع: [اسم-الفرع]
- الملفات ذات الصلة: [قائمة الملفات الرئيسية]

## المتطلبات
1. [المتطلب المحدد 1]
2. [المتطلب المحدد 2]
3. [المتطلب المحدد 3]

## القيود
- اتبع أنماط الكود الموجودة في [ملف-المرجع]
- استخدم [مكتبة محددة] لـ [الغرض]
- لا تُعدل [الملفات/المجلدات المحمية]

## معايير النجاح
- [ ] جميع الاختبارات تمر
- [ ] لا أخطاء TypeScript
- [ ] PR منشأ بوصف واضح
- [ ] [معايير القبول المحددة]

## مرجع المثال
[رابط لتنفيذ مشابه أو عينة كود]

هندسة سلسلة الوكلاء

سلسلة التسليم

Claude Code ─── يخطط ويفوض ───→ Devin
                                    │
                                    ▼
                              يعمل بشكل مستقل
                              (30 دقيقة - 4 ساعات)
                                    │
                                    ▼
Claude Code ◄─── ينشئ PR ───────────┘
     │
     ▼
يراجع ويُحسّن
     │
     ▼
Cursor ◄─── التلميع النهائي ─────────┘

مثال سلسلة عملية

الخطوة 1: تحليل Claude Code

claude "حلل هيكل API لدينا وأنشئ مهمة Devin
لإضافة نقطة نهاية /api/analytics جديدة. ضمّن:
- الأنماط الموجودة للاتباع
- استعلامات قاعدة البيانات المطلوبة
- تنسيق الاستجابة المتوقع
- متطلبات الاختبار"

الخطوة 2: الإرسال إلى Devin

Claude Code يولد مواصفات المهمة:

# مهمة Devin: نقطة نهاية Analytics API

## الهدف
إنشاء نقطة نهاية تحليلات جديدة تُرجع مقاييس تفاعل المستخدم.

## السياق
- المستودع: github.com/company/app
- الفرع: feature/analytics-api
- الملفات ذات الصلة:
  - src/api/users/route.ts (مرجع النمط)
  - src/lib/db/queries.ts (أدوات قاعدة البيانات)
  - src/types/api.ts (أنواع الاستجابة)

## المتطلبات
1. إنشاء نقطة نهاية GET /api/analytics
2. قبول معلمات الاستعلام: startDate, endDate, userId (اختياري)
3. إرجاع مقاييس مجمعة: pageViews, sessions, avgDuration
4. تضمين معالجة خطأ مناسبة للتواريخ غير الصالحة

## القيود
- اتبع النمط في src/api/users/route.ts
- استخدم أداة db.query() الموجودة
- أضف الأنواع إلى src/types/api.ts
- لا تُعدل نقاط النهاية الموجودة

## معايير النجاح
- [ ] نقطة النهاية تُرجع تنسيق البيانات الصحيح
- [ ] التحقق من معلمات الاستعلام يعمل
- [ ] اختبارات الوحدة تغطي المسار السعيد وحالات الحافة
- [ ] TypeScript يُترجم بدون أخطاء

الخطوة 3: مراقبة التقدم

بينما يعمل Devin، يمكن لـ Claude Code:

• مراقبة الفرع للـ commits
• مراجعة التغييرات التدريجية
• تحضير مهام المتابعة

# Claude Code يراقب
watch -n 60 'gh pr list --head feature/analytics-api'

الخطوة 4: المراجعة والتكامل

claude "راجع PR الخاص بـ Devin لـ feature/analytics-api:
- تحقق من جودة الكود والأنماط
- تحقق من تغطية الاختبار
- حدد أي مخاوف أمنية
- اقترح تحسينات إذا لزم الأمر"

أنماط تنسيق السلسلة

المعالجة التتابعية

# سير العمل الزائف
tasks = [
    ("claude-code", "analyze_and_plan"),
    ("devin", "implement_feature"),
    ("claude-code", "review_code"),
    ("cursor", "polish_and_fix"),
    ("claude-code", "final_review_and_merge")
]

for agent, task in tasks:
    result = dispatch(agent, task)
    if not result.success:
        escalate_to_human(result)

تدفقات العمل المتوازية

Claude Code يخطط
       │
       ├──────────────────────────┐
       ▼                          ▼
    Devin                      Devin
  (Backend API)            (Frontend UI)
       │                          │
       └──────────┬───────────────┘
                  ▼
           Claude Code
      (مراجعة التكامل)

استرداد الأخطاء

عندما يتعثر وكيل مستقل:

معالجة انتهاء الوقت

# إذا لم يُنفذ Devin commit في ساعتين
claude "مهمة Devin للتحليلات تبدو متوقفة.
تحقق من حالة الفرع وإما:
1. قدم توجيهًا إضافيًا
2. قسّم المهمة إلى قطع أصغر
3. تولَّ التنفيذ"

بروتوكول التراجع

# إذا أنتج الوكيل كودًا إشكاليًا
git checkout main
git branch -D feature/analytics-api
git push origin --delete feature/analytics-api

claude "التنفيذ المستقل واجه مشاكل.
لنأخذ نهجًا مختلفًا: [استراتيجية جديدة]"

أفضل الممارسات لسلاسل الوكلاء

1. معايير نجاح واضحة: حدد بالضبط كيف يبدو "الإنتهاء"
2. تحديد الوقت: حدد مدد قصوى للعمل المستقل
3. Commits تدريجية: اطلب commits متكررة للرؤية
4. مخارج الطوارئ: حدد متى تصعد للبشر
5. الحفاظ على السياق: وثق القرارات لاستمرارية السلسلة

قياس فعالية السلسلة

تتبع هذه المقاييس:

• معدل إكمال المهام
• الوقت من الإرسال إلى PR
• عدد دورات المراجعة
• درجات جودة الكود
• تغطية الاختبار المحققة

معاينة الوحدة التالية

في الوحدة 2، سنطبق تقنيات الوكلاء المتعددين هذه على هندسة المشاريع المعقدة، متعلمين كيف ننسق الوكلاء لبناء ميزات كاملة عبر المكدس. :::