agency-agents: นิยามบทบาท 300+ แบบสำหรับ Coding Agent ของคุณ และสิ่งที่มันยังทำไม่ได้

coding agent ของคุณมีบุคลิกเริ่มต้นอยู่แบบเดียว คือเป็นมืออาชีพทั่วไปที่ทำได้สารพัด ถ้าสั่งให้มันรีวิว authentication flow คุณก็จะได้คำแนะนำที่สมเหตุสมผลแต่จำไม่ติด ต่างจากกรณีที่คุณถามผู้ตรวจสอบความปลอดภัยซึ่งมี threat model และ checklist อยู่ในมือ คุณจะได้ข้อค้นพบเป็นชิ้นเป็นอัน ความต่างนี้มีต้นทุนแค่ไฟล์ markdown ไฟล์เดียว ซึ่งเป็นเหตุผลที่ agency-agents มียอดดาวถึง 149,312 ดวง

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

สรุปสั้น ๆ (TL;DR)

นี่คือหนึ่งในห้าบทวิเคราะห์เจาะลึกจากบทความรวมเครื่องมือของเรา ว่าด้วยเครื่องมือโอเพนซอร์สที่ต่อยอด coding agent

agency-agents คือชุดนิยามบทบาทของเอเจนต์กว่า 300 รายการ ครอบคลุมราว 20 หมวด ใช้สัญญาอนุญาต MIT และติดตั้งเข้า Claude Code, Cursor, Codex, Gemini CLI, OpenCode รวมถึงเครื่องมืออื่น ๆ อีกประมาณสิบกว่าตัวได้ด้วยคำสั่งเดียว แต่ละไฟล์อธิบายตัวตน กระบวนการทำงาน สิ่งที่ต้องส่งมอบ และนิยามของคำว่า "เสร็จ" บทบาทเปลี่ยนวิธีที่เอเจนต์ตีกรอบงาน แต่ไม่ได้ให้ข้อมูลที่มันไม่มี และไม่คงอยู่ข้ามเซสชัน วิธีที่ได้ผลคือติดตั้งหมวดที่คุณทำงานด้วย แก้ไฟล์ให้ตรงกับ stack ของคุณ แล้วยกระดับบทบาทที่คุณหยิบใช้ทุกสัปดาห์ให้เป็น saved configuration ที่ทีมมอบหมายได้

สิ่งที่คุณกำลังติดตั้ง

นับจากโครงสร้างรีโพสิตอรีเมื่อวันที่ 1 กันยายน 2026 มีไฟล์ markdown ทั้งหมด 312 ไฟล์ กระจายอยู่ใน 20 โฟลเดอร์หมวดหมู่ระดับบนสุด ส่วน README ของรีโพสิตอรียังเขียนว่า "230+" ซึ่งล้าสมัยแล้ว

หมวด engineering คือจุดที่ทีมส่วนใหญ่เริ่ม และมีความเฉพาะทางสูงกว่าที่ชุด prompt ทั่วไปมักทำได้ นอกจาก Frontend Developer กับ Backend Architect แล้ว ยังมี Network Engineer ที่เจาะจง Cisco IOS-XE และ Juniper Junos, Embedded Firmware Engineer สำหรับเป้าหมาย ESP32 และ STM32, Incident Response Commander สำหรับงาน post-mortem และความพร้อมด้าน on-call และ Codebase Onboarding Engineer ที่เขียนขึ้นมาให้สำรวจรีโพสิตอรีแบบอ่านอย่างเดียว แล้วรายงานข้อเท็จจริงแทนที่จะเสนอการแก้ไข

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

ติดตั้งเฉพาะส่วนที่คุณต้องการ

git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents

./scripts/install.sh                                       # interactive
./scripts/install.sh --tool claude-code --division engineering,security
./scripts/install.sh --tool cursor --agent frontend-developer
./scripts/install.sh --list teams
./scripts/install.sh --tool opencode --division engineering --dry-run

มีคำเตือนหนึ่งที่รีโพสิตอรีระบุไว้ แต่บทความส่วนใหญ่พูดถึงมักข้ามไป นั่นคือ runtime ของ OpenCode ลงทะเบียนเอเจนต์ได้ราว 119 ตัว แล้วตัดที่เหลือทิ้งไปเงียบ ๆ การติดตั้งเฉพาะบางส่วนด้วย --division จะช่วยให้คุณอยู่ใต้ขีดจำกัดนี้ และตัวติดตั้งจะเตือนคุณเมื่อจำนวนที่เลือกจะเกินลิมิต การถูกตัดทิ้งแบบเงียบ ๆ คือความล้มเหลวที่แย่ที่สุดเท่าที่จะเป็นไปได้ เพราะบทบาทที่คุณต้องการหายไปโดยไม่มีอะไรบอกคุณเลย

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

ขีดจำกัดของนิยามบทบาท

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

มีสองอย่างที่บทบาททำไม่ได้

อย่างแรก มันให้ข้อมูลที่โมเดลไม่มีไม่ได้ บทบาท Backend Architect อาจสร้างโค้ดที่จัดระเบียบดีเยี่ยมตาม interface ที่มันเดาเอา บทบาทช่วยปรับโครงสร้างให้ดีขึ้น แต่ไม่ได้ทำให้ผลลัพธ์ถูกต้อง

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

จากนิยามบทบาทสู่ Agent ที่มอบหมายงานได้

นิยามบทบาทคือ prompt ที่คุณต้องพิมพ์ซ้ำ ส่วน Agent ใน Sharkly คือ saved configuration ที่ประกอบด้วย instructions, runtime, skills, repositories และ environment นั่นคือเวอร์ชันที่คงทนถาวรของสิ่งที่ไฟล์ใน ~/.claude/agents/ พยายามจะเป็น

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

Sharkly ไม่ใช่ตัวแทนที่มาแทน Claude Code, Codex หรือบทบาทต่าง ๆ ในรีโพสิตอรีนี้ แต่เข้ามาเพิ่มชั้นของ task ที่ใช้ร่วมกัน, Computer, context, การควบคุม และการรีวิวให้กับสิ่งเหล่านั้น การใช้งานโมเดลยังคงเป็นไปตาม subscription หรือ API key ที่ตั้งค่าไว้ในเครื่องมือเหล่านั้น

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

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

ใช้รีโพสิตอรีเป็นคลังบทบาท ไม่ใช่เป็นทีม

ใช้ agency-agents โดยตรงเมื่อคุณทำงานคนเดียว ทำในเครื่องตัวเอง และอยากได้กรอบการทำงานที่ดีขึ้นสำหรับงานของวันนี้ ติดตั้งสักหนึ่งหมวด อ่านไฟล์ แล้วได้ประโยชน์ภายในยี่สิบนาที

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

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

Agent ค้นคว้า ลงมือทำ ทดสอบ และรายงาน ส่วนคนเป็นผู้กำหนดทิศทาง ให้อำนาจ และรับผลลัพธ์

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

agency-agents ใช้กับเครื่องมืออื่นนอกจาก Claude Code ได้ไหม ได้ สคริปต์แปลงไฟล์จะสร้างไฟล์อินทิเกรตแยกตามเครื่องมือ และ install.sh --tool จะเล็งไปที่เครื่องมือใดเครื่องมือหนึ่ง เป้าหมายที่รองรับได้แก่ Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Copilot, Windsurf, Aider และ Kimi Code นอกจากนี้ยังมีเดสก์ท็อปแอปสำหรับ macOS, Linux และ Windows ด้วย

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

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

นี่เหมือน agent framework ไหม ไม่เหมือน framework ให้คุณเรื่องการประสานงาน runtime ในโค้ด ส่วน agency-agents ให้ไฟล์ markdown ที่เปลี่ยนพฤติกรรมของเอเจนต์ที่มีอยู่แล้ว คนละชั้นกัน ไม่ทับซ้อนกัน

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

สรุปฉบับสั้น

agency-agents คือเวอร์ชันที่ดีที่สุดเท่าที่มีของแนวคิดหนึ่ง คือเอเจนต์จะทำงานได้ดีขึ้นเมื่อมันรู้ว่าตัวเองกำลังสวมบทบาทอะไร ติดตั้งสักหนึ่งหมวด อ่านไฟล์ แล้วแก้ให้เข้ากับทีมของคุณ

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