Lộ trình học›Claude Code›Claude Code chuyên sâu — Tham khảo đầy đủ Mở bản đồ

4.2 · 7 trường cấu hình subagent tùy chỉnh

Bài viếtNâng cao7 phút đọc

Một subagent tùy chỉnh là file markdown với frontmatter — 7 trường cấu hình quyết định nó hành xử ra sao và được kích hoạt khi nào.

Sau bài này, bạn sẽ
  1. Nắm 7 trường cấu hình subagent
  2. Viết description để subagent được gọi đúng lúc
  3. Giới hạn tools và effort phù hợp với vai trò

7 trường cấu hình

FieldTypeMô tả
namestringĐịnh danh subagent
descriptionstringSubagent làm gì — quyết định khi nào được gọi
modelstringGhi đè model, ví dụ haiku-4.5
toolsarrayDanh sách tools được phép dùng
effortstringMức độ effort lý luận: low / medium / high
initialPromptstringSystem prompt chèn khi agent bắt đầu
disallowedToolsarrayTools bị từ chối rõ ràng

Ví dụ subagent review bảo mật

---
name: security-reviewer
description: Reviews code changes for security issues.
  Use after significant changes to auth, API, or data handling.
tools: [Read, Glob, Grep]
disallowedTools: [Write, Edit]
effort: high
---
You are a strict security reviewer.
Check: injection, authz gaps, secrets in code, unsafe deps.
Output: findings ranked by severity, with file:line refs.

Nguyên tắc thiết kế

  • description nên chứa từ khóa đúng cách bạn hay nói, không phải câu quảng cáo
  • Subagent review KHÔNG cần quyền Write/Edit — giới hạn bằng disallowedTools
  • effort cao cho việc cần suy luận sâu (review bảo mật); effort thấp cho việc lặp đơn giản
Kiểm tra nhanh1 câu hỏi · chọn đáp án để xem giải thích
    Bạn đã hoàn thành bài này chưa?Tiến độ lưu trên trình duyệt của bạn.