เลิกเขียนกฎลอยๆ สำหรับ Coding Agent แล้วหันมาใช้เครื่องมือบังคับจริงใน CI
ผู้พัฒนาเปิดเผยว่าเอกสารแนะนำในคลังโค้ดไม่เพียงพอสำหรับการควบคุม AI coding agents จึงหันมาใช้ระบบตรวจสอบอัตโนมัติที่เชื่อมโยงกับ CI
ภาพประกอบจากคลังภาพสต็อก ไม่ใช่ภาพจากเหตุการณ์จริง
- เอกสารข้อกำหนดในคลังโค้ดมักถูกละเลยหากไม่มีระบบตรวจสอบอัตโนมัติรองรับ
- เครื่องมือตรวจสอบที่ดีควรเริ่มต้นจากข้อผิดพลาดที่เคยเกิดขึ้นจริง
- ระบบอนุญาตให้ข้อยกเว้นได้ผ่านคอมเมนต์เฉพาะเพื่อป้องกันการหลบเลี่ยงแบบไร้ร่องรอย
- Agents Playbook ประกอบด้วยชุดตรวจสอบ 13 รายการที่ทำงานแบบไม่มี Dependency
ในอดีตผู้พัฒนาเคยเขียนไฟล์แนะนำอย่าง AGENTS.md ขึ้นมาเป็นผลิตภัณฑ์สำเร็จรูป เพื่ออธิบายสถาปัตยกรรม สั่งห้ามการใช้บางสิ่ง บังคับให้ใช้ Named Exports และบอกให้ AI coding agent คอยดูแลขนาดไฟล์ให้เล็กอยู่เสมอเมื่อมีการเปลี่ยนแปลงสัญญา แต่ปัญหาคือแม้เอกสารจะยอดเยี่ยมเพียงใด พูลรีเควสต์ถัดมาก็ยังคงละเมิดข้อกำหนดเหล่านั้นอยู่ดี
ความล้มเหลวนี้ไม่ได้เกิดจากตัว AI เสมอไป เพราะกฎที่มีอยู่เพียงแค่ตัวหนังสือย่อมคาดหวังให้ผู้มีส่วนร่วมทุกคนไม่ว่าจะเป็นมนุษย์หรือระบบอัตโนมัติ จดจำและปฏิบัติตามได้ในจังหวะที่ถูกต้องเสมอ ส่งผลให้กระบวนการรีวิวกลายเป็นด่านแรกที่พบว่ากฎถูกละเมิด ผู้พัฒนาจึงเปลี่ยนแนวคิดใหม่โดยใช้เอกสารคำอธิบายควบคู่ไปกับระบบกลไกตรวจสอบอัตโนมัติที่เป็นรูปธรรม
ภาพประกอบจากคลังภาพสต็อก ไม่ใช่ภาพจากเหตุการณ์จริง
การตอบสนองที่ง่ายที่สุดคือการทำให้ทุกอย่างเป็นอัตโนมัติ แต่แนวทางดังกล่าวกลับสร้างปัญหาใหม่คือกองทัพการตรวจสอบที่ส่งเสียงแจ้งเตือนจนน่ารำคาญ ซึ่งไม่มีใครเข้าใจและทุกคนพยายามหาวิธีหลบเลี่ยง ดังนั้นแนวทางใหม่จึงเริ่มต้นจากความผิดพลาดที่เคยเกิดขึ้นจริงแล้ว เช่น เมื่อเอเจนต์พยายามใช้ชนิดข้อมูล any เพื่อเร่งให้โค้ด TypeScript ผ่านไปได้อย่างรวดเร็ว ในขณะที่กฎของคลังโค้ดกำหนดให้ใช้ unknown พร้อมทำการตรวจสอบชนิดและข้อมูลภายนอกขณะรันไทม์ แม้ผู้ตรวจสอบจะพบและให้แก้ไข แต่ข้อผิดพลาดเดิมก็ยังกลับมาอีกในสองพูลรีเควสต์ถัดมา
การเปลี่ยนผ่านจากการพึ่งพากฎที่เป็นตัวอักษรมาสู่การใช้เครื่องมือตรวจสอบอัตโนมัติ (Automated Gates) ถือเป็นหัวใจสำคัญในการพัฒนาซอฟต์แวร์ยุคที่ AI มีบทบาทสูง เนื่องจากมนุษย์มีข้อจำกัดด้านความใส่ใจในรายละเอียดปลีกย่อย การผูกกฎระเบียบเข้ากับระบบ CI จึงช่วยลดภาระทางความคิดและป้องกันข้อผิดพลาดที่มักเกิดขึ้นซ้ำๆ ได้อย่างมีประสิทธิภาพ
ผู้พัฒนาได้เผยแพร่ชุดคำสั่งตรวจสอบที่สามารถรันได้ทันทีจาก Agents Playbook ในรูปแบบ CLI แบบไม่มี Dependency เพื่อให้ผู้ใช้งานสามารถทดสอบระบบตรวจสอบเฉพาะส่วนได้ทันที ตัวอย่างเช่นเมื่อทดสอบกฎห้ามใช้ any ผ่านคำสั่ง:
npx --yes @agentskit/playbook@0.1.0 run no-any --cwd /tmp/playbook-gate-demo
ระบบจะทำการตรวจสอบและชี้จุดที่เกิดข้อผิดพลาดได้อย่างแม่นยำ พร้อมทั้งรองรับการระบุข้อยกเว้นแบบเฉพาะเจาะจงผ่านคอมเมนต์ เช่น // allow-any: upstream SDK has no types ซึ่งช่วยให้การตัดสินใจมีความโปร่งใสและสามารถนับจำนวนข้อยกเว้นได้โดยที่ตัวเลขไม่เพิ่มขึ้นอย่างไร้การควบคุม
ภาพประกอบจากคลังภาพสต็อก ไม่ใช่ภาพจากเหตุการณ์จริง
ปัจจุบัน Agents Playbook มีชุดตรวจสอบอ้างอิงที่ทำงานแบบไม่มี Dependency ทั้งหมด 13 รายการ ครอบคลุมประเด็นสำคัญ เช่น ข้อมูลลับ ขนาดไฟล์ Named exports ข้อกำหนด ADR หรือ RFC การแปลภาษา โทนสีการออกแบบ HTML ดั้งเดิม และเจตนาของพูลรีเควสต์ เพื่อให้การควบคุมดูแลเชื่อมโยงกับหลักฐานที่ตรวจสอบได้จริง
ที่มา: Dev.to
พบข้อมูลผิดพลาดในบทความนี้? แจ้งปัญหาบทความนี้
ความคิดเห็น
แสดงความคิดเห็น