วิธีเขียนสเปกอย่างมีประสิทธิภาพสำหรับ AI Agent - Addy Osmani

• สิ่งที่สร้างความแตกต่างด้านประสิทธิภาพการทำงานของ AI Agent มากที่สุด → SPEC ที่ชัดเจนและมีโครงสร้าง
• SPEC ที่ไม่ดี = ความกำกวม → AI เกิด drift, ล้มเหลวซ้ำ ๆ, ใช้คอนเท็กซ์เกิน
• SPEC ที่ดี = เอกสารที่มีชีวิต (SPEC.md) + อัปเดตอย่างต่อเนื่อง

องค์ประกอบหลักของ SPEC ที่ดี

• เป้าหมาย / วิสัยทัศน์ (ทำไมถึงสร้าง, ทำเพื่อใคร)
• รายการฟีเจอร์ + ลำดับความสำคัญ
• เทคโนโลยีสแตก (ระบุให้ชัดเจน เช่น React 18 + TS, Node 20)
• คำสั่งสำหรับรันงาน (npm test, lint, build เป็นต้น)
• เกณฑ์การทดสอบ (ต้องรันทดสอบอะไรบ้างจึงจะถือว่าสำเร็จ)
• โครงสร้างโค้ด / แนวทางสไตล์
• Git workflow (กฎการตั้งชื่อ branch, ข้อความ commit)
• การกำหนดขอบเขต (✅ ทำเสมอ / ⚠️ ถามก่อน / 🚫 ห้ามทำเด็ดขาด)

รูปแบบพรอมป์ต์เริ่มต้นที่มีประสิทธิภาพ

• “Draft a detailed specification for … covering objectives, features, constraints, step-by-step plan”
• ใช้ Plan Mode ก่อน → ให้ AI ช่วยร่าง SPEC ฉบับแรก
• จากนั้นค่อยแตกงานเป็นหน่วยเล็ก ๆ แล้วสั่งทีละส่วน

เคล็ดลับใช้งานจริง (เฉพาะแก่นสำคัญ)

• แยกเก็บไฟล์ SPEC.md ต่างหาก → ใส่งานแต่ละครั้งเฉพาะส่วนที่เกี่ยวข้อง
• ทำให้เป็นโมดูล + แยกเป็นงานย่อย
• หลังจบแต่ละงานให้รันทดสอบอัตโนมัติ + ตรวจว่าเป็นไปตาม SPEC หรือไม่
• กำหนดกฎขอบเขต 3 ระดับให้ชัดเจน (Always / Ask / Never)