wshobson/agents: bộ 28 subagent chuyên môn cho Claude Code

Thử hình dung thế này. Anh là trưởng phòng một mình ôm hết: sáng viết code, trưa soát lỗi, chiều kiểm tra bảo mật, tối viết tài liệu. Tới cuối ngày bàn ngập giấy, việc buổi sáng đã quên sạch. Claude Code làm việc một mình trong một phiên dài cũng rơi vào đúng cảnh đó.

Ngày 24/07/2025, Claude Code bản 1.0.60 cho phép tạo subagent, tức là "nhân viên" riêng cho từng loại việc. Cùng ngày, Seth Hobson đăng lên GitHub repo wshobson/agents: 28 nhân viên viết sẵn, chép vào máy là có cả một phòng chuyên môn.

Đọc nhanh trong 30 giây

• wshobson/agents là bộ 28 subagent mã nguồn mở (giấy phép MIT) cho Claude Code của Seth Hobson, đăng ngày 24/07/2025.
• Mỗi subagent là một chuyên gia có lời dặn riêng: kiến trúc sư backend, người review code, người kiểm tra bảo mật, người tối ưu cơ sở dữ liệu...
• Cài bằng git clone vào thư mục ~/.claude, cần Claude Code bản 1.0.60 trở lên.
• Hợp với đội đã dùng Claude Code hằng ngày. Đổi lại, tốn thêm lượt dùng vì mỗi subagent chạy riêng.

Subagent trong Claude Code là gì?

Subagent là một agent phụ mà Claude Code giao việc cho, có lời dặn riêng, bộ công cụ riêng và vùng ngữ cảnh riêng. Changelog Claude Code bản 1.0.60 ghi rằng từ bản này người dùng có thể tạo subagent cho việc chuyên biệt, gõ lệnh /agents để bắt đầu.

Quay lại hình ảnh trưởng phòng. Có subagent, trưởng phòng giao việc review code cho một người, việc kiểm tra bảo mật cho người khác. Mỗi người làm ở bàn riêng, xong chỉ nộp lại tờ kết quả. Bàn của trưởng phòng gọn hẳn, đầu óc tỉnh táo để nhìn bức tranh lớn.

Một người ôm hết so với một phòng có phân vai.

Nếu anh chị chưa dùng Claude Code, nên đọc trước bài Claude Code là gì.

Trong bộ wshobson/agents có những ai?

wshobson/agents là thư viện 28 file subagent viết sẵn. Theo README ngày 26/07/2025, các subagent chia thành sáu nhóm:

28 chuyên gia chia thành sáu phòng ban.

Mỗi subagent là một file Markdown, giống một bản mô tả công việc dán trên bàn: phần đầu ghi tên, khi nào nên gọi, được dùng công cụ nào; phần thân là lời dặn vai trò. Cấu trúc theo README:

---
name: subagent-name
description: When this subagent should be invoked
tools: tool1, tool2  # Optional - defaults to all tools
---

System prompt defining the subagent's role and capabilities

Dòng tools không bắt buộc. Bỏ trống thì subagent được dùng mọi công cụ.

Cài wshobson/agents trong 3 bước

Cần Claude Code bản 1.0.60 trở lên và Git.

Hai lệnh clone, một lệnh kiểm tra là xong.

1. Mở terminal, chạy hai lệnh theo README:

cd ~/.claude
git clone https://github.com/wshobson/agents.git

Lệnh này tạo thư mục ~/.claude/agents/, nơi Claude Code tìm subagent dùng cho mọi dự án trên máy.

2. Mở Claude Code, gõ /agents để xem danh sách subagent đã nhận.
3. Làm việc như thường. README ghi rằng Claude Code sẽ tự giao việc cho subagent phù hợp dựa vào ngữ cảnh và phần mô tả của subagent.

Lưu ý

Nếu máy đã có thư mục ~/.claude/agents/ chứa subagent anh chị tự viết, lệnh git clone sẽ báo lỗi vì thư mục đã tồn tại. Khi đó clone ra chỗ khác rồi chép từng file mình cần, đừng xóa thư mục cũ.

Giao việc cho subagent ra sao?

Cách 1: gọi đích danh. README đưa câu lệnh mẫu kiểu:

Use the code-reviewer to check my recent changes

Viết bằng tiếng Việt cũng được, miễn nêu đúng tên subagent:

Dùng security-auditor kiểm tra form đăng nhập vừa sửa,
liệt kê lỗ hổng theo OWASP, chưa sửa code.

Cách 2: để Claude Code tự phối hợp. README mô tả các kiểu phối hợp: chạy lần lượt, chạy song song, chọn người theo kết quả phân tích, và có một bước review cuối. Ví dụ yêu cầu "Implement user authentication feature" có thể đi qua backend-architect, rồi frontend-developer, test-automator và cuối cùng là security-auditor. Thứ tự thực tế do Claude Code quyết định.

Mẹo

Sau mỗi lần agent chính sửa xong một tính năng, thêm một câu "Cho code-reviewer và test-automator xem lại thay đổi này". Một lượt soát thứ hai tốn thêm ít phút, nhưng hay bắt được lỗi vặt mà lượt đầu bỏ sót.

Những điều nên biết trước khi cài cả bộ

• Giấy phép MIT: dùng và sửa được trong doanh nghiệp.
• Tốn thêm token: mỗi subagent chạy một vùng ngữ cảnh riêng, phải đọc lại phần code liên quan. Nhiều subagent cùng chạy nghĩa là nhiều lượt gọi mô hình hơn.
• Quyền công cụ: subagent không khai báo tools được dùng mọi công cụ, kể cả chạy lệnh. Giống phát thẻ ra vào mọi phòng cho nhân viên mới, nên giới hạn lại cho subagent chỉ cần đọc, như code-reviewer.
• Lời dặn bằng tiếng Anh, hướng tới công nghệ phổ biến: ví dụ payment-integration nhắc Stripe, PayPal. Cổng thanh toán Việt Nam thì anh chị phải tự bổ sung.
• Tự giao việc chưa chắc đúng: README thừa nhận có lúc Claude Code không gọi subagent hoặc chọn nhầm. Cách khắc phục là gọi đích danh.

Nhận xét của chuyên gia

Với tôi, giá trị lớn nhất của wshobson/agents không phải 28 file có sẵn, mà là một bộ ví dụ để học cách viết subagent. Khi tư vấn cho doanh nghiệp, tôi thường khuyên đọc vài file mẫu, hiểu cách viết phần mô tả sao cho Claude Code biết lúc nào nên gọi, rồi tự viết subagent theo quy trình riêng của công ty.

Hợp với ai: đội phần mềm dùng Claude Code hằng ngày, muốn thêm bước review và kiểm tra bảo mật mà không thêm người; người học Claude Code muốn xem cách người khác chia vai cho AI.

Chưa hợp với ai: người mới dùng Claude Code vài ngày, vì thêm 28 subagent sẽ rất khó biết kết quả đến từ đâu; người dùng gói Claude hạn mức thấp. Rủi ro tôi lo nhất là cài cả bộ rồi quên: subagent có quyền rộng, được gọi tự động, mà người dùng không nhớ đã cài gì.

Cách bắt đầu của tôi: clone ra một thư mục riêng, chọn hai subagent như code-reviewer và security-auditor, chép vào ~/.claude/agents/, dùng một tuần trên một dự án. Ghi lại lần nào giúp được việc, lần nào thừa, rồi mới thêm người. Muốn xem các mốc trước đó, đọc bài Claude Code chính thức ra mắt.

Một câu để nhớ: tuyển cả phòng thì dễ, quản cả phòng mới khó; bắt đầu với hai người giỏi nhất.

Câu hỏi thường gặp

wshobson/agents có miễn phí không?

Có. Repo dùng giấy phép MIT. Chi phí phát sinh là lượt dùng Claude, vì mỗi subagent chạy thêm lượt gọi mô hình.

Subagent khác gì slash command trong Claude Code?

Slash command là câu lệnh mẫu anh chị gõ để chạy trong cùng cuộc trò chuyện. Subagent là một agent riêng có ngữ cảnh và công cụ riêng, Claude Code có thể tự giao việc cho nó.

Có cài subagent chỉ cho một dự án được không?

Được. Ngoài thư mục ~/.claude/agents/ dùng cho cả máy, Claude Code đọc subagent trong thư mục .claude/agents/ của từng dự án. Anh chị chép file cần dùng vào đó.

Gọi subagent bằng tiếng Việt có được không?

Được. Câu lệnh tiếng Việt vẫn chạy, chỉ cần nêu đúng tên subagent như code-reviewer hay security-auditor.

Xem các mốc khác trong dòng thời gian AI.

Nguồn: wshobson/agents trên GitHub, 26/07/2025.