用途：该资料提供在 Claude Code 中创建、构建与使用 agents 及 Task 工具的指导，用于把复杂任务委派给专用 agent 自主执行，并将最终输出返回主对话。
主要能力：
- 创建 agent：运行 /agents 命令，选择 Create New Agent，可选项目级（.claude/agents/）或用户级（~/.claude/agents/）。
- 配置字段：name（小写加连字符，唯一）、description（说明何时调用，用于自动选择）、tools（逗号分隔，如 Read, Write, Edit, Bash, Grep，省略则继承全部工具）、model（sonnet、opus、haiku 或 inherit，省略则用默认 agent 模型）。
- 文件结构优先级：项目级最高、用户级较低、插件级最低；同名时项目级覆盖用户级。
执行模型与限制： Agent 是隔离的黑盒，无法与用户交互，不能用 AskUserQuestion 或任何需要用户输入的工具，用户看不到中间步骤，主对话只接收最终报告。因此需求收集、选项确认等应放在主对话，agent 用于研究、代码生成、分析报告等无需交互的重上下文任务。
系统提示词建议： 用纯 XML 标签组织，移除 markdown 标题，常用标签有 role、constraints、focus_areas、workflow、output_format、success_criteria、validation；名称需具体明确。
后台与并行执行： Task 工具支持 run_in_background: true 异步启动，返回 agent_id；用 TaskOutput 工具取回结果，参数 task_id（必填）、block（默认 true 等待完成）、timeout（默认 30000ms，最大 600000）。block: false 可非阻塞查看状态。可在单条消息中发起多个 Task 调用并行运行多个独立 agent，再分别取回结果。可用 resume 参数传入之前的 agent_id 继续执行并保留上下文。
适用场景：长时间分析（安全审查、全面代码分析）、多个可并行的独立任务、研究类任务。不适用于十秒内的快速操作、顺序依赖任务、需要立即结果或单文件简单操作。
限制与缺失：工具、模型、后台执行等行为以官方实际实现为准；该资料未提供收费、价格、平台支持或效果数据。