ਤੁਸ AI ਸਹਾਇਕ ਨੂੰ ਬੱਗ ਦਾ ਵਰਣਨ ਕਿਵੇਂ ਕਰਦੇ ਹੋ ਤਾਂ ਜੋ ਉਹ ਇਸਨੂੰ ਸਹੀ ਤਰੀਕੇ ਨਾਲ ਨਿਦਾਨ ਕਰ ਸਕੇ?

Question

Accepted Answer

AI ਲਈ ਇੱਕ ਚੰਗੀ ਬੱਗ ਰਿਪੋਰਟ ਮਨੁੱਖ ਲਈ ਇੱਕ ਚੰਗੀ ਬੱਗ ਰਿਪੋਰਟ ਦੇ ਬਰਾਬਰ ਹੈ: ਇਸ ਨੂੰ **ਸਮੱਸਿਆ ਨੂੰ ਆਪਣੇ ਮਨ ਵਿੱਚ ਦੁਬਾਰਾ ਪੈਦਾ ਕਰਨ ਲਈ ਕਾਫ਼ੀ ਸੰਦਰਭ** ਦਿੱਤਾ ਜਾਵੇ, ਅਤੇ ਸ਼ੋਰ ਨੂੰ ਖਤਮ ਕਰ ਦਿੱਤਾ ਜਾਵੇ। AI ਸਿਰਫ ਉਸੀ ਚੀਜ਼ ਬਾਰੇ ਤਰਕ ਕਰ ਸਕਦਾ ਹੈ ਜੋ ਤੁਸ ਪੇਸਟ ਕਰੋ — ਅਸਪਸ਼ਟ ਵਰਣਨ ਅਸਪਸ਼ਟ ਅਨੁਮਾਨ ਪੈਦਾ ਕਰਦੇ ਹਨ।

## ਕੀ ਸ਼ਾਮਲ ਕਰਨਾ ਹੈ

- **ਸਹੀ ਤ੍ਰੁਟੀ ਸੁਨੇਹਾ ਅਤੇ ਪੂਰਾ stack trace** — ਇਸ ਨੂੰ ਅੱਖਰ-ਦਰ-ਅੱਖਰ ਕਾਪੀ ਕਰੋ, ਪੁਨਰ-ਬਿਆਨ ਨਹੀਂ। ਟ੍ਰੇਸ ਵਿੱਚ ਫ਼ਾਈਲ ਅਤੇ ਲਾਈਨ ਸਭ ਤੋਂ ਉਪਯੋਗੀ ਸੁਰਾਗ ਹਨ।
- **ਸੰਬੰਧਿਤ ਕੋਡ** — ਫ਼ੰਕਸ਼ਨ ਜੋ ਥ੍ਰੋ ਕਰਦਾ ਹੈ ਅਤੇ ਇਸਦੇ ਤਤਕਾਲ ਕਾਲਰ, ਪੂਰੇ ਰਿਪੋ ਨਹੀਂ।
- **ਸੰਭਾਵਿਤ ਬਨਾਮ ਅਸਲ ਵਿਵਹਾਰ** — "ਮੈਨੂੰ X ਦੀ ਉਮੀਦ ਹੈ, ਪਰ ਮੈਨੂੰ Y ਮਿਲਦਾ ਹੈ" ਕਿਸੇ ਵੀ ਬੱਗ ਰਿਪੋਰਟ ਦਾ ਮੂਲ ਹੈ।
- **ਦੁਬਾਰਾ ਪੈਦਾ ਕਰਨ ਦੇ ਕਦਮ** — ਸਹੀ ਇਨਪੁਟ ਜਾਂ ਕ੍ਰਮ ਜੋ ਇਸ ਨੂੰ ਟ੍ਰਿਗਰ ਕਰਦਾ ਹੈ।
- **ਵਾਤਾਵਰਣ/ਸੰਸਕਰਣ** — language, framework, ਅਤੇ library ਸੰਸਕਰਣ (ਇੱਕ ਬੱਗ ਸੰਸਕਰਣ-ਨਿਯੰਤ੍ਰਿਤ ਹੋ ਸਕਦਾ ਹੈ)।
- **DB schema ਜਾਂ ਨਮੂਨਾ ਡੇਟਾ** — ਜਦੋਂ ਬੱਗ ਇੱਕ ਖੋਜ ਜਾਂ ਡੇਟਾ ਰੂਪ ਨੂੰ ਛੂਹਦਾ ਹੈ।

## ਕੀ ਛੱਡਣਾ ਹੈ

ਗੈਰ-ਸੰਬੰਧਿਤ ਫ਼ਾਈਲਾਂ, ਤੁਹਾਡਾ ਪੂਰਾ config, ਸਿਕ੍ਰਿਤ/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 + ਸੰਸਕਰਣ) ਨਿਦਾਨ ਨੂੰ ਇੱਕ ਫੋਕਸਡ ਕੰਮ ਵਿੱਚ ਬਦਲ ਦਿੰਦੀ ਹੈ ਅਤੇ ਆਮ ਤੌਰ ਤੇ ਪਹਿਲੀ ਕੋਸ਼ਿਸ਼ 'ਤੇ ਸਹੀ ਫਿਕਸ ਮਿਲ ਜਾਂਦਾ ਹੈ। ਤੰਗ bug ਰਿਪੋਰਟ ਲਿਖਣਾ ਸਿੱਖਣਾ ਤੁਹਾਨੂੰ ਆਪ ਵੀ ਇੱਕ ਬਿਹਤਰ debugger ਬਣਾਉਂਦਾ ਹੈ, ਕਿਉਂਕਿ ਇਹ ਤੁਹਾਨੂੰ ਪੁੱਛਣ ਤੋਂ ਪਹਿਲਾਂ ਤੱਥ ਅਲੱਗ ਕਰਨ ਲਈ ਮਜ਼ਬੂਰ ਕਰਦਾ ਹੈ।