Claude Code Subagents và Đội Ngũ Tác Nhân: Hướng Dẫn Thực Tiễn

Bạn đã thấy các từ "subagents," "Đội Ngũ Tác Nhân," "điều phối," và bạn tự hỏi liệu mình có bỏ lỡ điều gì không. Câu trả lời ngắn gọn: đối với hầu hết các nhiệm vụ của bạn, không. Nhưng với công việc lớn, có, và đáng để hiểu.

Hãy giải thích nó mà không dùng thuật ngữ phức tạp.

Subagent thực sự là gì

Một subagent là một trợ lý chuyên biệt với ngữ cảnh riêng, lời nhắc riêng và quyền công cụ riêng.

Khi tác nhân chính gặp một nhiệm vụ phụ được xác định rõ ràng, nó ủy thác cho một subagent. Subagent đó làm việc trong cửa sổ ngữ cảnh riêng của mình, thực hiện công việc và chỉ trả về kết quả. Tác nhân chính không bị lịch sử đầy đủ của nó làm ô nhiễm ngữ cảnh, nó chỉ nhận được kết luận.

Đó là điểm mấu chốt: giữ cho ngữ cảnh của tác nhân chính sạch sẽ. Thay vì một tác nhân chìm trong 50,000 token của tìm kiếm tệp, bạn có một subagent thực hiện tìm kiếm và báo cáo lại ba dòng hữu ích.

Bạn khai báo các subagent của mình trong thư mục .claude/agents/ của dự án. Mỗi cái có một tên, một mô tả về khi nào nên sử dụng nó, và một lời nhắc hệ thống.

---
name: test-writer
description: Sử dụng khi cần viết hoặc sửa lỗi kiểm tra
---
Bạn viết kiểm tra. Bạn nhắm đến việc bao phủ các trường hợp biên,
không phải con đường hạnh phúc. Bạn không bao giờ chạm vào mã sản xuất.

Đội Ngũ Tác Nhân, bước tiếp theo

Đội Ngũ Tác Nhân là bộ điều phối đa tác nhân được tích hợp trong Claude Code. Vẫn đang thử nghiệm, bị vô hiệu hóa theo mặc định, nhưng là một điểm khởi đầu vững chắc.

Ý tưởng: một tác nhân dẫn đầu chia một nhiệm vụ lớn, ủy thác mỗi phần cho một tác nhân chuyên gia (với mô hình, lời nhắc, công cụ riêng), các chuyên gia làm việc song song trên một hệ thống tệp chia sẻ, và kết quả chảy ngược lại cho tác nhân dẫn đầu.

Nếu "ủy thác cho một chuyên gia" nghe giống như subagents, điều đó là bình thường. Đội Ngũ Tác Nhân là ý tưởng đó được đẩy đến mức chạy nhiều tác nhân thực sự song song, không chỉ từng cái một.

Ngoài cái tích hợp sẵn, có các bộ điều phối bên thứ ba như Multiclaude và Gas Town. Chúng có quan điểm rõ ràng, đó là điều làm cho chúng trở thành điểm khởi đầu tốt khi bạn bắt đầu: chúng quyết định cho bạn cho đến khi bạn xây dựng thói quen riêng của mình.

Khi nào bạn cần nó (và khi nào không)

Hãy rõ ràng: điều phối đa tác nhân là vô nghĩa cho 95% các nhiệm vụ hỗ trợ tác nhân. Đối với hầu hết công việc hàng ngày của bạn, một tác nhân duy nhất nhanh hơn và đơn giản hơn.

Hiện tại, đa tác nhân vẫn là một cách đắt đỏ và thử nghiệm để tấn công các dự án lớn.

Bạn cần nó khi:

• Dự án chia thành các phần thực sự độc lập chạm vào các tệp khác nhau.
• Một cửa sổ ngữ cảnh duy nhất không thể chứa toàn bộ.
• Bạn muốn song song hóa một tái cấu trúc rộng hoặc một di chuyển toàn bộ kho lưu trữ.

Bạn không cần nó cho một sửa lỗi, một tính năng tập trung, hoặc bất cứ điều gì phù hợp trong một đầu.

Cái bẫy là khởi động một "đội" mười tác nhân cho một việc mà một tác nhân có thể làm trong năm phút. Bạn trả giá bằng token và sự phức tạp cho một sự song song mà nhiệm vụ không bao giờ yêu cầu.

Vấn đề thực sự: khả năng hiển thị

Đây là điều không được nói đến đủ. Ngay khi bạn chạy nhiều subagents hoặc một Đội Ngũ Tác Nhân, bạn mất dấu.

Một tác nhân dẫn đầu ủy thác cho năm chuyên gia. Ai đang làm việc? Ai đã hoàn thành? Ai đang chờ quyết định? Trong một terminal bạn thấy một bức tường văn bản cuộn, và bạn không thể biết ai đang làm gì.

Đây là nơi một bảng điều khiển trực quan thay đổi mọi thứ. AgentsRoom hiển thị mỗi tác nhân và mỗi subagent như một ô riêng, với trạng thái của nó được viết rõ ràng. Bạn xem sự ủy thác diễn ra, bạn thấy ai đang chờ phản hồi của bạn, bạn thấy ai bị lỗi. Bức tường văn bản trở thành một bản đồ có thể đọc được.

Không có cái nhìn đó, điều phối đa tác nhân vẫn là một bản demo ấn tượng mà không thể quản lý hàng ngày. Với nó, nó trở thành một công cụ bạn thực sự sử dụng.

Bắt đầu từ đâu

Đừng nhảy thẳng vào một đội tám tác nhân.

Bắt đầu với một hoặc hai subagents cho các nhiệm vụ chính xác, lặp đi lặp lại: một cái viết kiểm tra, một cái tìm kiếm trong cơ sở mã. Bạn sẽ nhanh chóng cảm nhận được lợi ích trên ngữ cảnh của tác nhân chính.

Khi cơ chế đó trở nên tự nhiên, bật Đội Ngũ Tác Nhân cho công việc chia tách rõ ràng. Theo dõi ai đang làm gì, phê duyệt kế hoạch trước khi thực hiện, và dừng lại ngay khi việc xem xét trở thành nút thắt cổ chai của bạn.

Đa tác nhân thưởng cho những người cấu trúc trước khi họ khởi động. Không phải những người khởi động nhiều tác nhân nhất.