ตรวจงานที่ agent ทำ

"เสร็จแล้ว" คือจุดเริ่มต้นของการตรวจ

agent มักจบงานด้วยข้อความมั่นใจ เช่น "เสร็จแล้ว ทุกอย่างทำงานได้" แต่ข้อความนั้นเป็นแค่สิ่งที่ agent เชื่อ ไม่ใช่หลักฐาน งานที่ดูเหมือนเสร็จอาจมีปัญหาแบบนี้

• ทำครบเกือบทุกข้อ แต่ข้ามเกณฑ์รับงานไปหนึ่งข้อ
• แก้ไฟล์อื่นที่ไม่เกี่ยวกับงานไปด้วย
• "แก้" error ด้วยการซ่อน error หรือลบการตรวจทิ้ง
• ใส่ข้อมูลตัวอย่างแทนข้อมูลจริง แล้วลืมเอาออก

ข่าวดีคือ การตรวจส่วนใหญ่ไม่ต้องอ่านโค้ดทุกบรรทัด

ชั้นที่ 1: ลองใช้จริงตามเกณฑ์รับงาน

เริ่มจากเกณฑ์รับงานที่เขียนไว้ในโจทย์ ตรวจทีละข้อด้วยการลองใช้จริง จากนั้นลองกรณีที่ไม่ได้อยู่ในเกณฑ์ เพราะปัญหามักซ่อนอยู่ตรงนั้น

ชั้นที่ 2: ดูว่าไฟล์อะไรเปลี่ยน

ทุกครั้งที่ agent แก้งาน Git จดไว้ว่าไฟล์ไหนเปลี่ยนและเปลี่ยนอย่างไร คำสั่งที่ใช้ดูคือ

• git status บอกว่ามีไฟล์ไหนถูกเปลี่ยน เพิ่ม หรือลบ
• git diff แสดงรายละเอียดว่าแต่ละบรรทัดเปลี่ยนอย่างไร

ใน VS Code ดูได้ง่ายกว่านั้นอีก คือเปิดแถบ Source Control ทางซ้าย แล้วคลิกที่ไฟล์ จะเห็นของเดิมกับของใหม่วางเทียบกัน

ความเปลี่ยนแปลงแบบนี้เรียกว่า diff บรรทัดที่ขึ้นต้นด้วย - คือบรรทัดที่ถูกลบ บรรทัดที่ขึ้นต้นด้วย + คือบรรทัดที่ถูกเพิ่ม

- <button>เพิ่ม</button>
+ <button>เพิ่มรายการ</button>

ตัวอย่างนี้แปลว่า ข้อความบนปุ่มเปลี่ยนจาก "เพิ่ม" เป็น "เพิ่มรายการ"

แม้ยังอ่านโค้ดไม่ออก ก็ตั้งคำถามกับ diff ได้

ชั้นที่ 3: ให้ agent อธิบาย พร้อมหลักฐาน

agent ช่วยตรวจงานของตัวเองได้ ถ้าเราถามให้ถูก แทนที่จะถามว่า "เสร็จหรือยัง" ให้ถามหาหลักฐาน

สรุปงานที่เพิ่งทำ:
1. รายการไฟล์ที่เปลี่ยน แต่ละไฟล์เปลี่ยนอะไร และเพราะอะไร
2. เกณฑ์รับงานแต่ละข้อ ตรวจแล้วหรือยัง ด้วยวิธีไหน
3. อะไรที่ยังไม่ได้ตรวจ หรือยังทำไม่ครบ
4. ถ้ามีไฟล์ที่เปลี่ยนนอกเหนือจากโจทย์ ให้บอกเหตุผล

คำตอบของ agent ยังเป็นแค่คำบอกเล่า ให้เทียบกับสิ่งที่เราเห็นเองเสมอ เช่น รายการไฟล์ต้องตรงกับ git status

เจอปัญหาแล้ว แจ้ง agent ยังไง

บอกให้ชัดว่าทำอะไร คาดว่าจะได้อะไร และได้อะไรจริง ยิ่งเจาะจง agent ยิ่งแก้ตรงจุด

เจอปัญหาตามเกณฑ์รับงานข้อ "ลบรายการหนึ่งแล้ว รายการอื่นยังอยู่ครบ"

ขั้นตอน: เพิ่ม 3 รายการ แล้วกดลบรายการที่ 2
ผลที่คาด: เหลือรายการที่ 1 และ 3
ผลที่ได้: รายการหายหมดทั้ง 3 รายการ

แก้ให้ตรงเกณฑ์ข้อนี้ โดยไม่แตะส่วนอื่น แล้วบอกว่าแก้ไฟล์ไหน

ถ้างานผิดไปไกลมาก บางครั้งเร็วกว่าถ้าย้อนกลับไปที่ commit ก่อนหน้า แล้วเขียนโจทย์ใหม่ให้ชัดขึ้น นี่คือเหตุผลที่ต้อง commit ก่อนให้ agent ลงมือ ดู บทที่ 4: เครื่องมือแรกของ dev

ข้อผิดพลาดที่พบบ่อย

1. ตรวจแค่ทางที่ราบรื่น ลองเฉพาะกรณีปกติ แต่ไม่ลองช่องว่าง ข้อความยาว หรือหน้าจอมือถือ
2. เชื่อสรุปของ agent โดยไม่เทียบกับ git status agent อาจลืมพูดถึงไฟล์ที่มันแก้
3. ปล่อยผ่านเมื่อเห็นเทสต์ถูกลบหรือถูกปิด ต้องถามเหตุผลทุกครั้ง
4. แจ้งปัญหากว้าง ๆ เช่น "มันพัง" agent ต้องเดาว่าพังตรงไหน และอาจแก้ผิดจุด

เช็กความเข้าใจ