هندسة الحلقة في Claude Code: أربع طرق لأتمتة العمل تتجاوز الاستعلامات لمرة واحدة

لا تكتفِ بإعلان اكتمال تغييرات واجهة المستخدم لمجرد نجاح التحرير.

1. شغّل خادم التطوير وافتح الصفحة التي تم تعديلها.
2. تفاعل مع العناصر المعدّلة وتأكد من تحقيق الحالة المتوقعة.
3. التقط لقطات شاشة للمقارنة بين ما قبل التعديل وما بعده عند الضرورة.
4. افحص وحدة تحكم المتصفح للتأكد من عدم وجود أخطاء أو تحذيرات جديدة.
5. نفّذ تتبع الأداء وراجع مؤشرات أداء الويب الأساسية.

إذا فشل أي من هذه الفحوصات، يجب إصلاح المشكلة وإعادة التنفيذ من الخطوة 1.

الفكرة الأساسية لا تكمن في الصياغة نفسها، بل في أن هذه المهارة تتيح لكلود الحصول على نفس الأدلة التي يحصل عليها المراجع البشري.

الفحوصات الكمية فعّالة بشكل خاص:

• عدم وجود أخطاء في وحدة التحكم
• اجتياز جميع الاختبارات
• تجاوز نقاط Lighthouse الحد المطلوب
• عدم وجود تغييرات بصرية خارج المنطقة المحددة
• وقت الاستجابة أقل من الحد المسموح
• إنجاز عدد محدد من معايير القبول

كلما كانت عملية التحقق أكثر قابلية للقياس الكمي، قلّ التدخل البشري.

2. آلية التكرار المستندة إلى الهدف (أمر /goal)

عندما لا تكون جولة واحدة كافية ولكن يمكن وصف نقطة النهاية بوضوح، تصبح آلية التكرار المستندة إلى الهدف مفيدة للغاية.

لا يسمح Claude Code لعامل التنفيذ بالحكم على ما إذا كانت النتيجة "جيدة بما فيه الكفاية"، بل يستخدم مُقيمًا مستقلًا بعد كل جولة.

شرط البدء

يبدأ المستخدم هدفًا في الجلسة الحالية.

شرط التوقف

تنتهي الدورة عند حدوث أحد الأمرين:

• يؤكد المُقيم أن الشروط قد تحققت، أو
• الوصول إلى الحد الأقصى لعدد الجولات المُعدّلة.

أفضل حالات الاستخدام

آلية التكرار المستندة إلى الهدف مناسبة للمهام ذات النهاية القابلة للتحقق، مثل:

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

الصيغة الأساسية

المثال الرسمي من Anthropic كما يلي:

/goel اجعل درجة Lighthouse للصفحة الرئيسية 90 أو أعلى، وتوقف بعد 5 محاولات.

مثال عملي آخر:

/goel اجتياز جميع الاختبارات في مجلد test/auth دون أخطاء في خطوة lint

وفقًا لمستندات Claude Code الحالية، يتطلب أمر /goal إصدار Claude Code 2.1.139 أو أحدث.

كيف يغير المُقيم آلية التكرار

بعد أن يكمل Claude جولة من العمليات، يتحقق نموذج مُقيم سريع وخفيف من تحقق الشرط.

إذا لم يتحقق الشرط، تبدأ جولة جديدة تلقائيًا. إذا تحقق، يُحذف الهدف الحالي وتُعاد السيطرة على الجلسة إلى المستخدم.

هذا الفصل مهم لأن نموذج العمل لا ينبغي أن يكون الحكم الوحيد على نتائجه.

يجب أن يتمتع شرط الإنجاز الفعّال بالخصائص التالية:

• قابلية الملاحظة
• التحديد
• صعوبة تحققه بالصدفة
• ارتباطه بنتائج المستخدم الحقيقي أو النظام
• وجود حد أقصى لعدد المحاولات أو قيود صارمة أخرى

الأهداف الضعيفة مقابل الأهداف القوية

هدف ضعيف:

/goel تحسين الصفحة الرئيسية

كلمة "تحسين" لم تحدد نقطة نهاية قابلة للقياس.

هدف قوي:

/goel رفع درجة أداء Lighthouse على الأجهزة المحمولة إلى 90 على الأقل،
مع الحفاظ على إمكانية الوصول عند 95 أو أعلى، والتوقف بعد 5 محاولات

هدف ضعيف:

/goel إصلاح الاختبارات

هدف قوي:

/goel اجتياز جميع الاختبارات في مجلد test/payments دون اختبارات مُتجاوزة،
وخروج أمر npm run lint برمز 0

لا ينبغي للنموذج أن يخمن معنى النجاح.

أمر /goal لا يغير الأذونات

يمتد الهدف عبر عدة جولات، لكنه لا يوافق تلقائيًا على جميع استدعاءات الأدوات.

في وضع الأذونات الافتراضي، قد يظل كلود يطلب تأكيدًا مؤقتًا على الأوامر غير المصرح بها.

بالنسبة للأهداف غير المراقبة، توصي Anthropic بدمج /goal مع الوضع التلقائي عند الإمكان وعند الاقتضاء. يجب أن يتم ذلك بعد مراجعة الأدوات المسموح بها، حدود المستودع، والآثار الجانبية المحتملة.

3. التكرار المستند إلى الوقت: /loop و /schedule

بعض المهام لا تُفعَّل باكتمال جولة سابقة، بل بمرور الوقت.

تظل المهام متشابهة، لكن المُدخلات تتغير:

• وصول رسالة Slack جديدة.
• استلام طلب سحب لمراجعة.
• تغير حالة CI من نجاح إلى فشل.
• إصدار نسخة جديدة من تبعية.
• الإبلاغ عن حدث جديد في لوحة التحكم التشغيلية.

شرط البدء

تبدأ كل عملية تشغيل بفاصل زمني أو جدول مُعدّ.

شرط التوقف

يتوقف التكرار المحلي عند إلغائك له، أو إغلاق البيئة، أو اكتمال عمل المراقبة.

تستمر الروتينات السحابية في العمل وفق تكوينها حتى يتم إيقافها مؤقتًا أو تعطيلها.

أفضل حالات الاستخدام

التكرار المستند إلى الوقت مناسب لـ:

• مراقبة طلبات السحب.
• ملخصات يومية أو أسبوعية.
• تصنيف المشكلات بشكل دوري.
• فحص التبعيات.
• تشغيل الاختبارات بشكل دوري.
• فحص انحراف المستندات.
• أنظمة المراقبة التي لا توفر تفعيلًا قائمًا على الأحداث.

التكرار المحلي بفاصل زمني

المثال الرسمي يستخدم /loop:

/loop 5m افحص طلبات السحب الخاصة بي، وعالج تعليقات المراجعة، وأصلح CI الفاشل

يُعاد تشغيل هذا الأمر حسب الفاصل الزمني المُعدّ.

يعتمد التكرار المحلي على الجهاز والجلسة الحالية. إذا أُغلِق الكمبيوتر أو توقفت العملية، يتوقف التكرار أيضًا.

الجدولة السحابية

بالنسبة للمهام التي تحتاج إلى الاستمرار بعد إغلاق الكمبيوتر المحمول، يمكن لـ Claude Code استخدام /schedule لإنشاء روتين سحابي.

قد يبدأ روتين نشط على النحو التالي:

/schedule كل ساعة: تحقق من التقارير الجديدة في #project-feedback

تعمل روتينات Claude Code على بنية تحتية سحابية تديرها Anthropic، ويمكن تفعيلها بواسطة:

• جدولة دورية.
• جدولة لمرة واحدة في المستقبل.
• استدعاء واجهة برمجة التطبيقات.
• أحداث GitHub المدعومة.

في وقت كتابة هذا المستند، الروتينات في مرحلة معاينة بحثية، وبالتالي قد تتغير السلوكيات والقيود وواجهة برمجة التطبيقات. تعتمد التوفر أيضًا على خطة Claude ذات الصلة، سياسة المؤسسة، وما إذا كانت النسخة الويب من Claude Code مفعّلة.

اختر الفاصل الزمني بحذر

خطأ شائع هو تشغيل التكرار بتردد أعلى بكثير من سرعة تغير النظام الخارجي.

إذا ظهرت مشكلات جديدة بضع مرات فقط في اليوم، فليس من المفيد فحص قائمة المشكلات كل دقيقة. هذا يزيد من استهلاك الرموز، وعدد استدعاءات الأدوات، و——

يؤثر على النتائج دون إضافة قيمة.

طابق فاصل الاقتراع مع التردد المتوقع للتغيير:

نمط التغيير الخارجي	تردد الاقتراع المناسب للبدء
حالة CI بعد دفع نشط	كل 5–10 دقائق
قناة ملاحظات الفريق	كل 30–60 دقيقة
ملخص Slack يومي	مرة واحدة يوميًا صباحًا
تحديثات التبعيات	يوميًا أو أسبوعيًا
انحراف المستندات	ليلًا أو أسبوعيًا

هذه اقتراحات بداية وليست قواعد عامة. عندما يدعم النظام الخارجي، يُفضّل التفعيل القائم على الأحداث على الاقتراع.

4. التكرار النشط

التكرار النشط هو مزيج من العناصر الأساسية السابقة.

يعمل دون مراقبة، ويستجيب للمهام المخطط لها أو الواردة، ويمرر كل عنصر من عناصر المهام عبر تدفق محدد.

المحتوى المتعلق بالدورة النشطة للكود يوضح بشكل مباشر سير العمل الخاص به، بما في ذلك مراحل التشغيل والتنفيذ والتغذية الراجعة، وهو ما يتوافق مع ما ورد في الوثيقة حول "التشغيل" و"شروط الإيقاف".](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/image/2026/07/0106395e-ee08-41b8-bc17-2b28e0bbd11a-f55a5db1-fee1-4a0e-8ca9-96752a156eb0.png)

المشغّل

مهمة مجدولة، أو طلب API، أو حدث من GitHub، أو رسالة، أو مشكلة، أو أي إشارة خارجية أخرى تبدأ العمل.

شرط الإيقاف

تنتهي كل مهمة مستقلة بعد تحقيق هدفها.

تستمر البرامج المحيطة في استقبال الأعمال المستقبلية إلى أن يقوم شخص بتعطيلها.

أفضل حالات الاستخدام

الدورة النشطة مناسبة لسير العمل المتكرر والمحدد بوضوح:

• تصنيف تقارير الأخطاء.
• تصنيف المشكلات.
• ترقية التبعيات.
• الترحيلات الروتينية.
• مراجعات التعليمات البرمجية المتكررة.
• التحقيق في التنبيهات.
• التحقق من النشر.
• صيانة المهام المتراكمة.

مثال كامل للنمط النشط

يجمع مثال Anthropic بين عدة ميزات من Claude Code:

1. /schedule للتحقق من التقارير الجديدة.
2. /goal لتحديد ما يجب إنجازه في كل تشغيلة.
3. وصف المهارات لكيفية التحقق من كل مهمة.
4. سير العمل الديناميكي لتنسيق وكلاء متعددين.
5. النمط التلقائي لتقليل توقف الإذن التفاعلي.

قد تبدو التعليمات المدمجة على النحو التالي:

/schedule كل ساعة: تحقق من تقارير الأخطاء في #project-feedback.

/goal: لا تتوقف حتى يتم تصنيف كل تقرير يتم العثور عليه في هذه التشغيلة،
ومعالجته، والرد عليه.

عند إصلاح الخلل، استخدم سير العمل في شجرة عمل متوازية
لاستكشاف ثلاثة حلول، ومراجعتها من قبل مدقق مستقل.

لم يعد هذا مجرد تلميح متكرر. إنه نظام تشغيل صغير لسير العمل الضيق.

سير العمل الديناميكي

سير العمل الديناميكي هو نصوص برمجية لتنسيق الوكلاء الفرعيين على نطاق واسع.

يكتب Claude نص JavaScript للتنسيق، وتقوم بيئة التشغيل بتنفيذه في الخلفية. يمكن الاحتفاظ بالنتائج الوسيطة في متغيرات النص دون ملء سياق المحادثة الرئيسي.

تستخدم Anthropic سير العمل الديناميكي للمهام التالية:

• تدقيق العديد من الملفات بحثاً عن نفس المشكلة.
• ترحيل مئات الملفات.
• تشغيل مسارات استقصاء مستقلة.
• مقارنة حلول مقترحة متعددة.
• مراجعة كل ملف تم تغييره وإنشاء تقرير نهائي.

تشير الوثائق الحالية إلى أن سير العمل الديناميكي يتطلب إصدار Claude Code 2.1.154 أو أحدث. يمكنها تنسيق عشرات أو مئات الوكلاء، لذا يجب تجربتها على نطاق صغير قبل تنفيذ مهام إنتاجية كبيرة.

ما تغير فعلياً: التحقق وشروط الإيقاف

المهام المجدولة، والتنسيق، وحلقات التغذية الراجعة، وقوائم انتظار العمل ليست مفاهيم هندسية جديدة.

التحول الحقيقي هو أن وكلاء البرمجة يمكنهم الآن المشاركة بشكل أكبر في الحلقة:

• قراءة الحالة الحالية
• اختيار الأدوات
• إجراء التغييرات
• تفسير الأخطاء
• مقارنة النتائج بالأهداف
• تجربة نهج آخر
• التصعيد فقط عندما لا يمكن للنظام العمل بأمان

لم تختفِ التلميحات. لقد أصبحت جزءاً لا يتجزأ من نظام تحكم أكبر.

أصبحت أسئلة التصميم الأكثر أهمية الآن:

• ماذا يعني "الانتهاء"؟
• من يقرر استيفاء الشروط؟
• أي الفحوصات حتمية؟
• ما الدليل الذي يمكن للوكيل فحصه؟
• ما هو الحد الأقصى لعدد المحاولات؟
• ما هي ميزانية الرموز أو التكلفة؟
• كيف يتم اكتشاف نقص التقدم؟
• ما العمليات التي تتطلب موافقة بشرية؟
• ماذا يحدث بعد فشل التشغيل؟

التلميحات المكتوبة بعناية لا يمكنها تعويض شروط الإيقاف المفقودة.

التحقق هو التحسين الأكثر تأثيراً

تؤكد Anthropic مراراً على التحقق: تمكين Claude من فحص وقياس مخرجاته الخاصة.

إذا طُلب من مهندس بشري بناء صفحة دون وصول إلى متصفح، فإنه يعمل بشكل أعمى. وضع الوكيل مشابه.

تشمل أدوات التحقق المفيدة:

• مجموعات الاختبارات
• مدققي الأنواع
• أدوات التحقق من الكود
• أوامر البناء
• أتمتة المتصفح
• لقطات الشاشة والمقارنة البصرية
• تتبع الأداء
• استعلامات قاعدة البيانات
• تأكيدات استجابات API
• ماسحات الأمان
• التحليل الثابت
• نصوص القبول القابلة للتكرار

إعطاء الأولوية للفحوصات الحتمية قدر الإمكان

غالباً ما يكون النص الذي يُرجع رمز خروج 0 أو 1 أرخص وأكثر موثوقية من مطالبة النموذج بالاستدلال من البداية على ما إذا كان مطلب معين قد تحقق.

على سبيل المثال:

npm test
npm run lint
npm run typecheck

يمكن أن يكون نص التحقق المدمج:

#!/usr/bin/env bash
set -euo pipefail

npm run typecheck
npm run lint
npm test

يمكن لـ Claude تشغيل هذا النص بعد كل تغيير. لم تعد الدورة بحاجة لإعادة تفسير عملية القبول بأكملها في كل مرة.

استخدام وكيل ثان للمراجعة

تقترح Anthropic أيضاً استخدام مُراجع بسياق جديد.

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

للتغييرات عالية القيمة، يمكن للنظام استخدام:

• وكيل للتنفيذ
• وكيل للتحقق من الصحة
• وكيل للتحقق من الأمان
• مجموعة اختبارات حتمية كحارس نهائي

المزيد من الوكلاء ليس أفضل دائماً. أضفهم فقط عندما تبرر قيمة المراجعة التكلفة الإضافية.

خطر الدورات دون حواجز حماية

الدورات التي يمكن أن تستمر إلى أجل غير مسمى قوية وخطيرة في نفس الوقت.

هناك ثلاثة أنماط رئيسية للفشل.

1. فقدان السيطرة على التكاليف

قد تستهلك كل دورة رموز إدخال، ورموز إخراج، واستدعاءات أدوات، واستخدام نماذج مدفوعة.

بدون حد أقصى للجولات أو الميزانية، يمكن للدورات المفتوحة أن تستمر في استهلاك التكاليف مع إنتاج قيمة إضافية قليلة فقط.

يدعم Claude Agent SDK كلاً من:

• max_turns / maxTurns
• max_budget_usd / maxBudgetUsd

تشير وثائق SDK الرسمية إلى:

بشكل افتراضي، لم يتم تعيين أي من الحدين.

بالنسبة للوكلاء في بيئة الإنتاج، تعتبر الحدود الواضحة معياراً معقولاً.

2. التقدم الوهمي

قد يقوم الوكيل بتحرير نفس الملفات بشكل متكرر دون إنتاج اختبارات جديدة ناجحة أو تحسينات قابلة للقياس.

قد يبدو السجل نشطاً حتى إذا كان النظام يكرر محاولات مختلفة لنفس الحل الفاشل.

تشمل إشارات عدم التقدم المفيدة:

• نفس الاختبارات تفشل باستمرار عبر جولات متعددة.
• لا يتم استيفاء أي معايير قبول جديدة.
• نفس الملفات يتم التراجع عنها أو إعادة كتابتها مراراً.
• تظل الدرجات كما هي.
• لا ينخفض حجم قائمة الانتظار.
• يعود الوكيل إلى حلول تم رفضها سابقاً.

عندما يتوقف التقدم، يجب أن تتوقف الدورة القوية عن العمل أو تصعد الأمر.

3. ثقة متزايدة في الحلول الخاطئة

قد يؤدي التكرار إلى جعل الحل المعيب أكثر تعقيداً بدلاً من أكثر صحة.

قد يضيف الوكيل طبقات حول افتراضات خاطئة، مما ينتج كوداً يبدو مكتملاً بشكل متزايد بينما يبتعد أكثر عن السلوك المتوقع.

المراجعات المستقلة، والاختبارات الحتمية، ومسارات العودة الواضحة تساعد في منع هذا النوع من الفشل.

ثلاثة حواجز يجب وضعها لكل دورة

يجب أن تحتوي الدورة العملية على ثلاثة أنواع من الحواجز على الأقل.

1. شرط إكمال قابل للتحقق آلياً

يجب أن تكون حالة الإكمال قابلة للملاحظة من خلال الاختبارات، أو النصوص، أو المقيمين، أو ملاحظة الحالة الخارجية.

أمثلة:

• جميع الاختبارات ناجحة.
• قائمة الانتظار فارغة.
• طلب السحب مدمج.
• الدرجة لا تقل عن 90.
• جميع العناصر في قائمة المراجعة مميزة كمكتملة.
• لا توجد مشكلات ذات خطورة عالية متبقية.

2. حد صارم

ضع حداً أقصى صارماً واحداً على الأقل:

• الحد الأقصى لعدد جولات التشغيل.
• الحد الأقصى لعدد المحاولات.
• الحد الأقصى للوقت المستغرق.
• الحد الأقصى لاستخدام الرموز.
• الحد الأقصى للتكلفة المالية.
• الحد الأقصى لعدد الملفات المعدلة.
• الحد الأقصى لعدد الوكلاء المتوازيين.

حد واحد يمكنه تحويل الفشل اللانهائي إلى فشل محدود.

3. كشف عدم التقدم

توقف عندما لا يعد النظام يتقدم نحو الهدف.

على سبيل المثال:

إذا لم تنتج ثلاث محاولات متتالية اختبارات جديدة ناجحة
وتم تعديل نفس الملفات، فتوقف وأبلغ عن العائق.

يمكن للتنفيذ في بيئة الإنتاج تتبع ذلك عبر نصوص أو حالة سير العمل، وليس فقط من خلال التعليمات.

إدارة استخدام الرموز

يجب تصميم الدورات لتوجيه موارد الاستدلال نحو أعلى الحلقات قيمة.

توصي Anthropic بتدابير التحكم في التكاليف التالية.

استخدام أبسط البدائيات

المهام الصغيرة لا تحتاج إلى سير عمل متعدد الوكلاء.

ابدأ بالطريقة التالية:

1. عمليات الجولات العادية.
2. وحدات المهارات القابلة للتكرار والتحقق.
3. استخدم /goal عندما تحتاج إلى المزيد من الجولات.
4. استخدم /loop أو /schedule عندما تحتاج إلى العمل بناءً على الوقت.
5. استخدم سير العمل النشط فقط عندما يكون تدفق المهام دوريًا ومُحددًا بوضوح.

استخدم النماذج الصغيرة للعمل العادي

يمكن للنماذج السريعة والمنخفضة التكلفة معالجة:

• اكتشاف الملفات.
• التصنيف البسيط.
• التحرير المتكرر.
• التنسيق.
• إجراء الفحوصات الحتمية.
• تلخيص النتائج المنظمة.

احتفظ بأقوى النماذج من أجل:

• القرارات المعمارية.
• تحديد الأخطاء الغامضة.
• الأحكام الأمنية.
• المراجعات العدائية.
• حل النزاعات في التقييم.

اختبر أولاً ثم وسع

قد تؤدي سير العمل الديناميكية إلى إنشاء عدد كبير من الوكلاء.

قم بالتشغيل على نطاق صغير أولاً:

• عالج عشرة ملفات قبل التوسع إلى خمسمائة.
• حل فئة مشكلة واحدة قبل التوسع الكامل.

مجموعة المهام المتراكمة بالكامل.

• عالج مستودعًا واحدًا قبل التعامل مع كل مستودع.
• عالج رسائل يوم واحد قبل التعامل مع شهر من الرسائل.

يكشف المشروع التجريبي عن استهلاك الرموز، واختناقات الأدوات، والأعطال الشائعة، ونقاط التحكم المفقودة.

استخدم البرامج النصية بدلاً من الاستدلال

عندما تكون العملية حتمية، ما عليك سوى كتابة الكود مرة واحدة واترك Claude يُشغّله.

على سبيل المثال:

• تحليل السجلات.
• التحقق من عدد الملفات.
• مقارنة بنية المخرجات.
• ملء النماذج المعروفة.
• البحث عن الملفات التي تتوافق مع القواعد.
• اختبار قائمة عناوين URL.
• حساب عتبات الأداء.

تجنب الاستقصاء المفرط

يجب أن تعكس الحلقات الزمنية سرعة تغير النظام الأساسي.

الفترات القصيرة جدًا تزيد التكاليف دون تحقيق نتائج أفضل.

تحقق من الاستخدام أثناء التشغيل

توفر Anthropic عدة أوامر للتحقق من الاستهلاك:

/usage

يُظهر هذا الأمر الاستخدام الحديث في مجالات مثل المهارات والوكلاء الفرعيين وتكامل MCP.

تشغيل /goal بدون وسائط يُظهر جولات الهدف الحالي واستهلاك الرموز، بينما يُظهر /workflows استخدام وكيل سير العمل ويوفر عناصر تحكم لإيقاف الوكيل.

قد يختلف التوفر حسب إصدار Claude Code والميزات المُفعّلة.

الأذونات والأمان

لا ينبغي الخلط بين الأتمتة والوصول غير المقيد.

يدعم Claude Code أوضاع الأذونات التي تتحكم في الأدوات والأوامر التي يمكن تشغيلها.

للعمل المستقل على أجهزة التطوير، توصي Anthropic بالاحتفاظ بقواعد السماح الواضحة، أو استخدام وضع يوافق تلقائيًا على مجموعة محدودة من العمليات الشائعة مع الاستمرار في التحكم في الأوامر عالية المخاطر.

يجب استخدام وضع تجاوز الأذونات فقط في البيئات المعزولة، مثل:

• الحاويات المؤقتة.
• عمال CI في بيئة رملية.
• الأجهزة الافتراضية المؤقتة.
• البيئات التي لا تحتوي على بيانات حساسة أو وحدات تخزين مهمة.

يجب أن تحتوي الحلقة النشطة التي يمكنها تحرير الملفات، وتشغيل أوامر الصدفة، والوصول إلى الأنظمة الخارجية، وإنشاء طلبات السحب، على:

• صلاحيات مستودع محدودة.
• تقييد الوصول إلى الشبكة قدر الإمكان.
• قائمة أدوات مسموح بها قابلة للتدقيق.
• نقاط تفتيش للتحكم في الإصدار.
• بيانات اعتماد مستقلة ومحدودة النطاق.
• موافقة بشرية على عمليات النشر أو العمليات التدميرية.

الهدف ليس إزالة جميع القرارات البشرية، بل ترك البشر للقرارات التي تتطلب حقًا حكمًا بشريًا.

كيفية اختيار الحلقة المناسبة

يُرجى الرجوع إلى عملية اتخاذ القرار التالية.

اختر الحلقة القائمة على الجولات عندما:

• ما زلت تستكشف المشكلة.
• تعتمد الخطوة التالية على الحكم البشري.
• المهمة صغيرة وغير منتظمة.
• معايير الإكمال ذاتية.
• يمكن فحص التغييرات الفاشلة يدويًا بسهولة.

اختر الحلقة القائمة على الهدف عندما:

• للنتائج شروط قبول قابلة للقياس.
• قد يحتاج الوكيل إلى عدة محاولات.
• يمكن التحقق من كل محاولة.
• يمكنك تحديد حد صارم للجولات أو التكاليف.
• ينتمي العمل إلى جلسة نشطة.

اختر الحلقة القائمة على الوقت عندما:

• تتكرر نفس المهام.
• فقط المدخلات تتغير.
• تحتاج إلى فحص الأنظمة الخارجية بانتظام.
• استخدام الجدولة أبسط من تكامل الأحداث.
• يمكنك تحمل التأخير الناتج عن الاستقصاء.

اختر الحلقة النشطة عندما:

• يستمر العمل في الوصول.
• يتبع كل عنصر عملية مستقرة.
• يمكن فحص النتائج.
• سير العمل ضمن صلاحيات محدودة.
• يمكن تصعيد الفشل بدلاً من إخفائه.
• تم اختبار ميزانيات الرموز والأدوات.

أول حلقة عملية

توصي Anthropic بالبدء بمهمة أنت حاليًا عنق الزجاجة فيها.

اطرح ثلاثة أسئلة.

1. هل يمكنني كتابة فحص تحقق؟

مثال:

• أمر اختبار.
• تفاعل متصفح.
• حد درجة.
• فحص حجم قائمة الانتظار.
• مقارنة نمط.
• قاعدة فرق بصري.

2. هل الهدف واضح بما يكفي؟

يصف الهدف المفيد حالة، وليس مجرد نشاط.

كتابة أفضل:

جميع اختبارات الدفع ناجحة ولا توجد أخطاء TypeScript متبقية.

كتابة أضعف:

استمر في تحسين وحدة الدفع.

3. هل يظهر العمل بإيقاع يمكن التنبؤ به؟

إذا ظهرت المهمة كل ساعة، أو يوميًا، أو أسبوعيًا، أو بعد أحداث معروفة، فقد تكون مناسبة لحلقة أو روتين.

إذا كانت أي إجابة بنعم، فلديك مهمة مرشحة للحلقة الأولى.

مثال: من الاستفسار اليدوي إلى الحلقة الآمنة

تخيل فريقًا يصلح باستمرار فحوصات طلبات السحب الفاشلة.

المرحلة 1: نمط الجولات

افحص PR الحالي، وأصلح اختبارات CI الفاشلة، واشرح التغييرات.

يعيد المطور تشغيل هذه العملية يدويًا في كل مرة يتغير فيها CI.

المرحلة 2: إضافة التحقق

أنشئ مهارة يمكنها:

1. قراءة نتائج CI.
2. إعادة إنتاج الفشل محليًا.
3. تشغيل الاختبارات ذات الصلة.
4. فحص مجموعة الاختبارات الكاملة.
5. مراجعة الفرق النهائي.

المرحلة 3: إضافة الهدف

/goal جميع فحوصات CI الضرورية ناجحة، توقف بعد 4 محاولات

يمكن للجلسة الاستمرار في محاولات إصلاح متعددة.

المرحلة 4: إضافة حلقة زمنية محلية

/loop 10m افحص PR، وعالج التعليقات الجديدة، وأصلح أي فحوصات فاشلة ضرورية.

يتحقق الوكيل من التغييرات الخارجية.

المرحلة 5: نقلها إلى روتين

أنشئ روتينًا سحابيًا يتم تشغيله بواسطة حدث طلب سحب أو جدول.

قم بتقييده في:

• المستودعات ذات الصلة.
• فرع ميزة.
• طلبات السحب المسودة.
• مجموعة محددة من الأوامر.
• الحد الأقصى للإنفاق أو حجم التشغيل.

التطور تدريجي. كل مرحلة تضيف أتمتة فقط بعد أن تكون للمرحلة السابقة فحوصات موثوقة.

الأخطاء الشائعة

استخدام حلقة لمهمة غير واضحة

"تحسين قاعدة الكود" قد يستمر إلى أجل غير مسمى.

قسمه إلى نتائج قابلة للملاحظة.

جعل وكيل العمل الحكم الوحيد

استخدم الاختبارات أو البرامج النصية أو المُقيّمين المستقلين.

إضافة تعقيد متعدد الوكلاء مبكرًا

قد يكون وكيل واحد مع مُحقّق قوي أفضل من سير عمل كبير ضعيف التنسيق.

جدولة العمل بشكل متكرر جدًا

الاستقصاء كل دقيقة ليس بالضرورة أكثر استجابة.

تجاهل حدود التكلفة أو الجولات

الحلقات بدون حدود عليا قد تؤدي إلى فشل مكلف.

التعامل مع تعليمات الاستفسار كضوابط أمنية صلبة

استخدم الأذونات والخطافات والبيئة الرملية والبيئات المعزولة للتنفيذ الحتمي.

إصلاح كل فشل يدويًا

عندما يتكرر نفس الخطأ، قم بتحسين المهارة أو القاعدة أو المُحقّق أو سير العمل الذي أنتجه.

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

ما هي هندسة الحلقات في Claude Code؟

هندسة الحلقات هي تصميم سير عمل وكيل متكرر حتى يتم الوصول إلى شرط التوقف. تركز على المشغلات والتحقق والحدود والأذونات والتصعيد، وليس فقط صياغة الاستفسار.

ما هي أنواع الحلقات الأربعة في Claude Code؟

تصنف Anthropic الحلقات إلى أنواع: الجولات، والهدف، والوقت، والنشط.

الفرق الرئيسي بينهما يكمن في آلية بدء جولة جديدة، والعنصر أو العامل الذي يقرر متى يتوقف العمل.

ما هو دور /goal في Claude Code؟

يقوم /goal بتعيين شرط إتمام للجلسة الحالية. بعد كل جولة، يتحقق مُقيّم مستقل من استيفاء الشرط؛ فإذا لم يتحقق، تبدأ جولة جديدة، وتستمر هذه العملية حتى الوصول إلى الهدف أو بلوغ الحدود المقررة.

ما الفرق بين /loop و/schedule؟

يقوم /loop بتكرار أمر معين على الجهاز المحلي بفواصل زمنية، لذا يتوقف التكرار بمجرد توقف الجهاز أو الجلسة. أما /schedule فينشئ مهمة روتينية سحابية يمكنها الاستمرار في العمل على البنية التحتية المُدارة من Anthropic، حتى لو كان الكمبيوتر المحمول مغلقًا.

هل يمكن أن يستمر تكرار Claude Code إلى ما لا نهاية؟

إذا كان سير العمل يفتقر إلى حدود واضحة، فقد يستمر التكرار لفترة أطول من المتوقع. قبل السماح بالتنفيذ غير المراقب، ينبغي تحديد شرط إتمام قابل للقياس، وسقف صارم لعدد الجولات أو التكلفة، وقاعدة إيقاف في حال عدم إحراز تقدم.

هل أحتاج إلى وكلاء متعددين لإنشاء تكرار حلقي؟

لا. قد تكون جلسة Claude Code عادية مع مهارات تحقق قابلة لإعادة الاستخدام كافية. تصبح سير العمل الديناميكية والوكلاء المتعددون أكثر فائدة عندما تتطلب المهام معالجة متوازية واسعة النطاق أو مراجعة مستقلة.

كيف يمكن تقليل تكلفة تكرار الوكيل؟

استخدم أبسط أنواع التكرار، واختر نموذجًا أصغر للمهام الروتينية، وأجرِ تجارب على مهام أصغر، واستبدل الاستدلال الحتمي بالبرامج النصية، وقلل من عمليات الاستقصاء غير الضرورية، وضع حدودًا واضحة لعدد الجولات أو الميزانية.

هل تكرار Claude Code الاستباقي آمن؟

طالما أن صلاحياته، والمستودع، وبيانات الاعتماد، والميزانية، وشروط الإيقاف، ومسارات الترقية خاضعة لرقابة صارمة، يمكن تشغيله بمسؤولية. لا تستخدم أوضاعًا تتجاوز الصلاحيات على أجهزة عادية تحتوي على بيانات حساسة أو قيّمة.

الأدوات ذات الصلة

• Claude Code: بيئة البرمجة الذكية من Anthropic لقراءة المستودعات، وتحرير الملفات، وتشغيل الأوامر، وأتمتة مهام التطوير.
• Claude Agent SDK: مجموعة أدوات تطوير برمجية لتضمين تكرار الوكيل الذي يستخدم أدوات Claude Code في التطبيقات المخصصة.
• Claude Code Skills: تعليمات برمجية قابلة لإعادة الاستخدام، ونصوص، وموارد مخزنة في ملف SKILL.md.
• Dynamic Workflows: أدوات تنسيق قائمة على النصوص البرمجية لتنسيق العديد من الوكلاء الفرعيين في المهام الكبيرة.
• Claude Code Hooks: أدوات أتمتة دورة الحياة الحتمية للتحقق من عمليات الأدوات أو منعها أو الاستجابة لها.
• Model Context Protocol: معيار مفتوح لربط الوكلاء الذكيين بالأدوات ومصادر البيانات الخارجية.
• Chrome DevTools MCP: خادم MCP لتصحيح متصفح Chrome، مفيد جدًا لدورات التحقق من الواجهة الأمامية.

الروابط ذات الصلة

• هندسة الحلقات: دليل البدء مع الحلقات: التعريف الرسمي من Anthropic لأنماط الحلقات الأربعة وحالات الاستخدام الموصى بها.
• اجعل Claude يعمل باستمرار: وثائق /goal الرسمية حول الصيغة، وسلوك التقييم، والتحكم في الحالة، والمتطلبات.
• تشغيل المهام المجدولة: وثائق حول المهام الدورية المحلية والمهام المخطط لها في Claude Code.
• الإجراءات الآلية للعمل: الدليل الرسمي من Anthropic للإجراءات السحابية التي يتم تشغيلها بناءً على جداول زمنية، أو واجهات برمجة التطبيقات، أو أحداث GitHub.
• مبادئ التكرار الحلقي للوكيل: وثائق تقنية حول استدعاء الأدوات، والجولات، والصلاحيات، والسياق، وقيود الميزانية.
• تنسيق الوكلاء الفرعيين بسير العمل الديناميكي: بنية سير العمل الرسمية، والقيود، والأمثلة، وخيارات التحكم في التكلفة.
• توجيه Claude Code: دليل Anthropic لاختيار المهارات، والخطافات، والقواعد، والوكلاء الفرعيين، وطرق التحكم الأخرى.
• صفحة مجتمع BAAI الأصلية: مقالة صينية منقولة مقدمة كمرجع أولي.

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

تكرار Claude Code ليس مجرد أوامر متكررة بسيطة، بل هو نظام خاضع للرقابة تتعاون فيه المشغلات، والأدوات، والتحقق، والصلاحيات، والميزانية، وشروط الإيقاف معًا.

التكرار المعتمد على الجولات يمنح البشر التحكم في كل خطوة لاحقة؛ التكرار القائم على الهدف يفوض شرط الإتمام إلى المُقيّم؛ التكرار المجدول يفوض المشغل. أما التكرار الاستباقي فيجمع هذه العناصر الأساسية لتشكيل سير عمل غير مراقب وقابل للتكرار.

غالبًا لا يكمن التحسين الأكثر أهمية في زيادة عدد الوكلاء، بل في منح الوكيل الحالي آليات موثوقة للفحص الذاتي، وتحديد معايير إنجاز واضحة، وإيقاف النظام في الوقت المناسب عند نفاد التقدم أو الميزانية.

الحلقات المفيدة ليست تلك التي يمكنها العمل إلى أجل غير مسمى - بل تلك التي يمكنها إثبات متى يجب أن تتوقف.