Subagents Trong Claude Code: Tạo Đội AI Chuyên Biệt Chỉ Với File Markdown

🤖 Subagents Là Gì?

Subagents là các trợ lý AI chuyên biệt trong Claude Code, được Claude chính gọi tới mỗi khi cần một chuyên gia giải quyết task cụ thể. Thay vì nhét mọi thứ vào một agent, bạn tách thành nhiều sub-agent mỗi con chỉ làm một việc và làm rất giỏi.

Mỗi subagent chạy với context window riêng, tool set hạn chế, và prompt chuyên môn hóa. Kết quả, agent chính giữ được context sạch, còn subagent trả về đúng thứ bạn cần.

📁 Tạo Subagent Với File Markdown

Subagent được định nghĩa bằng file markdown trong thư mục .claude/agents/. Tên file chính là tên agent, ví dụ .claude/agents/code-reviewer.md.

Cấu trúc file gồm YAML frontmatter ở đầu và system prompt ở dưới. Khi bạn khởi động Claude Code, nó tự quét thư mục này và load tất cả agent có sẵn.

🔑 Bốn Trường Frontmatter Quan Trọng

Mỗi file subagent cần bốn trường chính trong frontmatter.

name: tên định danh của agent, viết thường, gạch ngang, ví dụ code-reviewer.

description: mô tả khi nào dùng agent này. Claude chính đọc field này để quyết định có delegate hay không, nên viết rõ ràng, có ví dụ.

tools: danh sách các tool agent được phép dùng, ví dụ Read, Grep, Bash. Giới hạn tool giúp agent tập trung và an toàn hơn.

model: model nào chạy agent này, có thể là sonnet, opus, hoặc haiku tùy độ phức tạp của task.

🔄 Cách Subagent Nhận Việc Và Trả Kết Quả

Khi bạn nói chuyện với Claude Code, agent chính tự phân tích yêu cầu. Nếu thấy task khớp với description của một subagent nào đó, nó delegate bằng cách gọi Task tool với prompt mô tả công việc.

Subagent chạy độc lập trong context riêng, dùng các tool được cấp, rồi trả về một báo cáo gọn cho agent chính. Agent chính tổng hợp kết quả và tiếp tục cuộc hội thoại với bạn.

Bạn cũng có thể gọi trực tiếp subagent bằng cách nhắc tên nó trong prompt, ví dụ "dùng code-reviewer để check file này".

💡 Bốn Use Case Thực Tế

Code Reviewer: review code sau mỗi lần viết, check naming, error handling, security. Chỉ cần tool Read và Grep.

Test Runner: chạy test, đọc log, fix lỗi đơn giản. Cần Bash, Read, Edit.

Security Auditor: scan code tìm lỗ hổng, hard-coded secrets, SQL injection. Chỉ đọc, không sửa.

Researcher: nghiên cứu docs, search web, tổng hợp thông tin mà không làm loãng context chính.

🚀 Tại Sao Nên Dùng Subagent

Tách việc rõ ràng, mỗi agent một nhiệm vụ. Context chính sạch, không bị nhét 50 file log vào. Tùy biến cao, mỗi agent có model và tool riêng phù hợp task. Team AI riêng cho dự án, lưu trong git, share với cả đội.

Subagent là cách đơn giản nhất để biến Claude Code từ một trợ lý đơn lẻ thành một đội ngũ AI chuyên biệt làm việc cho bạn.

#AI #ClaudeCode #Subagents #VibeAICoder #DevTools #learnontiktok