برنامج تعليمي مبسّط للمبتدئين في هندسة الحلقات: ابدأ أول حلقة لوكيل ذكاء اصطناعي بأمر واحد

المقدمة

إذا كنت تسمع الناس يتحدثون عن «هندسة الحلقات» ولكنك ما زلت غير متأكد من أين تبدأ، فهذا الدليل يمنحك نقطة انطلاق عملية.

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

قدّم التقرير الأصلي إطار عمل مفتوح المصدر لهندسة الحلقات من إعداد Cobus Greyling. في وقت نشر التقرير، كان المشروع قد حصل على نحو 4.5 آلاف نجمة على GitHub. وقد يعرض المستودع الآن عددًا مختلفًا من النجوم لأنه استمر في النمو.

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

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

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

يمكن استخدام حلقة نموذجية في مهام مثل:

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

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

لماذا يحظى هذا الإطار بالاهتمام؟

يجمع إطار العمل مفتوح المصدر الموصوف في المقال الأصلي بين أنماط حلقات عملية، وقوالب بداية، وأدوات سطر أوامر. صُمم هذا الإطار لوكلاء البرمجة بالذكاء الاصطناعي، ويدعم سير عمل حول أدوات مثل Claude Code وCodex وGrok وOpenCode.

يتضمن الإطار:

• سبعة أنماط حلقات جاهزة للاستخدام؛
• قوالب بداية للسيناريوهات الشائعة؛
• loop-init لإنشاء هيكل الحلقة؛
• loop-cost لتقدير تكلفة الرموز؛
• loop-audit للتحقق من جاهزية الحلقة؛
• ملفات حالة وميزانية لسير العمل الأطول تشغيلًا؛
• دعمًا لمراجعة بشرية أكثر أمانًا وطرحًا تدريجيًا.

الرسالة الأساسية بسيطة:

توقّف عن كتابة المطالبات. صمّم الحلقة.

هذا لا يعني أن المطالبات تختفي. بل يعني أن المطالبات تصبح جزءًا من نظام أكبر يمكنه تكرار العمل، وتتبع الحالة، والتحقق من النتائج.

ابدأ بسرعة: أمر واحد

أسرع طريقة للبدء هي تشغيل loop-init داخل مشروع Git.

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

npx @cobusgreyling/loop-init . --pattern daily-triage --tool claude

ينشئ هذا الأمر هيكل الحلقة داخل مشروعك الحالي. يمكنك استبدال claude بأداة أخرى مدعومة مثل grok أو codex أو opencode، حسب سير العمل الذي تريد اختباره.

يُعد نمط daily-triage نقطة بداية جيدة للمبتدئين لأنه أقل مخاطرة من الأتمتة عالية التكرار. فهو يركز على فحص الحالة الحالية للمشروع وإنتاج تقرير قبل السماح بأي تغييرات تلقائية.

برنامج تعليمي مبسّط للمبتدئين في هندسة الحلقات

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

اللبنات الخمس بالإضافة إلى الذاكرة

على المستوى الأساسي، تُبنى الحلقة من خمسة أجزاء رئيسية، بالإضافة إلى الذاكرة والحالة.

لبنة البناء	ما الذي تفعله داخل الحلقة
الأتمتة / الجدولة	تشغّل الحلقة وفق وتيرة محددة، مثل يوميًا أو كل ساعة أو كل بضع دقائق.
أشجار العمل	تنشئ بيئات عمل معزولة حتى لا يقوم عدة وكلاء بالكتابة فوق عمل بعضهم بعضًا.
المهارات	تخزن معرفة المشروع القابلة لإعادة الاستخدام، والقواعد، وتعليمات المهام.
الإضافات والموصلات	تربط الحلقة بأدوات حقيقية عبر أنظمة مثل MCP أو GitHub أو Linear أو Slack.
الوكلاء الفرعيون	تفصل دور المنفّذ عن دور المدقق حتى لا يوافق الوكيل نفسه على عمله.
الذاكرة / الحالة	تحافظ على سياق دائم خارج نطاق

الدردشة، عادةً من خلال ملفات مثل STATE.md. |

تجعل هذه البنية الحلقة أسهل للفهم والتحليل. فأنت لا تطلب من النموذج أن «يتولى كل شيء» فحسب، بل تمنحه بيئة محددة، وجدولًا زمنيًا، وملف حالة، ومسارًا للتحقق، وقاعدة لتسليم الأمر إلى الإنسان.

سبعة أنماط إنتاج جاهزة للاستخدام

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

النمط	حالة الاستخدام النموذجية	وضع البدء المقترح
Daily Triage	فحص حالة المشروع، والمشكلات، وCI، والالتزامات.	L1 report-only
PR Babysitter	متابعة طلبات السحب خلال المراجعة، وCI، وإعادة التأسيس، والدمج.	L1 watch
CI Sweeper	مراقبة الفحوصات الفاشلة واقتراح إصلاحات صغيرة أو تطبيقها.	L2 cautious
Dependency Sweeper	فحص التبعيات القديمة وتحديثات الأمان.	L2 patch-only
Issue Triage	إزالة التكرار، وتقييم المشكلات الواردة، ووضع تسميات لها.	L1 propose-only
Post-Merge Cleanup	تنظيف عناصر TODO، والديون التقنية البسيطة، وأعمال المتابعة بعد عمليات الدمج.	L1 off-peak
Changelog Drafter	صياغة ملاحظات الإصدار من الالتزامات والتغييرات المدمجة.	L1 draft

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

أداة اختيار النمط التفاعلية

يوفر المشروع أيضًا أداة اختيار تفاعلية. بدلًا من اختيار نمط يدويًا، يمكنك البدء من نقطة ألم مثل: «طلبات السحب تبقى عالقة»، أو «CI يستمر في الفشل»، أو «المشكلات كثيرة الضجيج».

بعد ذلك توصي أداة الاختيار بنمط حلقة وتمنحك أمرًا للبدء. يكون هذا مفيدًا عندما تعرف المشكلة ولكنك غير متأكد من الحلقة التي ينبغي أن تتعامل معها.

شغّل حلقتك الأولى

إليك طريقة مناسبة للمبتدئين لتشغيل الحلقة الأولى مع إبقاء المخاطر تحت السيطرة.

الخطوة 1: اختر نمطًا

ابدأ بـ daily-triage إذا كانت هذه هي المرة الأولى لك. إنه نمط منخفض المخاطر وطريقة جيدة لفهم كيف تقرأ الحلقة حالة المشروع، وتكتب الملاحظات، وتجهز العمل للإنسان.

الخطوة 2: أنشئ هيكل الحلقة

شغّل أمر التهيئة في الدليل الجذر لمشروع Git الخاص بك.

npx @cobusgreyling/loop-init . --pattern daily-triage --tool claude

يمكنك تبديل اسم الأداة إذا كنت تستخدم وكيل برمجة ذكاء اصطناعي مختلفًا.

npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok
npx @cobusgreyling/loop-init . --pattern daily-triage --tool codex
npx @cobusgreyling/loop-init . --pattern daily-triage --tool opencode

يمكنك أيضًا استبدال daily-triage بنمط آخر مدعوم بعد أن تفهم التدفق الأساسي.

الخطوة 3: قدّر تكلفة الرموز

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

npx @cobusgreyling/loop-cost --pattern daily-triage --level L1

للاختبار المبكر، أبقِ الحلقة عند L1 وتجنب الجداول الزمنية العدوانية.

الخطوة 4: دقّق جاهزية الحلقة

قبل الوثوق بالحلقة، شغّل تدقيقًا. يمنح التدقيق المشروع درجة جاهزية من 0 إلى 100 ويقترح تحسينات.

npx @cobusgreyling/loop-audit . --suggest

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

إذا وصل المشروع إلى مستوى جاهزية جيد، يمكنك أيضًا إنشاء شارة Loop Ready لملف README الخاص بك.

npx @cobusgreyling/loop-audit . --badge

الخطوة 5: ابدأ بوضع التقارير فقط

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

بالنسبة إلى أمر حلقة بأسلوب Grok، يمكن أن يبدو التشغيل الأول هكذا:

/loop 1d Run loop-triage. Update STATE.md. No auto-fix in week one.

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

الخطوة 6: اقرأ الناتج

افتح STATE.md وتحقق مما وجدته الحلقة. يعمل هذا الملف كذاكرة خارج المحادثة. يجب أن يعرض ما رأته الحلقة، وما فعلته، وما تخطته، وما يحتاج إلى انتباه الإنسان.

إذا كان الناتج مليئًا بالضجيج أو خاطئًا، فاضبط الحلقة قبل زيادة الاستقلالية. يجب أن تصبح الحلقة المفيدة مملة، وقابلة للتنبؤ، وقابلة للفحص.

نضج الحلقة: من L1 إلى L3

ينبغي طرح Loop Engineering تدريجيًا. تساعدك مستويات النضج على تجنب منح قدر كبير من الحرية في وقت مبكر جدًا.

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

الهدف الأول الجيد ليس الاستقلالية الكاملة. الهدف الأول الجيد هو حلقة L1 موثوقة تمنحك معلومات مفيدة دون

مما يخلق عملاً إضافياً للتنظيف.

عملية الحلقة القياسية

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

1. مُشغِّل مجدول؛
2. فرز المهام؛
3. قراءة الحالة الحالية؛
4. إنشاء مساحة عمل معزولة؛
5. السماح للوكيل بالتنفيذ؛
6. تشغيل فحوصات التحقق؛
7. الاتصال بأنظمة Git أو أنظمة التذاكر؛
8. طلب تأكيد بشري عند الحاجة.

هذا هو الفرق الرئيسي بين مطالبة عابرة وحلقة حقيقية. فالوكيل لا “يقوم بأشياء” فحسب، بل يعمل داخل عملية مضبوطة تتضمن حالة، وعزلاً، وفحوصات، وتسليماً.

أندرو نغ: تطوير المنتجات يحتاج إلى ثلاث حلقات

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

1. حلقة الترميز الوكيلة

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

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

2. حلقة ملاحظات المطور

الطبقة التالية هي حلقة ملاحظات المطور. يستطيع الوكيل الاختبار والمراجعة، لكن المطور يظل يتحقق مما إذا كانت النتيجة تبدو مناسبة، وتنسجم مع اتجاه المنتج، وتحل مشكلة المستخدم الحقيقية.

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

3. حلقة الملاحظات الخارجية

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

وهذه الحلقة أبطأ مرة أخرى. فقد تستغرق ساعات أو أياماً أو أسابيع.

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

لماذا لا يزال الذوق البشري مهماً

هندسة الحلقات لا تُخرج البشر من تطوير البرمجيات. بل تغيّر دور الإنسان.

يستطيع الوكيل التعامل مع التنفيذ المتكرر، لكنه لا يزال يحتاج إلى حدود واضحة، وتحقق قوي، وحكم متعلق بالمنتج. ولا يزال الإنسان هو من يفهم السياق: ما يحتاجه المستخدمون، وما المقايضات المهمة، وما لا ينبغي أتمتته، وما معنى “جيد بما يكفي” فعلاً.

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

ملاحظة المصدر

المصدر الأصلي: مقال BAAI Hub، أُعيد نشره من QbitAI / WeChat. أشار المقال أيضاً إلى مستودع Loop Engineering على GitHub وإلى منشور أندرو نغ العام على X.

ملاحظة حول الصور: تم استبعاد صورة الميم الافتتاحية ولافتة الترويج النهائية التي تحتوي على رمز QR/معلومات تواصل من صفحة المصدر، لأنها ليست ضرورية لفهم الدليل. أما الصور المتبقية فأُدرجت فقط حيث تدعم الشرح التقني.

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

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

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

كيف أبدأ مشروعاً في هندسة الحلقات؟

أسرع نقطة بداية هي تشغيل npx @cobusgreyling/loop-init . --pattern daily-triage --tool claude داخل مشروع Git. وبالنسبة للمبتدئين، يكون daily-triage عادة أكثر أماناً من الحلقات عالية التكرار، لأنه يمكن أن يبدأ في وضع التقارير فقط.

لماذا تستخدم هندسة الحلقات ملف STATE.md؟

يوفر STATE.md ذاكرة دائمة للحلقة خارج جلسة الدردشة. فهو يساعد الحلقة على تذكر النتائج السابقة، والإجراءات الأخيرة، والعناصر غير المحسومة، والتجاوزات البشرية.

ما هي درجة Loop Ready؟

درجة Loop Ready هي نتيجة تدقيق ينتجها loop-audit. وهي تتحقق مما إذا كان لدى المشروع ما يكفي من البنية، والحالة، والتحقق، وحدود التكلفة، وضوابط السلامة لتشغيل حلقة بمسؤولية.

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

إنها

يمكن ذلك، لكن لا ينبغي أن يبدأ الأمر بهذه الطريقة. المسار الأكثر أمانًا هو البدء بالمستوى L1 بوضع التقارير فقط، ثم الانتقال إلى المستوى L2 بإصلاحات مُساعَدة مع التحقق، وبعد ذلك فقط إلى تشغيلات L3 غير المراقَبة عندما تصبح ضوابط النطاق والسلامة والتكلفة ناضجة.

لماذا يجب أن أقدّر تكلفة الرموز قبل تشغيل حلقة؟

قد تصبح الحلقات مكلفة إذا كانت تعمل كثيرًا، أو تستخدم سياقًا طويلًا، أو تُنشئ عدة وكلاء فرعيين. تساعدك loop-cost على تقدير الاستخدام قبل أن يستهلك سير عمل عالي التكرار الميزانية.

كيف ترتبط فكرة الحلقات الثلاث لأندرو نغ بهذا؟

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

أدوات ذات صلة

• Loop Engineering: أنماط ومشاريع بداية وأدوات سطر أوامر مفتوحة المصدر لتصميم حلقات وكلاء الذكاء الاصطناعي.
• Loop Engineering Showcase: عرض تفاعلي يتضمن الأنماط والمكوّنات الأساسية ومحاكي جاهزية.
• Node.js: بيئة تشغيل مطلوبة لاستخدام أدوات سطر الأوامر المعتمدة على npx.
• npm: منظومة حزم تُستخدم لتشغيل أوامر واجهة سطر الأوامر الخاصة بـ Loop Engineering عبر npx.
• Git: نظام تحكم في الإصدارات يُستخدم للمستودعات والتنفيذ المعزول المعتمد على شجرة العمل.
• GitHub Actions: منصة أتمتة يمكنها دعم الفحوصات المجدولة وسير عمل التحقق من الحلقات.
• Model Context Protocol: بروتوكول لربط أنظمة الذكاء الاصطناعي بالأدوات ومصادر البيانات الخارجية.

روابط ذات صلة

• مقال BAAI Hub الأصلي: المقال المصدر الذي يقدّم دليل Loop Engineering المناسب للمبتدئين.
• مستودع Loop Engineering على GitHub: المستودع الرئيسي للأنماط ومشاريع البداية والوثائق وأدوات سطر الأوامر.
• Loop Engineering Showcase: الصفحة التفاعلية الرسمية لاستكشاف الإطار.
• المكوّنات الخمسة الأساسية + الذاكرة: الشرح الرسمي للبنات الأساسية لبناء الحلقات.
• قائمة تحقق تصميم الحلقة: قائمة تحقق لتحديد ما إذا كانت الحلقة جاهزة للاستخدام في الإنتاج.
• دليل سلامة الحلقات: ملاحظات أمان حول الأتمتة، ومسارات قوائم الحظر، والمراجعة البشرية، والتحكم في المخاطر.
• تشغيل الحلقات: ملاحظات حول التكلفة، والتسجيل، وسجل التشغيل، والانضباط التشغيلي.
• ملف README لأنماط الحلقات: نظرة عامة على أنماط حلقات الإنتاج المتاحة.

الملخص

يشرح هذا الدليل كيف يحوّل Loop Engineering مطالبات الذكاء الاصطناعي المنفردة إلى سير عمل متكرر للوكلاء. تتمثل الفكرة الأساسية في تحديد الجدول الزمني، والحالة، والأدوات، والتحقق، وعملية المراجعة البشرية قبل الوثوق بوكيل ليتصرف بشكل متكرر.

بالنسبة للتشغيل الأول، تُعد daily-triage نقطة البداية الأكثر أمانًا. أنشئ هيكل الحلقة، وقدّر تكلفة الرموز، ودقّق الجاهزية، وأبقِ الأسبوع الأول في وضع التقارير فقط.

الدرس الأوسع ليس أن البشر سيختفون من عملية التطوير. يمكن للوكلاء التحرك بسرعة أكبر داخل الحلقات، لكن الحكم على المنتج، وحدود السلامة، وتعريف “الإنجاز” لا تزال تعتمد على البشر.

أفضل حلقة أولى ليست الأكثر استقلالية. بل هي الحلقة التي يمكنك فحصها، والثقة بها، وتحسينها.