用途:当语料规模超出单个智能体有效上下文时,用两阶段扇出(Two-Stage Fan-Out)流程完成分析。流程为:语料 → Workers → Critics → Summarizer → 报告。
主要能力:Workers 各分析一段语料并写出报告;Critics 各自复核覆盖某段子集的全部 Worker 报告,检查遗漏与矛盾;单个 Summarizer 读取全部 Critic 报告生成最终输出。每个阶段都写入文件,每个子智能体有独立任务。
使用方式:先确认分析目标与投入档位(Some effort:SEGMENTS_PER=3、REVIEWS_PER=2;A lot of effort:3/3;Herculean effort:2/3)。用 wc -c 估算语料字符数,或运行随技能附带的脚本:python3 /path/to/compute_layout.py --corpus-chars 800000 --segments-per 3 --reviews-per 2,也可用 --corpus-files 或 --corpus-tokens 加 --json。按公式计算分段与智能体数量(AGENT_CONTEXT=200000,RESERVED=35%,AVAILABLE=130000,OVERLAP=10%),用轮询方式生成 Critic 到分段的分配表。创建临时目录:WORK_DIR=$(mktemp -d -t fanout-XXXXXX),并建立 segments/、workers/、critics/ 子目录。进入计划模式写出编排计划(含布局、Mermaid 或 Graphviz 图、Worker 与 Critic 分配表、文件结构),经用户批准后,用 TaskCreate 一次性创建全部任务并用 TaskUpdate addBlockedBy 建立依赖,再并行启动 Workers、Critics,最后启动 Summarizer,返回报告路径。
限制:禁止嵌套子智能体,子智能体只能读取输入、写出输出并直接返回调用方。所有提示与文件引用必须使用绝对路径。计划中不要包含时间估计。失败恢复:上下文超限时把工作对半拆分(如 W03a/W03b、C01a/C01b);输出文件缺失重试一次,仍失败则在 Summarizer 提示中注明缺口;同一智能体重试 3 次仍失败应停止并报告。默认智能体类型为 sonnet-general-purpose。