รายงาน bug ที่ดีสำหรับ AI ก็เหมือนกับรายงาน bug ที่ดีสำหรับมนุษย์ นั่นคือ ให้ บริบทเพียงพอที่จะจำลองปัญหาได้ในหัวของมัน และตัดสิ่งรบกวนออกไป AI สามารถให้เหตุผลได้เฉพาะกับสิ่งที่คุณวางให้เท่านั้น คำอธิบายที่คลุมเครือก็จะได้การคาดเดาที่คลุมเครือ
รายงาน bug ที่ดีสำหรับ AI ก็เหมือนกับรายงาน bug ที่ดีสำหรับมนุษย์ นั่นคือ ให้ บริบทเพียงพอที่จะจำลองปัญหาได้ในหัวของมัน และตัดสิ่งรบกวนออกไป AI สามารถให้เหตุผลได้เฉพาะกับสิ่งที่คุณวางให้เท่านั้น คำอธิบายที่คลุมเครือก็จะได้การคาดเดาที่คลุมเครือ
ไฟล์ที่ไม่เกี่ยวข้อง config ทั้งหมดของคุณ secrets/API keys และทฤษฎีแบบ "ฉันคิดว่าน่าจะเป็น X" ที่ทำให้การวินิจฉัยมีอคติ ให้ข้อเท็จจริง ไม่ใช่การคาดเดา
❌ 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):
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
}
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 ที่กระชับยังทำให้คุณเป็นนักดีบักที่ดีขึ้นด้วยตัวเอง เพราะมันบังคับให้คุณแยกแยะข้อเท็จจริงออกมาก่อนที่จะถาม