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

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

لماذا تعلق الوكلاء

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

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

لذا عندما يكرّر وكيل خطأً، فهو عادةً ليس عنيدًا — بل يغرق في سياق مُلوَّث. أصلِح السياق، لا موقف الوكيل.

الخطوة 1: أعِد الضبط بدل إعادة الشرح

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

• في Claude Code، يُرجِع /rewind المحادثة وأيضًا تغييرات الملفات إلى نقطة تحقّق سابقة — استخدمه عندما تسير الخطوات القليلة الأخيرة على نحو خاطئ ولكن العمل السابق يستحقّ الإبقاء عليه (اضغط Esc مرّتين للوصول إلى القائمة نفسها). أما /clear فيمسح المحادثة بالكامل ويبدأ من جديد مع إبقاء شيفرتك سليمة — استخدمه عندما تنحرف الجلسة بأكملها عن مسارها. ويلخّص /compact السجلّ في صيغة أقصر عندما تريد المتابعة ببصمة أخفّ. (راجع أفضل ممارسات Claude Code.)
• في Cursor أو أداة قائمة على الدردشة، ابدأ محادثة جديدة للمهمة العالقة بدلًا من الاستمرار في المحادثة المسمومة.

سياق نظيف بتعليمة واحدة واضحة يتفوّق على سياق طويل بخمس تعليمات متزايدة الإحباط.

الخطوة 2: امنح التصحيح موطنًا دائمًا

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

• Claude Code: ملف CLAUDE.md في جذر مستودعك.
• Cursor: ملف قواعد (مثل .cursor/rules/).
• أي وكيل: ملف AGENTS.md، المدعوم على نطاق واسع الآن.

اكتب القاعدة كعبارة مسطّحة قابلة للاختبار. لا "حاوِل كتابة شيفرة نظيفة"، بل: "استخدم fetch، ولا تستخدم axios أبدًا. هذا المشروع لا يحتوي على اعتمادية axios."

الخطوة 3: اجعل القيد مستحيل التجاهل

إليك مثالًا ملموسًا. لنقُل إن وكيلك يستمرّ في استيراد مكتبة تواريخ أزلتها:

// Agent keeps writing this:
import moment from 'moment'
const now = moment().format('YYYY-MM-DD')

أخبرته ثلاث مرات أن يستخدم واجهة Intl المُدمجة بدلًا من ذلك. وبدلًا من تصحيح رابع، أضِف سطرًا واحدًا إلى CLAUDE.md:

## Dates
Never import `moment` or `dayjs` — they are not installed.
Format dates with the built-in `Intl.DateTimeFormat`. Example:
`new Intl.DateTimeFormat('en-CA').format(new Date())` → "2026-07-04"

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

الخطوة 4: امنح الوكيل وسيلة لمراجعة نفسه

يكرّر الوكلاء الأخطاء التي لا يستطيعون رؤيتها. أغلِق الحلقة بمنح الوكيل إشارةً يمكنه قراءتها:

• قاعدة مُدقِّق (linter) أو اختبار يفشل عند الخطأ بالضبط. إذا كان moment محظورًا في مُدقِّقك، يُشغّل الوكيل المُدقِّق، فيرى الخطأ، ويُصلِحه — من دون أن تكون أنت في الحلقة.
• قائمة تحقّق سريعة لـ "تعريف الإنجاز" في تعليماتك: "قبل أن تنتهي، شغّل npm run lint وnpm test وتأكّد من نجاحهما معًا."

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

الخطوة 5: قلّص حجم المهمة

إذا علق الوكيل في دوّامة عند طلب كبير وغامض ("أعِد هيكلة نظام المصادقة")، فهو غالبًا ضائع في النطاق، لا في التفصيل. جزّئ العمل إلى خطوة صغيرة واحدة قابلة للتحقّق في كل مرة — "استخرِج منطق تجديد الرمز (token) إلى دالّته الخاصة، دون تغيير السلوك" — وأكّد كل خطوة قبل الانتقال إلى التالية. فالمهام الصغيرة تترك مجالًا أقلّ للتشتّت.

النمط

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