तपाईंले AI सहायकलाई बग कसरी वर्णन गर्नुहुन्छ ताकि यसले सटीकतुसँग निदान गर्न सकोस्?

Question

Accepted Answer

मानिसलाई दिने राम्रो बग रिपोर्ट जस्तै, AI लाई दिने राम्रो बग रिपोर्ट पनि एक जैसै हो: यसलाई **समस्या आफ्नो दिमागमा पुनरुत्पादन गर्न पर्याप्त सन्दर्भ दिनुहोस्**, र आवाज कमियो। AI केवल तपाईंले पेस्ट गरेको कुराको बारेमा तर्क गर्न सक्छ — अस्पष्ट विवरणले अस्पष्ट अनुमान उत्पन्न गर्छ।

## के समावेश गर्नुहोस्

- **सटीक त्रुटि संदेश र पूरा stack trace** — यसलाई शब्दशः कपी गर्नुहोस्, परिशोधन गर्न नहीं। ट्रेसमा रहेको फाइल र लाइन एकल सबैभन्दा उपयोगी सुझ हो।
- **सम्बन्धित कोड** — यो फेंक गर्ने प्रकार्य र यसका तत्काल कलकर्ताहरू, पूरो repo नहीं।
- **अपेक्षित बनाम वास्तविक व्यवहार** — "मैले X अपेक्षा गर्छु, तर मैले Y पाउँछु" कुनै पनि बग रिपोर्टको मूल हो।
- **Repro steps** — सटीक इनपुट वा अनुक्रम जसले यसलाई ट्रिगर गर्छ।
- **वातावरण/संस्करण** — भाषा, फ्रेमवर्क, र लाइब्रेरी संस्करण (एक बग संस्करण-विशिष्ट हुन सक्छ)।
- **DB schema वा नमूना डेटा** — जब बग क्वेरी वा डेटा आकार छोएको हुन्छ।

## के छोड्नुहोस्

असम्बन्धित फाइलहरू, तपाईंको सम्पूर्ण कन्फिग, गोप्य/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 सहायकको **तपाईंको चलिरहेको प्रणालीमा कुनै पहुँच छैन** — यो केवल तपाईंले प्रदान गरेको कुराबाट तर्क गर्छ। कमजोर रिपोर्टले यसलाई त्रुटि, कोड, र वातावरण सबको बारेमा अनुमान गर्न बाध्य गर्छ, र एक गलत अनुमान एक राउन्ड-ट्रिप बर्बाद गर्छ। एक शक्तिशाली रिपोर्ट (सटीक trace + सम्बन्धित कोड + अपेक्षित/वास्तविक + repro + संस्करण) निदानलाई एक केन्द्रीभूत कार्यमा बदलाएको र सामान्यतः पहिलो प्रयासमा सही मरम्मत पाउँछ। तपाईंले स्वयं एक राम्रो डिबगर बन्न पनि सीख्नुहोस्, किनभने यसले तपाईंलाई प्रश्न सोध्नु अगाडि तथ्यहरू अलग गर्न बाध्य गर्छ।