Spec

Spec (ย่อจาก specification) คือเอกสารที่บรรยายอย่างละเอียดว่าสิ่งที่กำลังจะสร้าง "ต้องทำอะไรได้บ้าง" และ "แบบไหนถึงถือว่าผ่าน" ก่อนจะลงมือสร้างจริง แนวคิดนี้อยู่คู่วงการซอฟต์แวร์มานานในชื่อ Software Requirements Specification (SRS): เอกสารบรรยายระบบที่จะพัฒนา ครอบคลุมทั้ง functional requirements (ระบบต้องทำอะไร) และ non-functional requirements (เช่น ความเร็ว ความปลอดภัย) และมักมี use case อธิบายว่าผู้ใช้จะโต้ตอบกับระบบอย่างไร เอกสารนี้ทำหน้าที่คล้ายสัญญาระหว่างผู้ว่าจ้างกับทีมพัฒนา ช่วยลดการรื้องานแก้ใหม่ที่มีต้นทุนสูง และมีมาตรฐานสากลอย่าง ISO/IEC/IEEE 29148 กำกับคุณภาพ: requirement ที่ดีต้องชัดเจนไม่กำกวม ครบถ้วน สอดคล้องกัน และตรวจสอบได้จริง

ในยุค AI คำนี้กลับมาสำคัญอีกครั้ง เพราะสมการเดิมที่ว่า "โค้ดคือของจริง ส่วน spec คือนั่งร้านที่เขียนแล้วทิ้ง" ถูกพลิกกลับด้าน GitHub อธิบายว่าโมเดล AI เก่งเรื่องเติม pattern แต่อ่านใจคนไม่ได้: ถ้าเราสั่ง agent ด้วย prompt สั้นๆ คลุมเครือ เช่น "ทำระบบแชร์รูป" โมเดลจะเดาสิ่งที่เราไม่ได้พูดออกมาเอง แล้วเรามักมารู้ว่ามันเดาผิดตอนงานเดินไปไกลแล้ว spec ที่เขียนดีจึงเปลี่ยนสถานะจากเอกสารนิ่งๆ เป็นสัญญาที่ประมวลผลได้: เมื่อ spec คือสิ่งที่กำหนดว่า AI จะสร้างอะไรออกมา แหล่งความจริงของโปรเจกต์ก็ย้ายจากตัวโค้ดไปอยู่ที่เจตนา (intent) ที่บันทึกไว้ใน spec

ตัวอย่างที่จับต้องได้คือ Spec Kit: toolkit แบบ open source จาก GitHub สำหรับแนวทาง Spec-Driven Development ที่ให้ spec เป็นชิ้นงานหลักของโปรเจกต์ แล้วให้ AI สร้างงานออกมาจาก spec โดยตรง ผ่านขั้นตอนหลักคือ specify (เก็บความต้องการและ user story) · plan (วางแนวทางเทคนิคและสถาปัตยกรรม) · tasks (ซอยเป็นงานย่อยที่ตรวจได้ทีละชิ้น) · implement (ให้ agent ลงมือทำ) และรองรับ AI coding agent มากกว่า 30 ตัว จุดสำคัญสำหรับคนทำงานทั่วไปคือ: ไม่ต้องเขียนโค้ดเป็นก็ใช้หลักนี้ได้ ก่อนมอบงานใหญ่ให้ AI ลองเขียนเป็นลายลักษณ์อักษรว่าต้องการอะไร มีข้อจำกัดอะไร และผลลัพธ์หน้าตาแบบไหนถึงเรียกว่าสำเร็จ นั่นคือ spec ฉบับย่อของคุณ ซึ่งให้ผลต่างจากการนั่งคุยแก้ไปเรื่อยๆ แบบ vibe-coding อย่างชัดเจน

ตัวอย่างจากบทสนทนาจริง

ฝ่ายการตลาด: พี่ครับ ผมสั่ง AI ว่า "ทำ dashboard สรุปยอดขาย" มาสามรอบแล้ว ได้ของไม่ตรงใจสักรอบ ต้องพิมพ์แก้ทีละจุดวนไปวนมา นี่ AI ไม่เก่ง หรือผมสั่งไม่เป็นครับ

หัวหน้าทีม: ไม่ใช่ AI ไม่เก่งครับ แต่เรายังไม่เคยให้ spec มันเลย ลองเขียนก่อนสักหน้าหนึ่งว่า dashboard นี้ต้องตอบคำถามอะไร ใช้ข้อมูลจากไฟล์ไหน กรองตามอะไรได้บ้าง และหน้าตาประมาณไหนถือว่าใช้ได้ แล้วแนบทั้งหมดนี้ไปตอนสั่ง พอมันไม่ต้องเดาใจเรา รอบเดียวก็ได้ของใกล้เคียงแล้วครับ

ระวังสับสนกับ

• prompt : prompt คือข้อความที่พิมพ์สั่ง AI ในแต่ละครั้ง อาจสั้นแค่บรรทัดเดียว ส่วน spec คือเอกสารความต้องการฉบับเต็มที่คิดมาก่อนแล้ว มักถูกแนบไปกับ prompt หรือวางเป็นไฟล์ให้ agent อ่าน · prompt เขียนดีแค่ไหนก็แทน spec ไม่ได้ถ้างานใหญ่และเงื่อนไขเยอะ
• ticket : ticket คือใบงานชิ้นเล็กหนึ่งชิ้นในระบบติดตามงาน ขอบเขตแคบและจบไว ส่วน spec ครอบคลุมภาพรวมทั้งฟีเจอร์หรือทั้งระบบ ในทางปฏิบัติ ticket หลายใบมักถูกซอยออกมาจาก spec เดียว