คุณจะอธิบาย bug ให้ AI assistant อย่างไรเพื่อให้มันวินิจฉัยได้อย่างแม่นยำ?

Question

Accepted Answer

รายงาน bug ที่ดีสำหรับ AI ก็เหมือนกับรายงาน bug ที่ดีสำหรับมนุษย์ นั่นคือ ให้ **บริบทเพียงพอที่จะจำลองปัญหาได้ในหัวของมัน** และตัดสิ่งรบกวนออกไป AI สามารถให้เหตุผลได้เฉพาะกับสิ่งที่คุณวางให้เท่านั้น คำอธิบายที่คลุมเครือก็จะได้การคาดเดาที่คลุมเครือ

## สิ่งที่ควรใส่เข้าไป

- **ข้อความ error ที่แน่นอนและ stack trace แบบเต็ม** คัดลอกมาแบบคำต่อคำ ไม่ใช่ถอดความ ไฟล์และบรรทัดใน trace คือเบาะแสที่มีประโยชน์ที่สุด
- **โค้ดที่เกี่ยวข้อง** ฟังก์ชันที่ throw บวกกับ caller ที่เรียกมันโดยตรง ไม่ใช่ทั้ง repo
- **พฤติกรรมที่คาดหวังเทียบกับที่เกิดขึ้นจริง** "ฉันคาดว่าจะได้ X แต่กลับได้ Y" คือแก่นของรายงาน bug ทุกฉบับ
- **ขั้นตอนการ reproduce** input หรือลำดับที่แน่นอนซึ่งทำให้เกิดปัญหา
- **Environment/เวอร์ชัน** เวอร์ชันของภาษา framework และ library (bug อาจขึ้นอยู่กับเวอร์ชันได้)
- **DB schema หรือข้อมูลตัวอย่าง** เมื่อ bug เกี่ยวข้องกับ query หรือรูปแบบของข้อมูล

## สิ่งที่ควรตัดออก

ไฟล์ที่ไม่เกี่ยวข้อง config ทั้งหมดของคุณ secrets/API keys และทฤษฎีแบบ "ฉันคิดว่าน่าจะเป็น 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` ที่ขาดหายไปและเสนอ guard ได้ เพราะข้อเท็จจริงทุกอย่างที่มันต้องการอยู่บนหน้าจอแล้ว

## ทำไมจึงสำคัญ

AI assistant **ไม่มีสิทธิ์เข้าถึงระบบที่กำลังรันอยู่ของคุณ** มันให้เหตุผลได้เฉพาะจากสิ่งที่คุณให้เท่านั้น รายงานที่อ่อนแอบังคับให้มันต้องเดาทั้ง error โค้ด และ environment พร้อมกันหมด และการเดาผิดก็ทำให้เสียรอบการสื่อสารไปเปล่า ๆ รายงานที่หนักแน่น (trace ที่แน่นอน + โค้ดที่เกี่ยวข้อง + ที่คาดหวัง/ที่เกิดจริง + repro + เวอร์ชัน) เปลี่ยนการวินิจฉัยให้กลายเป็นงานที่โฟกัส และมักได้คำตอบที่ถูกต้องตั้งแต่ครั้งแรก การเรียนรู้ที่จะเขียนรายงาน bug ที่กระชับยังทำให้คุณเป็นนักดีบักที่ดีขึ้นด้วยตัวเอง เพราะมันบังคับให้คุณแยกแยะข้อเท็จจริงออกมาก่อนที่จะถาม