तुम बग चे वर्णन AI सहाय्यकाला कसे करता हे की तो ते अचूकपणे निदान करू शकेल?

Question

Accepted Answer

AI साठी एक चांगली बग अहवाल एक मानवासाठी एक चांगली बग अहवाल सारखीच आहे: त्याला **समस्या त्याच्या डोक्यात पुन: निर्माण करण्यासाठी पुरेसा संदर्भ द्या**, आणि आवाज कमी करा। AI केवळ जे आपण पेस्ट करता त्याबद्दलच विचार करू शकते — अस्पष्ट वर्णन अस्पष्ट अनुमान तयार करतात.

## काय समाविष्ट करायचे

- **अचूक त्रुटी संदेश आणि संपूर्ण स्टॅक ट्रेस** — हे शब्दशः कॉपी करा, पुनर्मांडन नाही. ट्रेसमधील फाइल आणि ओळ हे सर्वात उपयुक्त सुराग आहे.
- **प्रासंगिक कोड** — कोड जो फेकतो तसेच त्याचे तात्काळ कॉलर्स, संपूर्ण रेपो नाही.
- **अपेक्षित बनाम वास्तविक आचरण** — "मी 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.
```

मजबूत आवृत्तीसह, AI हरवलेल्या `undefined` तपासणीवर सरळ बिंदू देऊ शकतो आणि संरक्षण प्रस्तावित करू शकतो, कारण त्याला आवश्यक असलेले प्रत्येक तथ्य पृष्ठावर आहे.

## हे महत्वाचे का आहे

AI सहाय्यकाला **तुमच्या चालत्या सिस्टमवर प्रवेश नाही** — हे केवळ तुम्ही प्रदान केलेल्या गोष्टींवरून विचार करते. कमजोर अहवाल त्याला एकाच वेळी त्रुटी, कोड आणि पर्यावरण अनुमान करण्यास भाग पाडते, आणि चुकीचा अनुमान राउंड-ट्रिप वेस्ट करतो. शक्तिशाली अहवाल (अचूक ट्रेस + प्रासंगिक कोड + अपेक्षित/वास्तविक + repro + आवृत्ती) निदान एक केंद्रित कार्यात बदलतो आणि सामान्यत: पहिल्या प्रयत्नात योग्य निराकरण मिळवतो. कसून बग अहवाल लिहिणे शिकल्याने तुम्ही एक चांगले डीबगर्स देखील व्हा, कारण हे तुम्हाला विचारण्यापूर्वी तथ्य वेगळे करण्यास भाग पाडते.