الميزات الوكيلية ونقاط التفتيش

البنية الوكيلية لـ Claude Code تتيح له العمل بشكل مستقل على المهام المعقدة. نقاط التفتيش تضمن أنه يمكنك دائماً التعافي إذا حدث خطأ ما.

فهم الوضع الوكيلي

في الوضع الوكيلي، Claude Code يمكنه:

• تقسيم المهام المعقدة إلى مهام فرعية
• إنتاج وكلاء فرعيين للعمل المتوازي
• تنفيذ الأوامر والتحقق من النتائج
• التصحيح الذاتي بناءً على الأخطاء
• المتابعة حتى اكتمال المهمة

تمكين التفكير الممتد

للاستدلال المعقد:

claude config set thinking-mode extended

أوضاع التفكير:

• normal: استدلال قياسي
• extended: تحليل أعمق، يُظهر عملية التفكير
• extended_max: أقصى عمق للمهام المعقدة جداً

الوكلاء الفرعيون

Claude Code يمكنه إنتاج وكلاء متخصصين:

المهمة الرئيسية: "إعادة هيكلة نظام المصادقة"
│
├── الوكيل الفرعي 1: تحليل التنفيذ الحالي
├── الوكيل الفرعي 2: البحث عن أفضل الممارسات
├── الوكيل الفرعي 3: إنشاء المخطط الجديد
└── الوكيل الفرعي 4: كتابة اختبارات الترحيل

نقاط التفتيش

نقاط التفتيش تحفظ حالة مشروعك في نقطة زمنية.

إنشاء نقطة تفتيش

# في جلسة Claude Code
/checkpoint create "قبل إعادة هيكلة المصادقة"

أو عبر CLI:

claude checkpoint create "Before auth refactor"

ما يُحفظ

محتويات نقطة التفتيش:
├── جميع تغييرات الملفات منذ آخر commit
├── سياق المحادثة الحالي
├── العمليات المعلقة
└── حالة الإعداد

عرض نقاط التفتيش

/checkpoint list

استعادة نقطة تفتيش

/checkpoint restore 1
# أو
/checkpoint restore "Before auth refactor"

سير العمل الوكيلية العملية

سير العمل 1: تنفيذ ميزة

نفّذ نظام إشعارات لتطبيقنا:

1. صمم مخطط الإشعارات
2. أنشئ ترحيلات قاعدة البيانات
3. ابنِ نقاط نهاية API (CRUD)
4. أضف دعم WebSocket للإشعارات الفورية
5. أنشئ مكونات React لمركز الإشعارات
6. اكتب اختبارات لجميع المكونات
7. حدّث التوثيق

نفّذ خطوة بخطوة، مع إنشاء نقاط تفتيش قبل التغييرات الكبيرة.

سير العمل 2: تحقيق الأخطاء

هناك تسرب ذاكرة في الإنتاج. حقق وأصلح:

1. حلل سجلات الأخطاء في logs/error.log
2. اعمل ملف تعريف لاستخدام الذاكرة في src/services
3. حدد مصدر التسرب
4. اقترح إصلاحات بأقل تأثير
5. نفّذ الإصلاح
6. أضف مراقبة لمنع التكرار

أظهر تحليلك في كل خطوة.

وكلاء الخلفية

شغّل وكلاء في الخلفية بينما تعمل:

# بدء مهمة خلفية
claude background "شغّل الاختبارات وأصلح أي إخفاقات"

# تحقق من الحالة
claude background status

# عرض النتائج
claude background results

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

عندما يخطئ Claude:

الخيار 1: تراجع عن آخر تغيير

/undo

الخيار 2: استعادة نقطة تفتيش

/checkpoint restore "Before auth refactor"

الخيار 3: التصحيح التكراري

هذا التغيير كسر الاختبارات. تحديداً:
- فشل بحث المستخدم بسبب المخطط الجديد
- أبقِ على المخطط الجديد لكن أصلح استعلام البحث

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

1. نقطة تفتيش قبل التغييرات الكبيرة

# دائماً
/checkpoint create "Before [description]"

2. استخدم التفكير الممتد للمهام المعقدة

# للقرارات المعمارية
claude config set thinking-mode extended

3. قسّم المهام الكبيرة إلى مراحل

بدلاً من:

"أعد كتابة الخلفية بالكامل"

استخدم:

"أعد كتابة وحدة المصادقة. توقف بعد هذه المرحلة للمراجعة."

إدارة التكلفة

المهام الوكيلية يمكن أن تكون مكلفة. راقب الاستخدام:

# تحقق من تكلفة الجلسة الحالية
/cost

رؤية وكيلية: قوة Claude Code تكمن في الوثوق به بالمهام متعددة الخطوات مع الحفاظ على نقاط التفتيش للأمان. فكر في نقاط التفتيش كـ git commits لجلسة AI الخاصة بك.

في الدرس التالي، سنستكشف تكاملات MCP لربط Claude Code بالأدوات الخارجية. :::