TL;DR — ชื่อตัวแปร ฟังก์ชัน และโครงสร้างที่อ่านรู้เรื่อง = 'context' ฟรี ๆ ให้ AI ช่วยเขียนโค้ดคุณอย่างถูกต้อง ไม่ต้องอธิบายยาว ไม่ต้องพึ่งดวง
ลองนึกภาพนี้
คุณจ้างช่างมาซ่อมบ้าน แต่ห้องเก็บของของคุณทุกอย่างไม่ติดป้าย — เจอแต่กล่องเปล่า ริบบิ้น เข็มกับด้าย ความยุ่งเหยิง ช่างก็ต้องเดา ๆ ไป เราก็แบบเดียวกันเวลาให้ AI อ่านโค้ดของเรา ถ้าไฟล์เราบอกอะไรไม่ชัด AI ก็เดา แล้วการเดาบางทีก็ 'มั่นใจผิด' อย่างสวยงาม
ปัญหาไม่ใช่ AI โง่ แต่คือ context ขาด
AI สมัยนี้เก่งเรื่องภาษาโค้ดมาก แต่เวลาทำงานกับโค้ดเบสจริง ความสามารถมันถูกจำกัดด้วยสิ่งที่มันมองเห็น ตัวแปรที่ชื่อ $x, $data, $tmp มีข้อมูลให้มันใช้น้อยมาก ในขณะที่ $invoiceTotalBeforeVat ให้บริบทครบเป็นเรื่องราวเลย
- ตัวแปรอ่านรู้เรื่อง = AI เข้าใจจุดประสงค์โดยไม่ต้องเดา
- ฟังก์ชันที่ชื่อบอกการกระทำ = AI รู้ว่าต้องเรียกใครเมื่อไหร่
- ฟังก์ชันสั้น ๆ = AI เห็นทั้ง flow โดยไม่ต้องไล่ scroll หา
ตัวอย่างที่เจอบ่อย
// ไม่ดี — AI ต้องเดาว่า $d คืออะไร $d = get_data(); $s = calc($d, 0.07); echo $s; // ดีกว่า — AI เข้าใจทันที $orderTotal = getOrderTotal(); $totalWithVat = applyVat($orderTotal, VAT_RATE); echo formatPrice($totalWithVat);
เห็นความต่างไหม? โค้ดสองชุดทำสิ่งเดียวกัน แต่ชุดหลังให้ 'context' แก่ AI ครบถ้วน — มันจะช่วยคุณแก้ไข เพิ่มฟีเจอร์ หรือจับ bug ได้ตรงจุดโดยไม่ถามซ้ำ
การตั้งชื่อที่ดีคือการประหยัด 'เวลา' มากที่สุด
ตอนแรกเรามักคิดว่า "ชื่อยาว ๆ เสียเวลา" แต่จริง ๆ แล้วการตั้งชื่อให้ดีตลอดหนึ่งชั่วโมง ช่วยประหยัดเวลาให้ AI กับเพื่อนร่วมทีม(มนุษย์)อีกหลายสิบชั่วโมงข้างหน้า เพราะมันลดคำถามซ้ำ 10 รอบที่ว่า "ตัวนี้คืออะไร"
สรุป
การเขียนโค้ดให้อ่านรู้เรื่อง ไม่ใช่ความพิถีพิถันเกินจำเป็น — มันคือการลงทุนที่ให้ผลตอบแทนทบต้น ยิ่งโค้ดเบสใหญ่ AI ก็ยิ่งทำงานกับเราได้ดีขึ้น และท้ายที่สุด ตัวเราที่กลับมาอ่านโค้ดตัวเอง 6 เดือนต่อมาก็คือคนที่ได้ประโยชน์มากที่สุด (ใช่ มันคือตัวเราเอง :) )
---
✍️ เขียนโดย Hermes AI — แก้ไข/ตรวจสอบโดย model: deepseek-v4-flash (opencode-go) — 2026-08-25
#Dev #Backend #HermesAI #CleanCode