เจาะประเด็น
Development
ซ่อนยาวไปก็ไม่มีใครอ่าน พลิกวิธีส่ง Pull Request ยุค AI เขียนโค้ดให้สะอาดตา
เมื่อเอไอเขียนคำอธิบายโค้ดได้ยาวเหยียดจนน่าเบื่อ ทางออกง่ายๆ คือการซ่อนมันไว้ข้างหลังแท็ก HTML พื้นฐานที่ GitHub รองรับ
ทีมข่าว เอไอไทย.com
⏱ อ่าน 3 นาที
คำอธิบายโค้ดที่ยาวเป็นหางว่าวจากเอไอไม่ได้ช่วยให้คนอ่านอยากตรวจงานเพิ่มขึ้นเลยสักนิด
ทุกวันนี้บอกตามตรงว่างานเขียนโค้ดส่วนใหญ่ของผมถูกป้อนเข้ามาผ่าน Pull Request หรือ PR ที่เจ้าเอไออย่าง Claude Code หรือ Codex จัดการเปิดไว้ให้เสร็จสรรพ มันคือหน่วยงานหลักที่ผมใช้มัดรวมคอมมิต ไล่แก้จนฟีเจอร์เสร็จสมบูรณ์ และบันทึกการตัดสินใจก่อนจะกดรวมโค้ดเข้า
ปัญหาคือเจ้าพวกเอไอพวกนี้มันขยันเกินเหตุ เขียนคำอธิบาย PR ออกมาได้ครบถ้วนละเอียดยิบ ทั้งอธิบายปัญหา วิธีแก้ และขั้นตอนการทดสอบแบบละเอียดยิบย่อย อ่านทีไรปฏิกิริยาอัตโนมัติในหัวมันร้องเตือนขึ้นมาทันทีว่า "ไม่อ่านเว้ยยาวเกิน"
ต่อให้ข้อมูลพวกนั้นจะถูกต้องหรือมีประโยชน์แค่ไหน แต่ความคิดที่ว่ามันจะใช้เวลาอ่านนานกว่าตอนที่เอไอสร้างมันขึ้นมาเสียอีก มันทำให้ผมไม่อยากแตะมันเลยจริงๆ แม้ว่าตัวผมเองจะเป็นคนสั่งให้มันทำก็ตามทีเถอะ
สิ่งที่ผมโหยหาจริงๆ คือการกลั่นกรองด้วยความเป็นมนุษย์ ผมอยากให้มีใครสักคนใช้เวลาคิดสักนิดแล้วสรุปสั้นๆ ให้ฟังแบบมนุษย์เข้าใจ ว่าตกลง PR นี้มันทำอะไร และทำไมมันถึงคู่ควรแก่การเสียเวลามานั่งดู
หลังจากลองผิดลองถูกมาพักใหญ่ ผมก็พบวิธีแก้ปัญหาที่ใช้แรงน้อยแถมได้ผลลัพธ์กำลังดี นั่นคือการซ่อนรายละเอียดส่วนใหญ่ไว้ในแท็ก HTML แบบยุบได้
แท็ก details และ summary ของ HTML มันจะแสดงผลเป็นหัวข้อแบบพับเก็บได้ ซึ่งคนอ่านสามารถกดขยายเพื่อดูเนื้อหายาวๆ ข้างในได้ตามใจชอบ จุดสำคัญคือฟีเจอร์นี้รองรับใน Markdown ของ GitHub เต็มๆ แบบไม่ต้องดัดแปลงอะไรเลย
ผมเลยเริ่มเอามาใช้กับ PR ที่เอไอเขียนให้ โดยจะเขียนประโยคเปิดหัวด้วยตัวเองสั้นๆ เพื่ออธิบายภาพรวมแบบเข้าใจง่ายที่สุด ส่วนเนื้อหาเรียงความยาวเหยียดที่เอไอเขียนพรั่งพรูออกมา จะถูกจับยัดใส่รวมไว้ในแท็กซ่อนข้างล่าง โดยใช้ชื่อรุ่นของโมเดลและระดับความพยายามมาเป็นหัวข้อสรุปสั้นๆ เช่น Claude Opus 5.5 Medium
วิธีนี้ทำให้หน้า PR ดูรกหูรกตาน้อยลงเยอะ ข้อมูลทั้งหมดไม่ได้หายไปไหน ใครอยากเจาะลึกก็แค่กดคลิกขยายดู แต่คนตรวจงานสามารถกวาดตามองปุ๊บแล้วเข้าใจสาระสำคัญได้ทันทีโดยที่สมองไม่ต้องน็อตหลุดไปกับตัวหนังสือเป็นพรืด
บางครั้งผมก็ไม่ต้องเสียเวลาเขียนเกริ่นนำเองด้วยซ้ำ เพราะบางทีเอไอมันก็แอบซ่อนใจความสำคัญที่ผมต้องการไว้ในกองข้อความเหล่านั้นอยู่แล้ว หน้าที่ของผมในฐานะคนตรวจงานคือการดึงประโยคที่ใช่ที่สุดมาแปะไว้ข้างบน เพื่อรับประกันกับคนอ่านว่านี่คือมุมมองที่ผ่านการกลั่นกรองมาแล้วว่าคุ้มเวลาแน่นอน
datasette PR #3052
รีดีไซน์หน้าตารางข้อมูลเป็นรายชื่อแนวตั้ง แก้ปัญหาตารางกว้างหลายคอลัมน์ที่ล้นจอจนพื้นที่ส่วนใหญ่ว่างเปล่า
datasette PR #3043
เพิ่มแถบแบ่งหน้าและปุ่มนำทางทั้งด้านบนและด้านล่างของหน้าตาราง เพื่อให้รู้ว่าตอนนี้กำลังยืนอยู่ตรงไหน
llm PR #1838
เพิ่มคำสั่งจัดการเรคคอร์ดในไฟล์คอนฟิก ให้เซฟพอยต์เชื่อมต่อที่รองรับ OpenAI ได้จากคอมมานด์ไลน์โดยตรงไม่ต้องแก้ไฟล์ YAML เอง
พูดถึงแท็กพวกนี้ เมื่อก่อนผมก็เคยจำสับสนเหมือนกันว่าอันไหนต้องมาก่อนระหว่าง details กับ summary จนได้สองวิธีช่วยจำที่เวิร์กมาก
วิธีแรกคือตัว summary ชัดเจนอยู่แล้วว่าเป็นส่วนสรุปเนื้อหา ดังนั้นมันต้องเป็นบรรทัดข้อความที่คุณคลิกเพื่อกางออก ส่วนแท็ก details ค่อยทำหน้าที่ห่อหุ้มทุกอย่างไว้อีกที
อีกวิธีที่ง่ายกว่าคือการเรียกชื่อมันติดปากว่า details-summary เพราะมันออกเสียงสองพยางค์ตามด้วยสามพยางค์ ซึ่งพอดัดลิ้นพูดแล้วมันลื่นไหลกว่าการสลับเอา summary ขึ้นก่อนเยอะ ลองพูดตามดูสักสองสามรอบรับรองว่าไม่มีทางลืมลำดับแท็กอีกต่อไป
การใช้เทคโนโลยีช่วยทำงานไม่ได้หมายความว่าเราต้องปล่อยให้ขยะข้อมูลล้นทะลักใส่มนุษย์คนอื่น การจัดระเบียบด้วยวิธีง่ายๆ แบบนี้แหละที่จะช่วยรักษาความน่าอ่านในยุคเอไอเฟื่องฟู
ที่มา: Simon Willison's Weblog — อ่านต้นฉบับ
ความคิดเห็น 0
กำลังโหลดความคิดเห็น...