તમે AI સહાયકને બગ કેવી રીતે વર્ણવો છો જેથી તે તેને સચોટ રીતે નિદાન કરી શકે?

Question

Accepted Answer

AI ને સારી બગ રિપોર્ટ એ માનવને સારી બગ રિપોર્ટ જેવી જ છે: તેને **સમસ્યાને તેના મનમાં પુનર્ઉત્પાદિત કરવા માટે પર્યાપ્ત સંદર્ભ આપો**, અને ઘોંઘાટ ઘટાવો. AI તમે જે પેસ્ટ કરો તે વિશે જ તર્ક કરી શકે છે — અસ્પષ્ટ વર્ણનો અસ્પષ્ટ અનુમાન ઉત્પન્ન કરે છે.

## શું સમાવવું

- **ચોક્કસ ભૂલ સંદેશ અને સંપૂર્ણ સ્ટેક ટ્રેસ** — તેને સરસરીથી નકલ કરો, પુનર્વર્ણન નહીં. ટ્રેસમાં ફાઇલ અને લાઇન સૌથી વધુ ઉપયોગી સંકેત છે.
- **સંબંધિત કોડ** — ફંક્શન જે ફેંકે છે અને તેના તાત્કાલિક કૉલર્સ, આખો રેપો નહીં.
- **અપેક્ષિત વર્ષ વર્તમાન વર્તન** — "મને X અપેક્ષા છે, પરંતુ મને Y મળે છે" કોઈ પણ બગ રિપોર્ટનું મૂળ છે.
- **રિપ્રો પગલાંઓ** — ચોક્કસ ઇનપુટ અથવા ક્રમ જે તેને ટ્રિગર કરે છે.
- **પર્યાવરણ/સંસ્કરણો** — ભાષા, ફ્રેમવર્ક અને લાઇબ્રેરી સંસ્કરણો (બગ સંસ્કરણ-વિશિષ્ટ હોઈ શકે છે).
- **DB સ્કીમા અથવા નમૂના ડેટા** — જ્યારે બગ પ્રશ્ન અથવા ડેટા આકારને સ્પર્શ કરે.

## શું બહાર કાઢવું

ગેર-સંબંધિત ફાઇલો, તમારી આખી કોન્ફિગ, રહસ્યો/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 સહાયક પાસે **તમારી ચલતી સિસ્ટમમાં કોઈ પ્રવેશ નથી** — તે ફક્ત જે તમે પ્રદાન કરો તેમાંથી જ તર્ક કરે છે. નબળી રિપોર્ટ તેને એક સાથે ભૂલ, કોડ અને પર્યાવરણ આગળ વધવાની જરૂર પર બાધ્ય કરે છે, અને ખોટો અનુમાન રાઉન્ડ-ટ્રિપ બગાડે છે. એક મજબૂત રિપોર્ટ (ચોક્કસ ટ્રેસ + સંબંધિત કોડ + અપેક્ષિત/વર્તમાન + રિપ્રો + સંસ્કરણો) નિદાનને ધ્યાનફોકસ્ડ કાર્યમાં ફેરવે છે અને સામાન્યતः પ્રથમ પ્રયાસમાં સાચો સુધાર મેળવે છે. ચોક્કસ બગ રિપોર્ટો લખવાનું શીખવું પણ તમને તમારા જાતના બેહતર ડીબગર બનાવે છે, કારણ કે તે તમને પૂછતા પહેલાં તથ્યોને અલગ કરવાની ફરજ પાડે છે.