ใช้ Claude Code รีวิวโค้ดอย่างไร? ให้ช่วยหาจุดเสี่ยงก่อน Merge

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

ก่อนเริ่มรีวิวโค้ด

เตรียมข้อมูลให้ Claude Code เข้าใจบริบท เช่น จุดประสงค์ของ Pull Request ไฟล์ที่เปลี่ยน พฤติกรรมที่ควรคงเดิม และส่วนที่ต้องการให้ตรวจเป็นพิเศษ หากมีข้อกำหนดด้านความปลอดภัยหรือรูปแบบการเขียนโค้ดของทีม ให้ระบุหรือชี้ไปยังไฟล์แนวทางใน Repository

ควรตรวจสถานะ Git และ Diff ให้ตรงกับสิ่งที่จะรีวิว เพื่อไม่ให้การเปลี่ยนแปลงอื่นที่ยังไม่เกี่ยวข้องปะปนเข้ามา

วิธีให้ Claude Code รีวิวโค้ดในเครื่อง

① เปิด Claude Code ในโฟลเดอร์ Repository
เปิด Terminal ในโฟลเดอร์โปรเจกต์ แล้วเริ่ม Claude Code เพื่อให้เครื่องมืออ่านไฟล์และบริบทใน Repository ได้

② ระบุขอบเขตการรีวิว
บอกว่าจะให้ตรวจ Diff ปัจจุบัน ไฟล์ใด หรือการเปลี่ยนแปลงใด พร้อมบอกว่าต้องการเน้นบั๊ก ความปลอดภัย ประสิทธิภาพ หรือผลกระทบต่อพฤติกรรมเดิม

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

④ ตรวจคำแนะนำกับโค้ดจริง
เปิดดูตำแหน่งที่รายงาน ตรวจว่าปัญหาเกิดขึ้นได้จริงหรือไม่ และพิจารณาว่าการเปลี่ยนแปลงนั้นเป็นไปตามโจทย์หรือไม่

⑤ ทดสอบก่อน Merge
รันชุดทดสอบที่เกี่ยวข้อง ตรวจ Diff และแก้ข้อค้นพบที่ยืนยันได้ก่อน Merge หากแก้โค้ดตามคำแนะนำ ให้ตรวจ Diff และทดสอบซ้ำ

Prompt ตัวอย่างสำหรับรีวิว Pull Request

ช่วยรีวิวการเปลี่ยนแปลงใน Diff ปัจจุบันก่อน Merge

วัตถุประสงค์ของการเปลี่ยนแปลง: [อธิบายงานหรือฟีเจอร์]
พฤติกรรมที่ต้องคงไว้: [ระบุส่วนสำคัญ]
จุดที่อยากให้เน้น: [บั๊ก / ความปลอดภัย / กรณีขอบ / ประสิทธิภาพ]

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

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

ใช้ Claude Code GitHub Actions รีวิว Pull Request

หากต้องการให้ Claude ช่วยรีวิวใน Workflow ของ GitHub สามารถตั้งค่า Claude Code GitHub Actions ให้ทำงานกับ Pull Request ได้ เอกสาร Anthropic ระบุตัวอย่าง Workflow ที่เรียกใช้คำสั่ง /review เมื่อมีการเปิดหรืออัปเดต Pull Request และต้องตั้งค่าการยืนยันตัวตนกับสิทธิ์ของ Action ให้เหมาะสม

ก่อนเปิดใช้งาน ควรตรวจสิทธิ์ที่จำเป็น จำกัดขอบเขตการทำงานของ Workflow และเก็บ API Key ใน GitHub Secrets แทนการใส่ลงในไฟล์ที่ Commit เข้า Repository ผลรีวิวจากระบบอัตโนมัติยังควรผ่านการพิจารณาก่อน Merge

วิธีพิจารณาข้อค้นพบก่อน Merge

ไม่ควรแก้ทุกข้อที่ Claude Code เสนอโดยอัตโนมัติ ให้ตรวจแต่ละข้อว่า:

• เกิดจากโค้ดที่เปลี่ยนใน Pull Request นี้หรือไม่
• มีขั้นตอนหรือเงื่อนไขที่ทำให้เกิดปัญหาชัดเจนหรือไม่
• ผลกระทบรุนแรงแค่ไหน และมีวิธีทำซ้ำหรือทดสอบยืนยันได้หรือไม่
• เป็นข้อผิดพลาดจริง หรือเป็นเพียงแนวทางปรับปรุงเพิ่มเติม
• การแก้ตามคำแนะนำจะกระทบพฤติกรรมอื่นหรือไม่

ข้อจำกัดที่ควรรู้

การรีวิวโดย Claude Code อาจพลาดปัญหาบางอย่างหรือแจ้งข้อกังวลที่ไม่เกิดขึ้นจริงได้ โดยเฉพาะเมื่อขาดบริบททางธุรกิจ ระบบภายนอก หรือเงื่อนไขการใช้งานจริง ดังนั้นควรใช้ร่วมกับการรีวิวของทีม ชุดทดสอบ และเครื่องมือตรวจโค้ดของโปรเจกต์ ไม่ควรถือว่าผลรีวิวจาก AI เป็นหลักฐานเพียงอย่างเดียวว่าโค้ดปลอดภัยหรือพร้อมใช้งาน

สรุป

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