mattpocock-skills

Skills สำหรับวิศวกรตัวจริง

[!NOTE] repo นี้คือฉบับแปลภาษาไทยของ mattpocock/skills โดย Matt Pocock ซึ่งเผยแพร่ภายใต้ MIT license — แปลโดย Boom (@Boom-Vitt) เนื้อหาต้นฉบับและเครดิตทั้งหมดเป็นของ Matt Pocock

นี่คือ agent skills ที่ผมใช้ทำงานวิศวกรรมซอฟต์แวร์จริง ๆ ทุกวัน — ไม่ใช่ vibe coding

การพัฒนาแอปพลิเคชันจริงเป็นเรื่องยาก แนวทางอย่าง GSD, BMAD และ Spec-Kit พยายามช่วยด้วยการเข้ามาคุมกระบวนการแทนเรา แต่ระหว่างนั้นมันก็พรากการควบคุมไปจากเรา และทำให้ bug ที่เกิดขึ้นในกระบวนการแก้ได้ยาก

skills ชุดนี้ถูกออกแบบมาให้เล็ก ปรับแต่งง่าย และประกอบเข้าด้วยกันได้ ใช้ได้กับทุกโมเดล และกลั่นมาจากประสบการณ์ด้านวิศวกรรมหลายสิบปี ลองแฮ็กเล่นดู ปรับให้เป็นของคุณเอง ขอให้สนุก

ถ้าอยากติดตามการเปลี่ยนแปลงของ skills เหล่านี้ รวมถึง skills ใหม่ ๆ ที่ Matt สร้างขึ้น เข้าร่วม newsletter กับ dev อีกราว 60,000 คนได้ที่:

สมัครรับ Newsletter

เริ่มต้นใช้งาน (setup ใน 30 วินาที)

1. รัน installer ของ skills.sh:

npx skills@latest add Boom-Vitt/skills-thai

(หรือติดตั้งฉบับภาษาอังกฤษต้นฉบับด้วย npx skills@latest add mattpocock/skills)

2. เลือก skills ที่ต้องการ และเลือกว่าจะติดตั้งลง coding agent ตัวไหนบ้าง อย่าลืมเลือก /setup-matt-pocock-skills ด้วย

3. รัน /setup-matt-pocock-skills ใน agent ของคุณ มันจะ:

   • ถามว่าคุณอยากใช้ issue tracker ตัวไหน (GitHub, Linear หรือไฟล์ local)
   • ถามว่าคุณติด label อะไรให้ ticket ตอน triage บ้าง (/triage ใช้ label เหล่านี้)
   • ถามว่าอยากเก็บเอกสารที่เราสร้างขึ้นไว้ที่ไหน

4. เท่านี้ก็พร้อมใช้งานแล้ว

ทำไม Skills เหล่านี้ถึงเกิดขึ้น

ผมสร้าง skills เหล่านี้ขึ้นมาเพื่อแก้ failure mode ที่เจอบ่อย ๆ เวลาใช้ Claude Code, Codex และ coding agent ตัวอื่น ๆ

#1: Agent ไม่ได้ทำสิ่งที่เราต้องการ

"ไม่มีใครรู้แน่ชัดหรอกว่าตัวเองต้องการอะไร"

David Thomas & Andrew Hunt, The Pragmatic Programmer

ปัญหา failure mode ที่พบบ่อยที่สุดในการพัฒนาซอฟต์แวร์คือความเข้าใจที่ไม่ตรงกัน คุณคิดว่า dev รู้ว่าคุณต้องการอะไร แต่พอเห็นสิ่งที่เขาสร้างออกมา — ถึงได้รู้ว่าเขาไม่เข้าใจคุณเลย

ยุค AI ก็ไม่ต่างกัน ระหว่างคุณกับ agent มีช่องว่างในการสื่อสารอยู่ วิธีแก้คือ grilling session — การให้ agent ซักถามคุณอย่างละเอียดว่ากำลังจะสร้างอะไร

วิธีแก้ คือใช้:

• /grill-me - สำหรับงานที่ไม่ใช่ code
• /grill-with-docs - เหมือน /grill-me แต่แถมของดีมาให้อีก (ดูด้านล่าง)

สองตัวนี้คือ skills ที่ได้รับความนิยมมากที่สุด มันช่วยให้คุณกับ agent เข้าใจตรงกันก่อนเริ่มงาน และคิดให้ลึกเกี่ยวกับการเปลี่ยนแปลงที่กำลังจะทำ ใช้มัน_ทุกครั้ง_ที่จะแก้อะไรก็ตาม

#2: Agent พูดเยอะเกินไป

"เมื่อมี ubiquitous language บทสนทนาระหว่าง developer และสิ่งที่เขียนอยู่ใน code ล้วนมาจาก domain model เดียวกัน"

Eric Evans, Domain-Driven-Design

ปัญหา: ช่วงเริ่มต้นของโปรเจกต์ dev กับคนที่เขาสร้างซอฟต์แวร์ให้ (domain expert) มักพูดกันคนละภาษา

ผมรู้สึกถึงแรงตึงแบบเดียวกันกับ agent ของผม ปกติ agent จะถูกโยนเข้าไปในโปรเจกต์แล้วต้องเดาศัพท์เฉพาะเอาเองระหว่างทาง ผลคือมันใช้ 20 คำในที่ที่คำเดียวก็พอ

วิธีแก้ คือภาษากลางที่ใช้ร่วมกัน (shared language) — เอกสารที่ช่วยให้ agent ถอดรหัสศัพท์เฉพาะที่ใช้ในโปรเจกต์ได้

ตัวอย่าง

นี่คือตัวอย่าง CONTEXT.md จาก repo course-video-manager ของ Matt ลองดูว่าแบบไหนอ่านง่ายกว่ากัน

• ก่อน: "มีปัญหาตอนที่ lesson ใน section ของ course ถูกทำให้เป็น 'ของจริง' (คือได้ที่อยู่ใน file system)"
• หลัง: "มีปัญหากับ materialization cascade"

ความกระชับแบบนี้ให้ผลตอบแทนกลับมา session แล้ว session เล่า

ความสามารถนี้ถูกฝังอยู่ใน /grill-with-docs แล้ว — มันคือ grilling session ที่ช่วยคุณสร้างภาษากลางร่วมกับ AI และบันทึกการตัดสินใจที่อธิบายยาก ๆ ลงใน ADR

พลังของเทคนิคนี้อธิบายเป็นคำพูดได้ยาก มันอาจเป็นเทคนิคที่เจ๋งที่สุดใน repo นี้เลยก็ได้ ลองใช้ดูแล้วจะเห็นเอง