ใช้ Claude Code เพิ่มฟีเจอร์ใหม่ในโปรเจกต์อย่างไร? ตั้งโจทย์และตรวจงานให้ตรง

การให้ Claude Code เพิ่มฟีเจอร์ในโปรเจกต์ได้ผลดีเมื่อระบุให้ชัดว่าต้องการให้ผู้ใช้ทำอะไร ฟีเจอร์ควรทำงานอย่างไร และส่วนใดของระบบเกี่ยวข้อง ผู้ใช้ ComSiam สามารถเริ่มจากให้ Claude Code สำรวจโครงสร้างและเสนอแผนก่อน แล้วจึงให้ลงมือแก้ตามขอบเขตที่ตกลงกัน

เตรียมโจทย์ก่อนให้ Claude Code เริ่มงาน

ก่อนพิมพ์คำสั่ง ลองตอบคำถามเหล่านี้ให้ได้:

• ฟีเจอร์นี้แก้ปัญหาอะไร หรือช่วยผู้ใช้ทำอะไร
• ผู้ใช้เริ่มใช้งานฟีเจอร์จากหน้าใดหรือขั้นตอนใด
• ข้อมูลที่ต้องรับและผลลัพธ์ที่ต้องแสดงคืออะไร
• มีเงื่อนไขหรือกรณีพิเศษใดบ้าง
• ส่วนใดของระบบที่ต้องคงพฤติกรรมเดิม
• จะตรวจได้อย่างไรว่าฟีเจอร์ทำงานถูกต้อง

ถ้ามีตัวอย่างหน้าจอ รูปแบบข้อมูล หรือฟีเจอร์ที่คล้ายกันในโปรเจกต์ ให้แนบหรือระบุไฟล์ที่เกี่ยวข้องด้วย ช่วยให้ Claude Code ทำตามรูปแบบเดิมของโครงการได้ง่ายขึ้น

ขั้นตอนเพิ่มฟีเจอร์ด้วย Claude Code

① เปิด Claude Code ในโฟลเดอร์โปรเจกต์
เปิด Terminal ในโฟลเดอร์ที่ต้องการทำงาน แล้วเริ่ม Claude Code จากที่นั่น ตรวจสถานะ Git ก่อนเริ่ม เพื่อแยกงานที่มีอยู่แล้วออกจากการเปลี่ยนแปลงใหม่

② ให้สำรวจโค้ดและหาจุดที่เกี่ยวข้อง
ขอให้ตรวจโครงสร้างและไฟล์ที่น่าจะเกี่ยวข้อง พร้อมอธิบายแนวทางทำงานก่อนแก้ไข หากโปรเจกต์มีแนวทางเขียนโค้ดหรือรูปแบบ UI อยู่แล้ว ให้ Claude Code อ่านและยึดตามนั้น

③ ระบุเกณฑ์รับงานให้ตรวจสอบได้
แทนที่จะสั่งเพียงว่า “เพิ่มระบบค้นหา” ให้บอกว่าค้นหาจากข้อมูลใด แสดงผลอย่างไร และควรเกิดอะไรขึ้นเมื่อไม่พบรายการ ยิ่งเกณฑ์ชัด ยิ่งตรวจได้ว่าผลลัพธ์ตรงกับความต้องการหรือไม่

④ กำหนดขอบเขตการแก้ไข
บอกว่าต้องการให้แก้ส่วนใด และมีส่วนใดที่ไม่ควรเปลี่ยน เช่น โครงสร้างฐานข้อมูล API หรือรูปแบบหน้าจออื่น หากจำเป็นต้องแตะส่วนที่อยู่นอกขอบเขต ให้ Claude Code อธิบายเหตุผลก่อน

⑤ ให้ลงมือและสรุปสิ่งที่เปลี่ยน
เมื่อเห็นแผนแล้ว ให้ Claude Code ทำงานตามเกณฑ์ที่กำหนด พร้อมสรุปไฟล์ที่แก้ เหตุผลของการเปลี่ยนแปลง และข้อจำกัดที่พบ

⑥ ตรวจ Diff และผลทดสอบ
ตรวจความแตกต่างของโค้ดด้วย /diff หรือ git diff แล้วรันทดสอบที่เกี่ยวข้องตามวิธีของโปรเจกต์ ตรวจด้วยว่ามีไฟล์หรือการเปลี่ยนแปลงใดที่ไม่เกี่ยวกับฟีเจอร์นี้หรือไม่

Prompt ตัวอย่างสำหรับสร้างฟีเจอร์ใหม่

ช่วยเพิ่มฟีเจอร์ [ชื่อฟีเจอร์] ในโปรเจกต์นี้

เป้าหมาย: [ฟีเจอร์นี้ช่วยผู้ใช้ทำอะไร]
ผู้ใช้เริ่มใช้งานจาก: [หน้า/เมนู/ขั้นตอน]
ข้อมูลนำเข้า: [ข้อมูลที่ผู้ใช้ส่งหรือเลือก]
ผลลัพธ์ที่ต้องการ: [สิ่งที่ระบบแสดงหรือดำเนินการ]
เกณฑ์ที่ถือว่าทำงานถูกต้อง:
① [เกณฑ์ข้อแรก]
② [เกณฑ์ข้อสอง]
③ [กรณีผิดพลาดหรือกรณีพิเศษ]

ก่อนแก้โค้ด ให้สำรวจไฟล์ที่เกี่ยวข้องและสรุปแผนสั้น ๆ โดยระบุไฟล์ที่คาดว่าจะเปลี่ยน
ทำตามรูปแบบและโครงสร้างเดิมของโปรเจกต์ แก้เฉพาะส่วนที่จำเป็น และอย่าเปลี่ยนพฤติกรรมอื่นที่ไม่เกี่ยวข้อง
หากพบว่าจำเป็นต้องเปลี่ยนส่วนที่อยู่นอกขอบเขต ให้แจ้งเหตุผลก่อน

หลังทำเสร็จ ให้สรุปไฟล์ที่เปลี่ยน วิธีทดสอบ และผลที่ได้ พร้อมบอกสิ่งที่ยังไม่ได้ทดสอบ

ตรวจงานหลัง Claude Code เพิ่มฟีเจอร์

ผู้ใช้ ComSiam ควรตรวจผลในมุมของผู้ใช้จริงด้วย ไม่ใช่ดูแค่คำอธิบายจากเครื่องมือ โดยลองทำตามขั้นตอนใช้งานตั้งแต่ต้นจนจบ เช่น กรอกข้อมูลที่ถูกต้อง กรอกข้อมูลไม่ครบ และลองกรณีที่ระบบไม่พบข้อมูล จากนั้นตรวจ Diff ว่าแก้เฉพาะไฟล์ที่เกี่ยวข้องหรือไม่ และพิจารณาผลทดสอบที่ Claude Code รายงานควบคู่กับการทดลองใช้งานจริง

ถ้าได้ผลไม่ตรงโจทย์ ให้ชี้เกณฑ์ที่ยังไม่ผ่านและขอให้แก้เฉพาะส่วนนั้น เช่น “เมื่อไม่พบผลค้นหา ต้องแสดงข้อความแจ้งผู้ใช้ตามเกณฑ์ข้อ ③ โปรดปรับเฉพาะส่วนนี้และสรุป Diff อีกครั้ง”

สรุป

การเพิ่มฟีเจอร์ด้วย Claude Code เริ่มจากโจทย์และเกณฑ์รับงานที่ชัดเจน ให้สำรวจและเสนอแผนก่อนแก้ จากนั้นจำกัดขอบเขต ตรวจ Diff และทดสอบตามการใช้งานจริง การทำเป็นขั้นตอนช่วยให้ตรวจงานได้ง่าย และช่วยลดการเปลี่ยนแปลงที่ไม่เกี่ยวข้อง ทั้งนี้ควรตรวจโค้ดและทดสอบด้วยตนเองก่อนนำฟีเจอร์ไปใช้งานจริง