आप किसी AI assistant को किसी bug का वर्णन कैसे करते हैं ताकि वह उसका सटीक निदान कर सके?

Question

Accepted Answer

AI के लिए एक अच्छी bug report वैसी ही होती है जैसी किसी इंसान के लिए: उसे **समस्या को अपने दिमाग में reproduce करने के लिए पर्याप्त context दें**, और शोर हटा दें। AI केवल उसी पर तर्क कर सकता है जो आप paste करते हैं — अस्पष्ट विवरण अस्पष्ट अनुमान पैदा करते हैं।

## क्या शामिल करें

- **सटीक error message और पूरा stack trace** — इसे हूबहू copy करें, paraphrase न करें। trace में मौजूद file और line सबसे उपयोगी सुराग होते हैं।
- **संबंधित code** — जो function throw करता है साथ ही उसके तत्काल callers, न कि पूरा repo।
- **Expected बनाम actual behavior** — "मैं X की उम्मीद करता हूँ, पर मुझे Y मिलता है" किसी भी bug report का मूल है।
- **Repro steps** — वह सटीक input या sequence जो इसे trigger करता है।
- **Environment/versions** — language, framework, और library versions (एक bug version-specific हो सकता है)।
- **DB schema या sample data** — जब bug किसी query या data shape को छूता हो।

## क्या छोड़ दें

असंबंधित files, आपका पूरा config, secrets/API keys, और "मुझे लगता है यह शायद X हो" जैसी theories जो निदान को पक्षपाती बनाती हैं। तथ्य दें, अंदाज़े नहीं।

## कमज़ोर बनाम मज़बूत 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 सीधे गायब `undefined` check की ओर इशारा कर सकता है और एक guard का सुझाव दे सकता है, क्योंकि उसे जो भी तथ्य चाहिए वह page पर मौजूद है।

## यह क्यों महत्वपूर्ण है

एक AI assistant के पास **आपके चल रहे system तक कोई पहुँच नहीं होती** — वह केवल उसी से तर्क करता है जो आप देते हैं। एक कमज़ोर report उसे एक साथ error, code, और environment सभी का अनुमान लगाने पर मजबूर करती है, और एक गलत अनुमान एक round-trip बर्बाद कर देता है। एक मज़बूत report (सटीक trace + संबंधित code + expected/actual + repro + versions) निदान को एक केंद्रित कार्य में बदल देती है और आमतौर पर पहली ही कोशिश में सही fix दिलाती है। तंग bug reports लिखना सीखना आपको स्वयं एक बेहतर debugger भी बनाता है, क्योंकि यह आपको पूछने से पहले तथ्यों को अलग करने पर मजबूर करता है।