เขียน SKILL.md เก็บไว้เป็นสิบไฟล์ แต่ Agent ยังทำงานผิดแบบเดิมซ้ำทุกครั้ง

มีปรากฏการณ์ที่พบบ่อยในทีมที่เริ่มใช้ GitHub Copilot จริงจัง คือยิ่งเขียนไฟล์กฎและคำแนะนำเก็บไว้เยอะเท่าไหร่ กลับยิ่งรู้สึกว่า Agent ไม่ได้ทำงานแม่นขึ้นตามจำนวนไฟล์ที่เพิ่มเลย บางทีมมีไฟล์ SKILL.md เก็บไว้เป็นสิบไฟล์ ครอบคลุมแทบทุก Workflow ที่นึกออก แต่ Agent ก็ยังพลาดจุดเดิมซ้ำ ๆ อยู่ดี

ปรากฏการณ์นี้ขัดกับสามัญสำนึกที่คิดว่ายิ่งให้ข้อมูลเยอะ Agent ยิ่งฉลาดขึ้น แต่ความจริงคือปัญหามักไม่ได้อยู่ที่จำนวนไฟล์ แต่อยู่ที่คุณภาพและความชัดเจนของสิ่งที่เขียนอยู่ในไฟล์เหล่านั้น รวมถึงวิธีที่ Agent เลือกว่าจะหยิบไฟล์ไหนมาใช้ในสถานการณ์ไหน

บทความนี้จะอธิบายว่า Agent Skills คืออะไร ไฟล์ SKILL.md มีโครงสร้างแบบไหนที่ทำให้ Agent ใช้งานได้จริง และทำไมทีมที่มีไฟล์เยอะกลับได้ผลลัพธ์ไม่ต่างจากทีมที่ไม่มีไฟล์เลย พร้อมแนวทางแก้ที่ตรงจุดกว่าการเขียนไฟล์เพิ่มไปเรื่อย ๆ

Agent Skills คืออะไร และ SKILL.md ทำหน้าที่อะไรกันแน่

Agent Skills คือกลไกที่ให้ทีมเขียนขั้นตอนการทำงานที่ทำซ้ำบ่อย ๆ เก็บไว้เป็นไฟล์ที่ Agent อ่านและนำไปใช้ได้ทุกครั้งที่เจองานลักษณะเดียวกัน แทนที่จะต้องพิมพ์อธิบายขั้นตอนเดิมซ้ำใหม่ทุกครั้งที่มอบหมายงาน ไฟล์ SKILL.md จึงทำหน้าที่เหมือนคู่มือขั้นตอนที่บันทึกความรู้เฉพาะทางของทีมไว้ในรูปแบบที่ Agent อ่านและทำตามได้

ความต่างจาก Custom Instructions ทั่วไปคือ Custom Instructions มักเป็นกฎกว้าง ๆ ที่ใช้ตลอดเวลาไม่ว่าจะทำงานอะไร เช่นตั้งชื่อตัวแปรแบบไหน ในขณะที่ SKILL.md มักเจาะจงไปที่ Workflow เฉพาะเรื่อง เช่นขั้นตอนการเพิ่มหน้าใหม่ในระบบ ขั้นตอนการเขียนเทสต์ให้ครบตามมาตรฐานของทีม หรือขั้นตอนการตรวจสอบก่อน Deploy ที่ต้องทำเป็นลำดับเฉพาะ

การมี SKILL.md ที่ดีช่วยให้ Agent ทำงานที่ทำซ้ำบ่อย ๆ ได้สม่ำเสมอมากขึ้น เพราะมันไม่ต้องเดาขั้นตอนเองจากบริบททั่วไป แต่มีขั้นตอนที่ทีมกำหนดไว้ชัดเจนให้ทำตาม คล้ายกับการมีเอกสาร Onboarding ที่ละเอียดสำหรับพนักงานใหม่ ยิ่งเอกสารชัดเจนแค่ไหน พนักงานใหม่ก็ยิ่งทำงานตรงมาตรฐานทีมได้เร็วขึ้นเท่านั้น

ทำไมมีไฟล์ SKILL.md เยอะ แต่ Agent ยังพลาดจุดเดิมซ้ำ

สาเหตุที่พบบ่อยที่สุดคือไฟล์แต่ละไฟล์เขียนขอบเขตกำกวมเกินไปจนทับซ้อนกัน เมื่อ Agent เจองานหนึ่งที่เข้าเงื่อนไขของหลายไฟล์พร้อมกัน มันต้องตัดสินใจว่าจะให้น้ำหนักกับไฟล์ไหนมากกว่า ถ้าไฟล์เหล่านั้นมีคำแนะนำที่ขัดแย้งกันเองแม้เพียงเล็กน้อย ผลลัพธ์ที่ได้ก็จะไม่สม่ำเสมอ บางครั้งทำตามไฟล์หนึ่ง บางครั้งทำตามอีกไฟล์

อีกสาเหตุคือไฟล์ SKILL.md จำนวนมากถูกเขียนไว้ตั้งแต่ช่วงแรกที่ทีมเริ่มใช้ Agent แล้วไม่เคยได้รับการปรับปรุงอีกเลย ทั้งที่ Workflow จริงของทีมเปลี่ยนไปแล้ว เช่นทีมเปลี่ยนขั้นตอนการ Deploy ใหม่ แต่ไฟล์ SKILL.md เดิมยังเขียนขั้นตอนแบบเก่าไว้อยู่ Agent จึงยังคงแนะนำหรือทำตามขั้นตอนเก่าที่ไม่ใช้แล้ว ทำให้ดูเหมือน Agent 'พลาด' ทั้งที่จริงแล้วมันแค่ทำตามไฟล์ที่ล้าสมัยอย่างซื่อสัตย์

สาเหตุที่สามซึ่งมักถูกมองข้ามคือไฟล์เขียนไว้กว้างเกินไปจนไม่มีรายละเอียดพอให้ Agent ตัดสินใจได้ชัด เช่นเขียนแค่ว่า 'เขียนเทสต์ให้ครบ' โดยไม่บอกว่าครบแบบไหน ครอบคลุมกรณีอะไรบ้าง ไฟล์แบบนี้แม้จะมีอยู่จริงก็แทบไม่ต่างจากไม่มีไฟล์เลย เพราะไม่ได้ให้ข้อมูลที่ Agent นำไปใช้ตัดสินใจได้จริง

เขียน SKILL.md แบบไหนที่ Agent นำไปใช้ได้จริง

ไฟล์ SKILL.md ที่ใช้งานได้ดีมักมีลักษณะร่วมกันบางอย่าง ไม่ใช่แค่ยาวหรือครอบคลุมเยอะ แต่คือความชัดเจนของขอบเขตและขั้นตอนที่ระบุไว้

• ระบุว่าไฟล์นี้ใช้เมื่อไหร่ — เขียนเงื่อนไขชัดว่างานแบบไหนควรใช้ Skill นี้ ลดโอกาสที่ Agent จะหยิบไฟล์ผิดบริบทมาใช้
• เขียนขั้นตอนเป็นลำดับ ไม่ใช่คำอธิบายกว้าง ๆ — ระบุทีละขั้นว่าต้องทำอะไรก่อนหลัง แทนที่จะเขียนเป้าหมายกว้าง ๆ แล้วปล่อยให้ Agent ตีความเอง
• ยกตัวอย่างประกอบให้เห็นรูปแบบจริง — ตัวอย่างโค้ดหรือไฟล์ที่ทำตามขั้นตอนนี้แล้วถูกต้อง ช่วยให้ Agent เทียบเคียงได้ง่ายกว่าคำอธิบายเป็นข้อความล้วน
• ระบุข้อยกเว้นที่พบบ่อย — ถ้ามีกรณีที่ไม่ควรทำตามขั้นตอนปกติ ให้เขียนไว้ชัดว่าเกิดขึ้นเมื่อไหร่และควรทำอะไรแทน

จัดระเบียบไฟล์ SKILL.md หลายไฟล์ไม่ให้ทับซ้อนกันยังไง

เมื่อทีมมี SKILL.md หลายไฟล์ ปัญหาที่ตามมาคือการจัดการให้แต่ละไฟล์มีขอบเขตชัดเจนไม่ทับกัน วิธีที่ช่วยได้คือแบ่งไฟล์ตาม Workflow ที่แยกจากกันจริง ๆ ในทางปฏิบัติ เช่น Workflow การเพิ่มฟีเจอร์ใหม่ Workflow การแก้บั๊ก และ Workflow การเตรียม Release แต่ละไฟล์ควรครอบคลุมเฉพาะขั้นตอนของ Workflow นั้นเท่านั้น ไม่ใช่พยายามยัดทุกอย่างที่เกี่ยวข้องลงในไฟล์เดียว

อีกแนวทางคือทำรายการสั้น ๆ ไว้ที่จุดเดียวว่าไฟล์ SKILL.md แต่ละไฟล์มีไว้ทำอะไร คล้ายสารบัญที่ช่วยให้ทั้งคนในทีมและ Agent เห็นภาพรวมได้เร็ว แทนที่จะต้องไล่เปิดอ่านทีละไฟล์เพื่อเข้าใจว่าแต่ละไฟล์ครอบคลุมอะไรบ้าง การมีจุดอ้างอิงกลางแบบนี้ยังช่วยให้ทีมสังเกตเห็นได้ง่ายขึ้นว่ามีไฟล์ไหนที่เนื้อหาซ้ำหรือขัดแย้งกับไฟล์อื่นอยู่

เมื่อพบว่าสองไฟล์มีเนื้อหาทับซ้อนกันบางส่วน ทางเลือกที่ดีกว่าการปล่อยไว้ทั้งสองไฟล์คือรวมส่วนที่ซ้ำกันไว้ในที่เดียว แล้วให้ไฟล์อื่นอ้างอิงกลับมาแทนที่จะเขียนซ้ำ วิธีนี้ทำให้เมื่อต้องแก้กฎในอนาคต แก้ที่จุดเดียวก็มีผลครบทุกที่ที่อ้างอิงถึง ลดความเสี่ยงที่จะแก้ไฟล์หนึ่งแล้วลืมแก้อีกไฟล์ที่เนื้อหาคล้ายกัน

รู้ได้ยังไงว่า SKILL.md ที่เขียนไว้ใช้งานได้ผลจริง

วิธีที่ตรงที่สุดในการประเมินคือดูจากผลลัพธ์ของงานที่มอบหมายให้ Agent ทำในลักษณะที่ Skill นั้นควรครอบคลุม ถ้า Agent ยังคงพลาดจุดเดิมซ้ำ ๆ ทั้งที่มี SKILL.md เขียนไว้แล้ว นั่นเป็นสัญญาณว่าไฟล์นั้นอาจเขียนไม่ชัดพอ หรือ Agent ไม่ได้หยิบไฟล์นั้นมาใช้ในสถานการณ์ที่ควรใช้จริง

ทีมที่ตั้งใจปรับปรุงคุณภาพของ SKILL.md อย่างจริงจังมักเก็บบันทึกสั้น ๆ ไว้ทุกครั้งที่พบว่า Agent ทำงานพลาดในรูปแบบเดิมซ้ำ แล้วย้อนกลับไปดูว่าไฟล์ที่ควรครอบคลุมกรณีนั้นเขียนไว้ยังไง บ่อยครั้งจะพบว่าปัญหาไม่ใช่เพราะไม่มีไฟล์ครอบคลุม แต่เพราะไฟล์นั้นเขียนคลุมเครือในจุดที่พลาดพอดี การแก้ตรงจุดนั้นซ้ำ ๆ ทำให้ไฟล์ค่อย ๆ แม่นยำขึ้นเรื่อย ๆ ตามการใช้งานจริง แทนที่จะเขียนไฟล์ใหม่ทับซ้อนไปเรื่อย ๆ โดยไม่แก้ต้นตอ

เทียบ SKILL.md กับ Custom Instructions ว่าใช้ตอนไหน

ตารางนี้ช่วยแยกให้เห็นว่าควรใช้กลไกไหนกับสถานการณ์แบบไหน:

ให้ทีมช่วยกันดูแล SKILL.md อย่างต่อเนื่องยังไง

SKILL.md ที่ดีไม่ได้เกิดจากคนคนเดียวเขียนแล้วจบ แต่ต้องอาศัยทั้งทีมช่วยกันปรับปรุงตามประสบการณ์การใช้งานจริง ทีมที่ทำได้ผลดีมักกำหนดให้การอัปเดต SKILL.md เป็นส่วนหนึ่งของ Pull Request เมื่อมีการเปลี่ยนแปลง Workflow สำคัญ แทนที่จะแยกเป็นงานต่างหากที่มักถูกลืมไปหลังจากเปลี่ยนแปลงจริง

อีกแนวทางที่ช่วยได้คือเปิดให้ทุกคนในทีมเสนอแก้ไข SKILL.md ผ่าน Pull Request เหมือนกับการแก้โค้ดทั่วไป ไม่ใช่ให้เป็นหน้าที่ของคนใดคนหนึ่งเพียงคนเดียว เพราะแต่ละคนในทีมมักเจอสถานการณ์ที่ Agent ทำงานพลาดในบริบทต่างกัน การเปิดให้ทุกคนช่วยปรับปรุงทำให้ไฟล์ครอบคลุมสถานการณ์จริงได้กว้างขึ้นเรื่อย ๆ

ข้อผิดพลาดที่ทีมมักเจอตอนเริ่มใช้ Agent Skills

• เขียนไฟล์ SKILL.md ใหม่ทุกครั้งที่เจอปัญหา แทนที่จะย้อนกลับไปแก้ไฟล์เดิมที่ครอบคลุมกรณีนั้นอยู่แล้วให้ชัดขึ้น
• เขียนขอบเขตของแต่ละไฟล์กว้างเกินไปจนทับซ้อนกับไฟล์อื่น ทำให้ Agent สับสนว่าควรทำตามไฟล์ไหน
• ไม่มีใครรับผิดชอบปรับปรุงไฟล์เมื่อ Workflow จริงของทีมเปลี่ยนไปแล้ว ปล่อยให้ไฟล์ล้าสมัยเงียบ ๆ
• เข้าใจผิดว่ายิ่งมีไฟล์เยอะยิ่งดี ทั้งที่จำนวนไฟล์ไม่ได้สัมพันธ์กับคุณภาพผลลัพธ์โดยตรง
• เขียนขั้นตอนเป็นคำอธิบายกว้าง ๆ แทนที่จะเป็นลำดับขั้นตอนที่ชัดเจนพอให้ Agent ทำตามได้จริง

สรุป

Agent Skills เปิดให้ทีมบันทึก Workflow ที่ทำซ้ำบ่อยไว้ในไฟล์ SKILL.md เพื่อให้ Agent ทำตามได้สม่ำเสมอโดยไม่ต้องอธิบายซ้ำทุกครั้ง แต่การมีไฟล์เยอะไม่ได้แปลว่าผลลัพธ์จะดีขึ้นเสมอไป ปัญหาที่แท้จริงมักอยู่ที่ความชัดเจนของแต่ละไฟล์และความซ้ำซ้อนระหว่างไฟล์มากกว่าจำนวนไฟล์ทั้งหมด

ทีมที่อยากได้ผลลัพธ์ดีขึ้นจริง ควรกลับไปตรวจสอบไฟล์ที่มีอยู่แล้วว่าเขียนชัดพอหรือไม่ ทับซ้อนกับไฟล์อื่นหรือเปล่า และยังตรงกับ Workflow ปัจจุบันของทีมอยู่หรือไม่ ก่อนที่จะเขียนไฟล์ใหม่เพิ่มเข้าไปเรื่อย ๆ โดยไม่แก้ต้นตอของปัญหาเดิม

• SKILL.md ใช้บันทึก Workflow เฉพาะที่ทำซ้ำบ่อย ต่างจาก Custom Instructions ที่เป็นกฎกว้างใช้ตลอดทุกงาน
• ไฟล์เยอะไม่ได้แปลว่าดีขึ้นเสมอไป ความชัดเจนและไม่ทับซ้อนกันสำคัญกว่าจำนวน
• ให้ทั้งทีมช่วยกันปรับปรุงไฟล์ผ่าน Pull Request อย่างต่อเนื่อง แทนที่จะให้เป็นหน้าที่ของคนเดียว

คำถามที่พบบ่อย