用途:指导创建、构建和使用 Claude Code 子代理以及 Task 工具。子代理可自主执行复杂任务,不与用户交互,最终输出返回主对话。
主要能力:支持项目级与用户级子代理配置,项目级优先;可读取项目与用户的 agents 目录配置;支持指定工具与模型(sonnet、opus、haiku 或 inherit);支持后台运行、并行启动、结果获取与恢复代理。
使用方式:运行 /agents 命令,选择 Create New Agent,选择项目级(.claude/agents/)或用户级(~/.claude/agents/),定义 name(小写加连字符)、description(说明何时使用)、tools(逗号分隔,省略则继承全部)、model(可选),再编写系统提示。也可直接编辑 .claude/agents/subagent-name.md 或 ~/.claude/agents/subagent-name.md 文件。后台运行通过 Task 工具的 run_in_background 参数启动,并用 TaskOutput 获取结果,支持 block 与 timeout 参数。
适用场景:研究、代码生成、分析与报告、安全审查、测试覆盖等无需用户交互的上下文密集操作;需要用户确认的环节应留在主对话中处理。
限制:子代理是黑盒,不能与用户交互,不能使用 AskUserQuestion 或任何需要用户输入的工具,用户看不到其中间步骤。系统提示建议使用纯 XML 结构并移除 Markdown 标题。名称需唯一,工具应遵循最小权限原则。
补充资料:官方文本暂未提供。以上依据来源描述与介绍整理。