حين ينكسر

وكيل البرمجة أصلح العطل وكسر ثلاثة أشياء أخرى

ويُسأل أيضًا الوكيل كسر كودًا يعمل · أعاد هيكلة ملفات لم أسأل عنها · حذف اختباراتي · حجم التغيير هائل

السبب موثّق من مزوّد أو ورقة منشورة لم يختبره benchr أول تسجيل آخر فحص

ما الذي يحدث فعلًا

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

لماذا

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

الإصلاح السريع

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

الإصلاح الحقيقي

اكتب الحدّ حيث سيقرؤه الوكيل: ملف AGENTS.md أو CLAUDE.md في جذر المستودع يذكر أمر البناء وأمر الاختبار والملفات التي لا تُمسّ وما يجب أن يتضمّنه أي تغيير. ثم اجعل التكامل المستمر هو البوابة لا انتباهك.

خطوة خطوة

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

مستند إلى

إلى أين يقودك هذا