Subagents: chia việc lớn cho một đội Claude

Vì sao cần subagent

Hai lý do chính. Một: cách ly context — agent con đọc 30 file để review bảo mật mà không làm phiên chính phình to; nó chỉ trả về bản kết luận. Hai: chuyên môn hóa — mỗi agent có lời dặn riêng, sắc hơn một agent "biết tuốt".

Việc nào đáng tách

Việc ngắn hay phụ thuộc chằng chịt vào nhau thì để phiên chính tự làm — chi phí điều phối sẽ lớn hơn lợi ích.

• Review: một agent viết code, một agent độc lập soi lỗi — góc nhìn thứ hai thật sự
• Nghiên cứu song song: ba agent đọc ba phần tài liệu cùng lúc rồi tổng hợp
• Việc phụ dài nhưng độc lập: cập nhật tài liệu, viết test cho module vừa xong

Định nghĩa một subagent

Trong Claude Code, subagent định nghĩa bằng file trong .claude/agents/ — gồm tên, mô tả khi nào dùng, và system prompt riêng.

---
name: security-reviewer
description: Reviews code changes for security issues.
  Use after significant changes to auth, API, or data handling.
---
You are a strict security reviewer.
Check: injection, authz gaps, secrets in code, unsafe deps.
Output: findings ranked by severity, with file:line refs.
Do NOT fix anything — report only.

Giao việc và nhận kết quả

Từ phiên chính, bạn yêu cầu: "dùng security-reviewer rà các thay đổi hôm nay". Agent con chạy trong context riêng và trả về báo cáo gọn — phiên chính chỉ nhận kết luận, không nhận 30 file nó đã đọc.

Với việc song song, nêu rõ các phần độc lập: "chạy 3 hướng nghiên cứu này song song, mỗi hướng trả về 5 gạch đầu dòng".

Nguyên tắc giữ hệ thống dễ hiểu

• Mỗi subagent một nhiệm vụ nói được trong một câu
• Giới hạn quyền: agent review không cần quyền sửa file
• Kết quả trả về theo format cố định để phiên chính dễ tổng hợp
• Bắt đầu với một subagent; thêm con thứ hai khi con đầu đã chứng minh giá trị