Thư mục agents (subagent)
4 phút đọccập nhật 30/9/2026
Subagent là trợ lý chuyên việc, chạy trong context riêng. Vì sao và khi nào dùng: xem bài Subagent. Trang này để tra cứu.
Nằm ở đâu
| Thư mục | Phạm vi |
|---|---|
.claude/agents/ | Dự án này — commit cho cả nhóm |
~/.claude/agents/ | Mọi dự án của bạn |
Trùng tên thì bản của dự án được ưu tiên hơn bản cá nhân.
Định dạng một file
.claude/agents/review-kien-truc.md:
markdown
---
name: review-kien-truc
description: Kiểm tra thay đổi có đúng docs/kien-truc.md không. Dùng sau khi sửa code trong src/modules/.
tools: Read, Grep, Glob
model: sonnet
---
Bạn là người review kiến trúc. Đọc docs/kien-truc.md, rồi đọc các file
vừa thay đổi. Chỉ liệt kê vi phạm, mỗi vi phạm: file, dòng, quy ước bị
vi phạm, cách sửa. Không sửa file.
Các trường hay dùng
| Trường | Bắt buộc | Ý nghĩa |
|---|---|---|
name | Có | Tên định danh, chữ thường và gạch nối |
description | Có | Khi nào nên giao việc cho nó — Claude đọc để quyết định |
tools | Không | Danh sách công cụ được dùng; bỏ trống = thừa hưởng tất cả |
disallowedTools | Không | Công cụ bị gỡ khỏi danh sách thừa hưởng |
model | Không | sonnet, opus, haiku, inherit… |
maxTurns | Không | Giới hạn số vòng |
Phần dưới frontmatter là lời dặn (system prompt) của subagent.
Gọi subagent
- Tự nhiên: "Dùng review-kien-truc kiểm tra thay đổi vừa rồi."
- Đích danh: gõ
@rồi chọn agent, hoặc@agent-review-kien-truc. - Cả phiên là subagent đó:
claude --agent review-kien-truc.
Để tạo mới, có thể nhờ chính Claude Code viết file, hoặc tự viết file vào thư mục trên.
Mẹo
Subagent chỉ đọc (tools: Read, Grep, Glob) là điểm khởi đầu an toàn. Chỉ thêm Edit, Bash khi thật cần.
Lưu ý
Đối chiếu tài liệu chính thức ngày 30/09/2026; tên trường và cách gọi có thể đổi.