用途：fan-out 用于在 Claude Code 中把工作委派给有界子智能体，并对回传证据做综合。主智能体始终是规划者和唯一决策者，子智能体只做限定范围的工作并交回证据。
何时使用：仅当满足以下至少一条时才生成子智能体——用户明确要求委派、并行化或生成子智能体；任务可拆成 2-5 个真正独立、无共享可变状态的子任务；独立工作会污染主上下文（大量读取、广泛搜索）。否则保持本地执行，顺序、微小或共享写入面的工作不应委派。
机制选择：单个有界子任务用一次 Task 调用；2-5 个独立子任务需一起取回结果时，在一条消息中批量 Task 调用（并发运行）；依赖型、多阶段或 DAG 形状的批次用动态 Workflow 工具；真正长时间运行且父级需保持响应时用后台 Bash 任务加 TaskGet/TaskStop。默认批量 Task 调用。
生成契约：每个子智能体提示需包含 TASK（一个具体成果）、SCOPE（查看路径/区域与越界范围）、MODE（只读或仅编辑指定文件）、CONTEXT（自包含，子智能体不继承父级对话）、RETURN（精确返回形状：状态、证据 file:line、运行的命令、发现与置信度、风险）。子智能体无对话历史，不得引用“上文”。
角色与模型：匹配时选用 .claude/agents/<role>.md，否则用 general-purpose。困难推理、审查、调试、规划用 Opus；读取密集的扫描与清点继承或使用 Sonnet。默认子智能体只读，除非其拥有互不重叠的具名写入面。
同步与异步：同步 Task 批次会阻塞至全部返回，须读完全部结果再进入下一步。后台任务须逐一用 TaskGet 核对，过时或被取代的用 TaskStop 停止。
限制与编辑安全：优先 2-5 个智能体；除非用户要求，不做嵌套子智能体。并行编辑者须拥有互不重叠的文件，并告知其不要回退或重新暂存其他工作者的改动，提交由父级串行化。
升级：若某子智能体不匹配，收紧其范围与返回契约，仅对该智能体用更强（Opus）角色重跑，不要整批升级。
综合与冲突台账：合并去重返回结果，优先呈现最高信号证据。子智能体分歧时记录并在父级解决，格式为 CONFLICT、各智能体证据、RESOLUTION。
验证：任何拟议编辑须附带实际运行的测试/检查，或父级（或最终验证子智能体）可执行的具体命令级验证计划。
失败模式与修复：子智能体范围过大或跑偏——收紧 SCOPE 与 RETURN 契约；输出弱或不可用——指定精确返回形状与证据格式；父级基于部分结果行动——等全部返回再决策；忘记后台任务——用 TaskGet 逐一核对；编辑冲突——分离写入面，父级串行提交；角色不匹配——仅对该智能体重跑 Opus；智能体过多——收缩到 2-5 个并扩大范围。
更多可复制的角色模板与 Workflow 骨架见 references/agent-templates.md。