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

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

يوضّح هذا الدليل كيفية بناء حلقة التغذية الراجعة تلك بحيث يلتقط وكيلك أخطاءه قبل أن تلتقطها أنت.

الفكرة الجوهرية: ينبغي أن تتدفّق الأخطاء عائدةً إلى السياق

يتألّف سير عمل الوكيل الموثوق من أربع مراحل — الاستكشاف، والتخطيط، والبناء، والتحقّق. ويتوقّف معظم الناس عند مرحلة "البناء". وخطوة التحقّق هي ما يفصل بين وكيل يُنتج كودًا يعمل وآخر يُنتج كودًا يبدو معقولًا فحسب.

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

يمكنك فعل ذلك بطريقتين: أن تطلبه في تعليمات مشروعك، أو أن تجعله آليًا بحيث لا يمكن تخطّيه.

الخيار الأول: اطلبه ببساطة، في تهيئة مشروعك

النسخة الأقل جهدًا هي سطر في ملف CLAUDE.md أو AGENTS.md (ملف التعليمات النصّي البسيط الذي يقرأه معظم الوكلاء عند بدء التشغيل):

## Verification
After any code change, run `npm run typecheck && npm test`.
If either fails, fix the cause and re-run before reporting done.

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

الخيار الثاني: أتمتته باستخدام hook

تتيح لك hooks في Claude Code تشغيل أمر صدفة (shell) استجابةً لأحداث دورة الحياة، بصرف النظر عمّا إذا كان النموذج يتذكّر ذلك أم لا. والـ hook المعني هنا هو PostToolUse، الذي يُطلَق بعد أن يحرّر الوكيل ملفًا. وكما يوضّح أحد أدلة الـ hooks العملية، فإن PostToolUse مُصمَّم للتفاعلات — التنسيق، والتسجيل، وتشغيل الاختبارات — ويتم حقن مخرجاته عائدةً إلى سياق الوكيل للتأثير في خطوته التالية.

إليك hook بسيطًا للغاية يشغّل مدقّق الأنواع لديك بعد أي تحرير لملف ويعيد حالات الفشل إلى الوكيل. في ملف .claude/settings.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npm run typecheck"
          }
        ]
      }
    ]
  }
}

الآن أصبحت الدورة آلية: يكتب الوكيل الكود ← يشغّل الـ hook الأمر tsc ← إذا وُجد خطأ في النوع، يتدفّق النصّ عائدًا كسياق ← يصلحه الوكيل ← يعمل الـ hook مجددًا. ويوثّق مرجع الـ hooks كيف يظهر رمز الخروج غير الصفري والمخرجات للنموذج. وتعمل هذه الحلقة عند كل عملية كتابة، دون أي مطالبة.

أبقِ الحلقة سريعة ومحدّدة النطاق

لا تكون حلقة التغذية الراجعة مفيدة إلا إذا كانت سريعة. وإليك بعض القواعد التوجيهية العامة:

• شغّل الفحوصات الرخيصة عند كل تحرير، والمكلفة منها بوتيرة أقل. فحص الأنواع أو الـ linter على الملف المُعدَّل سريع. أما مجموعة اختبارات التكامل الكاملة فليست كذلك — اجعلها مشروطة بـ Stop hook (عندما ينهي الوكيل دوره) أو بأمر يدوي، لا عند كل ضغطة مفتاح.
• حدّد النطاق بما تغيّر. تشغيل مجموعة اختباراتك بالكامل بعد تعديل سطر واحد من CSS يهدر الوقت ويُغرق السياق. وحيثما تتيح أدواتك ذلك، استهدف الملفات المتأثّرة.
• اجعل حالات الفشل مقروءة. الوكيل لا يصلح إلا ما يستطيع قراءته. فأدوات الـ linter ومدقّقات الأنواع التي تقدّم رسائل خطأ واضحة ومحدَّدة الموقع (file:line: message) تمنح النموذج تحديدًا ما يحتاجه؛ أما رسالة "build failed" العامة فلا تفعل ذلك.

مثال ملموس قبل وبعد

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

مع الحلقة: تشغّل عملية إعادة التسمية نفسها فحص typecheck عند الحفظ. فيُبلّغ tsc عن Cannot find name 'oldFn' عند موضع الاستدعاء الذي فاته. يصل هذا الخطأ إلى السياق، فيفتح الوكيل الملف الرابع، ويصلح المرجع، فينجح الفحص التالي — كل ذلك قبل أن يخبرك بأنه أنهى المهمة.

الخلاصة

وكلاء الذكاء الاصطناعي بارعون في إنتاج الكود وضعفاء في ملاحظة متى يكون خاطئًا. وتسدّ تلك الفجوة بأن تمنحهم الإشارة نفسها التي تعتمد عليها: اختبار أحمر، أو خطأ في النوع، أو قاعدة linting فاشلة — تُسلَّم تلقائيًا، مباشرةً بعد التغيير. ابدأ بسطر واحد في تعليمات مشروعك، ثم رقِّ فحصك الأهم إلى hook بحيث يعمل سواء تذكّره النموذج أم لا. فالوكلاء الذين يبدون "أذكياء" هم في العادة مجرّد أولئك الموصولين بحلقة تغذية راجعة محكمة.