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

Question

Accepted Answer

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

## ما يجب تضمينه

- **رسالة الخطأ الدقيقة و full stack trace كاملة** — انسخها حرفياً، وليس إعادة صياغة. الملف والسطر في التتبع هو الدليل الأكثر فائدة.
- **الكود ذو الصلة** — الدالة التي تطرح الاستثناء بالإضافة إلى المتصلين المباشرين بها، وليس المستودع بأكمله.
- **السلوك المتوقع مقابل السلوك الفعلي** — "أتوقع X، لكنني أحصل على Y" هو جوهر أي تقرير خطأ.
- **خطوات إعادة الإنتاج** — الإدخال أو التسلسل الدقيق الذي يثيره.
- **البيئة/الإصدارات** — لغة البرمجة وإصدارات الإطار والمكتبات (قد يكون الخطأ خاصاً بالإصدار).
- **مخطط قاعدة البيانات أو بيانات عينة** — عندما يمس الخطأ استعلام أو شكل بيانات.

## ما يجب تركه

ملفات غير ذات صلة، كامل إعدادك، الأسرار/مفاتيح API، و "أعتقد أنها قد تكون X" نظريات تنحاز إلى التشخيص. أعطِ الحقائق، وليس الافتراضات.

## تقرير ضعيف مقابل تقرير قوي

```text
❌ WEAK: "My login is broken, it throws an error. Why?"
   → no error text, no code, no repro → the AI can only guess

✅ STRONG:
   Error (verbatim):
     TypeError: Cannot read properties of undefined (reading 'id')
       at getUser (auth.js:42)
   Code (auth.js:40-43):
```

```js
function getUser(token) {
  const session = sessions.find(s => s.token === token); // returns undefined if not found
  return session.user.id; // line 42: crashes when session is undefined
}
```

```text
   Expected: return null for an unknown token.
   Actual:   throws TypeError above.
   Repro:    call getUser('expired-token').
   Env:      Node 20, no framework.
```

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

## لماذا يهم

mساعد الذكاء الاصطناعي **ليس لديه وصول إلى النظام قيد التشغيل** — يفكر فقط فيما تقدمه. تقرير ضعيف يجبره على التخمين في الخطأ والكود والبيئة في نفس الوقت، والتخمين الخاطئ يهدر جولة ذهاب وإياب. التقرير القوي (التتبع الدقيق + الكود ذو الصلة + المتوقع/الفعلي + خطوات إعادة الإنتاج + الإصدارات) يحول التشخيص إلى مهمة موجهة وعادة ما يحصل على الإصلاح الصحيح من المرة الأولى. تعلم كتابة تقارير أخطاء محكمة يجعلك أيضاً محقق أخطاء أفضل، لأنها تجبرك على عزل الحقائق قبل السؤال.