آپ کسی بگ کو AI اسسٹنٹ کو کیسے بیان کرتے ہیں تاکہ وہ اسے درست طریقے سے تشخیص کر سکے؟

Question

Accepted Answer

ایک اچھی bug report ایک AI کو دینا انسان کو دینے جیسا ہی ہے: اسے **مسئلے کو اپنے سر میں دوبارہ پیدا کرنے کے لیے کافی context دیں**، اور شور کو ختم کریں۔ AI صرف انہی چیزوں کے بارے میں سوچ سکتا ہے جو آپ paste کریں — مبہم تفصیلات مبہم اندازے دیتی ہیں۔

## شامل کرنے کی چیزیں

- **بالکل غلط پیغام اور مکمل stack trace** — اسے اپنے الفاظ میں نقل کریں، نہ کہ دوبارہ بیان کریں۔ trace میں فائل اور لائن سب سے زیادہ مفید سراغ ہیں۔
- **متعلقہ code** — وہ function جو throw کرتا ہے اور اس کے فوری کالرز، پوری repo نہیں۔
- **متوقع بمقابلہ حقیقی رویہ** — "میں X کی توقع رکھتا ہوں، لیکن مجھے Y ملتا ہے" کسی بھی bug report کا بنیادی حصہ ہے۔
- **Repro اقدامات** — بالکل وہ input یا sequence جو اسے trigger کرتے ہیں۔
- **ماحول/ورژن** — language، framework، اور library versions (ایک bug ورژن کے لحاظ سے ہو سکتا ہے)۔
- **DB schema یا sample data** — جب bug کسی query یا data shape کو چھوئے۔

## کیا نہیں رکھنا ہے

غیر متعلقہ فائلیں، آپ کا پوری config، secrets/API keys، اور "مجھے لگتا ہے کہ یہ X ہو سکتا ہے" نظریات جو تشخیص کو متعصب بناتے ہیں۔ حقائق دیں، نہ کہ اندازے۔

## کمزور بمقابلہ مضبوط report

```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.
```

مضبوط ورژن کے ساتھ، AI براہ راست missing `undefined` check کی طرف اشارہ کر سکتا ہے اور ایک guard تجویز کر سکتا ہے، کیونکہ ہر وہ حقیقت جس کی اسے ضرورت ہے وہ صفحے پر ہے۔

## یہ کیوں اہم ہے

ایک AI اسسٹنٹ کے پاس **آپ کے چلتے ہوئے نظام تک رسائی نہیں ہے** — یہ صرف اس چیز سے سوچتا ہے جو آپ فراہم کرتے ہیں۔ ایک کمزور report اسے غلطی، code، اور ماحول سب کا اندازہ لگانے پر مجبور کرتا ہے، اور ایک غلط اندازہ ایک round-trip کو ضائع کرتا ہے۔ ایک مضبوط report (بالکل trace + متعلقہ code + متوقع/حقیقی + repro + versions) تشخیص کو ایک مرکوز کام میں بدل دیتا ہے اور عام طور پر پہلی کوشش میں صحیح حل دیتا ہے۔ سخت bug reports لکھنا سیکھنا آپ کو ایک بہتر debugger بھی بناتا ہے، کیونکہ یہ آپ کو پوچھنے سے پہلے حقائق کو الگ کرنے پر مجبور کرتا ہے۔