คู่มือปฏิบัติการสำหรับ Claude Code Subagents และทีมตัวแทน

คุณอาจเคยเห็นคำว่า "subagents," "Agent Teams," "orchestration," และคุณสงสัยว่าคุณพลาดอะไรไปหรือเปล่า คำตอบสั้นๆ คือ สำหรับงานส่วนใหญ่ของคุณ ไม่ใช่ แต่สำหรับงานใหญ่ ใช่ และมันคุ้มค่าที่จะเข้าใจ

มาทำให้มันเข้าใจง่ายโดยไม่ใช้ศัพท์เฉพาะกันเถอะ

Subagent คืออะไร

Subagent คือผู้ช่วยเฉพาะทางที่มีบริบทของตัวเอง, prompt ของตัวเอง, และสิทธิ์ในการใช้เครื่องมือของตัวเอง

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

นี่คือจุดสำคัญ: รักษาบริบทของเอเจนต์หลักให้สะอาด แทนที่จะให้เอเจนต์ตัวเดียวจมอยู่ใน 50,000 tokens ของการค้นหาไฟล์ คุณมี subagent ที่ทำการค้นหาและรายงานกลับด้วยบรรทัดที่มีประโยชน์สามบรรทัด

คุณประกาศ subagents ของคุณในโฟลเดอร์ .claude/agents/ ของโปรเจกต์ของคุณ แต่ละตัวมีชื่อ, คำอธิบายที่บอกว่าเมื่อไหร่ควรใช้มัน, และ system prompt

---
name: test-writer
description: ใช้เมื่อจำเป็นต้องเขียนหรือแก้ไขการทดสอบ
---
คุณเขียนการทดสอบ คุณมุ่งหวังที่จะครอบคลุม edge-case,
ไม่ใช่ happy path คุณไม่เคยแตะต้องโค้ดใน production

Agent Teams ขั้นตอนถัดไป

Agent Teams คือผู้ประสานงานหลายเอเจนต์ที่สร้างขึ้นใน Claude Code ยังอยู่ในระยะทดลอง ปิดใช้งานโดยค่าเริ่มต้น แต่เป็นจุดเริ่มต้นที่ดี

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

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

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

เมื่อไหร่ที่คุณต้องการมัน (และเมื่อไหร่ที่คุณไม่ต้องการ)

ให้ชัดเจน: การประสานงานหลายเอเจนต์ไม่มีความหมายสำหรับ 95% ของงานที่มีเอเจนต์ช่วยเหลือ สำหรับงานประจำวันส่วนใหญ่ของคุณ เอเจนต์เดียวจะเร็วและง่ายกว่า

ตอนนี้ การใช้หลายเอเจนต์ยังเป็นวิธีที่มีค่าใช้จ่ายและทดลองในการจัดการโปรเจกต์ขนาดใหญ่

คุณต้องการมันเมื่อ:

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

คุณไม่ต้องการมันสำหรับการแก้ไขบั๊ก, ฟีเจอร์ที่มุ่งเน้น, หรืออะไรก็ตามที่สามารถอยู่ในหัวเดียว

กับดักคือการสร้าง "ทีม" เอเจนต์สิบตัวสำหรับสิ่งที่เอเจนต์ตัวเดียวทำในห้านาที คุณจะต้องจ่ายใน tokens และความซับซ้อนสำหรับการทำงานขนานที่งานไม่ได้ร้องขอ

ปัญหาที่แท้จริง: การมองเห็น

นี่คือสิ่งที่ไม่ได้พูดถึงมากพอ ในขณะที่คุณเรียกใช้ subagents หลายตัวหรือ Agent Team คุณจะสูญเสียเส้นทาง

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

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

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

เริ่มต้นที่ไหน

อย่ากระโดดไปที่ทีมเอเจนต์แปดตัวทันที

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

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

การใช้หลายเอเจนต์จะตอบแทนผู้ที่มีโครงสร้างก่อนที่จะเริ่ม ไม่ใช่ผู้ที่เริ่มเอเจนต์มากที่สุด