用途：为 Claude Code 创建自定义子代理。子代理是以带 YAML frontmatter 的 Markdown 文件定义的专用 AI 助手，各自拥有独立上下文窗口、自定义系统提示、特定工具访问权限与独立权限；当任务匹配其 description 时，父对话会自动委派，从而保留主上下文并施加约束。
主要能力：支持代理作用域（项目、用户、CLI、插件）、工具允许与拒绝列表、模型选择、权限模式、技能预加载与生命周期钩子。
必要用法：项目级文件放在 .claude/agents/name.md，用户级放在 ~/.claude/agents/name.md；必填字段为 name 与 description。工具限制示例 tools: Read, Grep, Glob；工具拒绝示例 disallowedTools: Write, Edit；模型示例 model: haiku（可选 sonnet、opus、haiku、inherit，默认 inherit）；权限模式示例 permissionMode: dontAsk；技能预加载示例 skills: [auth, api-patterns]；钩子示例 hooks: { PreToolUse: [...] }。CLI 定义代理使用 claude --agents '{...}'，仅限当前会话且优先级最高；交互式创建使用 /agents 命令。
适用场景：隔离高流量操作（测试、日志）、为审查者强制只读访问、将简单任务路由到更便宜的模型、并行研究、创建可复用团队工作流。
限制：子代理不能生成子代理，不支持嵌套委派；不适合需要频繁来回交互、快速针对性修改或对延迟敏感的操作。父对话的技能不会自动继承，需在 skills 字段显式列出；省略 tools 字段则继承全部工具（含 MCP）。避免用 opus 做简单清单审查，慎用 bypassPermissions。