20/11/2026 00:00น.

AGENTS.md คืออะไร? เขียนอย่างไรให้ AI coding agent ทำงานใน repo ของเราได้ถูกจุด
#AGENTS.md
#AI coding agent
#Octoverse 2026
#GitHub Copilot
#Golang
ลองนึกภาพว่าคุณเพิ่งเข้าทีมใหม่ วันแรกมีคนส่ง README ให้อ่าน ในนั้นเล่าว่าโปรเจกต์ทำอะไร แต่ไม่ได้บอกว่าต้องรันเทสต์ด้วยคำสั่งไหน ใช้ตัวจัดรูปแบบโค้ดตัวไหน หรือโฟลเดอร์ไหนห้ามแตะ คุณคงต้องไล่ถามเพื่อนร่วมทีมทีละข้อครับ
AI coding agent เจอปัญหาเดียวกันนี้ทุกครั้งที่เปิดโปรเจกต์ และมีไฟล์รูปแบบหนึ่งที่ถูกคิดมาตอบโจทย์นี้ ชื่อว่า AGENTS.md วันนี้ Superdev Academy จะพาไปดูว่ามันคืออะไร วางไว้ตรงไหน เขียนอะไรลงไป และตัวเลข 8 เท่าจากรายงาน Octoverse 2026 ที่ถูกพูดถึงเรื่องไฟล์ประเภทนี้ ควรอ่านอย่างไรครับ
AGENTS.md คืออะไร
เว็บไซต์ agents.md นิยามไว้ว่าเป็น "รูปแบบเปิดที่เรียบง่ายสำหรับชี้แนวทางให้ coding agent" และเปรียบว่าเป็น README สำหรับ agent คือเก็บบริบทกับคำสั่งที่ agent ต้องใช้ แต่ถ้าใส่ใน README ปกติจะรกสำหรับคนอ่านครับ
กติกาหลักมีไม่กี่ข้อ ไฟล์วางที่ root ของ repository ถ้าเป็น monorepo ที่มีหลายโปรเจกต์ย่อย วางไฟล์ซ้อนในแต่ละโปรเจกต์ได้ agent จะอ่านไฟล์ที่ใกล้ที่สุดกับไฟล์ที่กำลังแก้ และไฟล์ที่ใกล้กว่าชนะ ส่วนคำสั่งที่คุณพิมพ์ในแชตกับ agent โดยตรงชนะทุกอย่าง ตัวไฟล์เป็น Markdown ธรรมดา ไม่มีฟิลด์บังคับ ใช้หัวข้อแบบไหนก็ได้ครับ
มีเครื่องมืออะไรอ่านไฟล์นี้บ้าง
หน้า agents.md รายชื่อเครื่องมือที่อ่านไฟล์นี้ไว้หลายตัว เช่น Codex, Jules, Cursor, Gemini CLI, GitHub Copilot coding agent, Devin, Windsurf, Aider, Zed, Warp และ VS Code รายชื่อนี้เป็นของเว็บไซต์นั้นเอง เราไม่ได้ทดสอบทีละเครื่องมือ และเว็บไซต์ยังอ้างว่ามีโปรเจกต์โอเพนซอร์สใช้มากกว่า 60,000 โปรเจกต์ ซึ่งก็เป็นตัวเลขจากผู้ดูแลมาตรฐานเองครับ
เว็บไซต์ระบุว่ามาตรฐานนี้ดูแลโดย Agentic AI Foundation ภายใต้ Linux Foundation สำหรับเครื่องมือที่ไม่อ่านไฟล์นี้เองโดยอัตโนมัติ มีตัวอย่างการตั้งค่า เช่น Aider เพิ่มบรรทัด read: AGENTS.md ในไฟล์ .aider.conf.yml และ Gemini CLI ตั้ง "context": { "fileName": "AGENTS.md" } ในไฟล์ .gemini/settings.json ครับ
ตัวเลข 8 เท่าจาก Octoverse อ่านอย่างไร
รายงาน Octoverse 2026 ของ GitHub ระบุว่า ในบรรดา repository ที่สร้างขึ้นในปีนี้ repo ที่มีไฟล์ตั้งค่า agent (agent configuration file) มีจำนวน commit เป็น 8 เท่าของ repo ใหม่ที่ไม่มีไฟล์ดังกล่าว
ก่อนจะสรุปว่าเขียนไฟล์แล้วงานจะเร็วขึ้น 8 เท่า ควรอ่านข้อจำกัดสามข้อครับ ข้อแรก รายงานพูดถึง "ไฟล์ตั้งค่า agent" โดยรวม ไม่ได้ระบุว่าเป็น AGENTS.md โดยเฉพาะ ข้อสอง นี่คือความสัมพันธ์ ไม่ได้พิสูจน์ว่าไฟล์เป็นสาเหตุ ข้อสาม โปรเจกต์ที่ใส่ใจเขียนไฟล์แบบนี้ อาจเป็นโปรเจกต์ที่คนทำงานหนักอยู่แล้ว และการนับ commit บอกปริมาณ ไม่ได้บอกคุณภาพของงานครับ
ที่อ่านได้อย่างปลอดภัยคือ ไฟล์ตั้งค่า agent กำลังกลายเป็นของที่พบบ่อยใน repo ใหม่ ซึ่งเป็นเหตุผลพอที่จะรู้จักมันไว้ครับ
ควรเขียนอะไรลงไป
agents.md แนะนำหัวข้อที่นิยมไว้ห้าหมวด ได้แก่ ภาพรวมโปรเจกต์ คำสั่ง build และ test แนวทางสไตล์โค้ด วิธีทดสอบ และข้อควรระวังด้านความปลอดภัย รวมถึงแนวทางการ commit หรือเปิด PR ถ้าคุณเขียนคำสั่งทดสอบไว้ เว็บไซต์ระบุว่า agent จะพยายามรันเช็กที่เกี่ยวข้องและแก้ที่ล้มเหลวก่อนจบงานครับ
ตัวอย่างต่อไปนี้เป็นไฟล์สมมติสำหรับโปรเจกต์ Go ที่เราเขียนขึ้นเพื่อการสอน คำสั่งทั้งหมดเป็นคำสั่งมาตรฐานของ Go ครับ
# AGENTS.md
## ภาพรวม
REST API สำหรับระบบสมาชิก เขียนด้วย Go โค้ดหลักอยู่ใน internal/ และจุดเริ่มต้นอยู่ใน cmd/api/
## คำสั่ง
- Build: `go build ./...`
- Test: `go test ./...`
- ตรวจรูปแบบโค้ด: `gofmt -l .` (ถ้ามีไฟล์แสดงออกมา แปลว่ายังไม่ได้จัดรูปแบบ)
- ตรวจเบื้องต้น: `go vet ./...`
## สไตล์โค้ด
- คืนค่า error เสมอ ห้ามเมินด้วย `_`
- ชื่อ test ใช้รูปแบบ `Testชื่อฟังก์ชัน_กรณี`
## ความปลอดภัย
- ห้ามใส่ secret หรือ token ลงในโค้ดหรือในไฟล์นี้ ให้อ่านจาก environment variable
- ห้ามแก้ไฟล์ใน migrations/ ที่ถูก merge ไปแล้วสังเกตว่าไฟล์สั้น ตรงประเด็น และเป็นคำสั่งที่รันได้จริง เราแนะนำให้เริ่มจากสามหมวด คือคำสั่ง สไตล์ และความปลอดภัย แล้วค่อยเติมเมื่อเห็นว่า agent พลาดเรื่องไหนซ้ำๆ ครับ
แล้ว agent จะทำตามไฟล์นี้ทุกครั้งใช่ไหม
ไม่รับประกันครับ ไฟล์นี้ช่วยให้ agent รู้บริบท แต่โมเดลยังต้องตีความและอาจพลาดได้ เมื่อมันเขียนว่า "ห้ามแก้ไฟล์ใน migrations/" ก็ไม่ได้แปลว่าจะไม่มีวันแก้ ดังนั้นงานที่กระทบข้อมูลจริงหรือสิทธิ์ผู้ใช้ยังต้องมีคนอ่านและอนุมัติเสมอ
ถ้าทีมของคุณกำลังตั้งกติกาการใช้ AI ในงาน ลองอ่านภาพรวมกรอบที่องค์กรใหญ่ใช้ได้ใน AI Governance คืออะไร และถือว่า AGENTS.md เป็นกติการะดับโปรเจกต์ที่อยู่ในนั้นอีกชั้นหนึ่งครับ
ลองทำใน 15 นาที
เปิดโปรเจกต์ทดลองที่มีเทสต์อยู่แล้ว สร้างไฟล์ AGENTS.md ที่ root ตามตัวอย่างข้างบน แก้คำสั่งให้ตรงกับโปรเจกต์ของคุณ แล้วสั่ง agent ที่คุณใช้ให้เพิ่มฟังก์ชันเล็กๆ สักอัน สังเกตว่ามันรันคำสั่งทดสอบก่อนบอกว่าเสร็จหรือไม่ ถ้าไม่ ให้ตรวจก่อนว่าเครื่องมือนั้นอ่านไฟล์นี้เองหรือต้องตั้งค่าเพิ่มเหมือน Aider กับ Gemini CLI ครับ
สรุป: README สำหรับ agent ที่สั้นและรันได้จริง
AGENTS.md คือไฟล์ Markdown ที่ root ของ repo บอก AI coding agent ว่าโปรเจกต์ build, test และเขียนโค้ดอย่างไร ไฟล์ที่ใกล้กว่าชนะ และคำสั่งในแชตชนะทั้งหมด ตัวเลข 8 เท่าของ Octoverse 2026 เป็นความสัมพันธ์กับ "ไฟล์ตั้งค่า agent" โดยรวม ไม่ใช่หลักฐานว่าไฟล์นี้ทำให้งานเร็วขึ้น
เริ่มจากไฟล์สั้นๆ ที่มีคำสั่งรันได้จริง สไตล์โค้ด และข้อห้ามด้านความปลอดภัย แล้วค่อยปรับตามสิ่งที่ agent พลาดซ้ำ งานที่สำคัญก็ยังต้องมีคนอ่านก่อนกด Merge เสมอครับ
ตัวอย่างในบทความนี้เขียนด้วยภาษา Go ถ้าคุณยังไม่คุ้นกับภาษานี้ ลองดูคอร์ส Go Cheat Sheet ของ Superdev Academy ยาว 48 นาที สิทธิ์เรียน 12 เดือน คอร์สนี้ไม่ได้สอนเรื่อง AGENTS.md ดูคอร์สทั้งหมดได้ที่ learn.superdevacademy.com/courses
🎯 ติดตามความรู้สาย Dev ได้ที่ Superdev Academy:
🔵 Facebook: Superdev Academy Thailand
🎬 YouTube: Superdev Academy Channel
📸 Instagram: @superdevacademy
🎬 TikTok: @superdevacademy
FAQ: คำถามที่พบบ่อยเกี่ยวกับบทความนี้
รวมคำถามและคำตอบที่ช่วยให้คุณเข้าใจเนื้อหาในบทความนี้ได้ดียิ่งขึ้น