用途:用 Codex CLI 子任务完成多来源深度调研,并综合成带出处的报告。主控负责界定问题、拆分、核验与综合;子任务负责互不重叠的采集或局部分析。完成标准是用户需要的报告和证据覆盖,而非子进程退出或材料聚合成功。
主要能力:按需加载 references/runner.md 获取目录、manifest、命令与恢复约束;两个脚本仅依赖 Python 标准库,--help 为参数真源。运行产物写入独立的 .research/<name>/ 目录,用 aggregate.py 整理内部材料,再综合为 polished_report.md。
使用方式:先检查当前会话可用的 Skills、连接器和 MCP,再按来源适配能力,不假设固定服务或工具名存在。保持用户当前模型和推理配置,不传 --model,不覆盖无关配置。子进程默认使用 workspace-write,仅确需 shell 网络访问时才启用 runner 的 --network。不使用 --dangerously-bypass-approvals-and-sandbox。只在委派已获授权时启动子任务,执行前简述拆分与成本。
适用场景:确实需要分头取证的研究。从用户请求提取目标、时间范围、来源边界和交付格式,只追问会改变结论或范围的缺口。为每个子任务明确问题、输入、允许访问范围、输出和证据要求,结论旁附来源,无法确认处说明缺口。
限制:失败、空输出、缺失引用或未覆盖的问题仍视为未完成,按恢复约束有限重试,不重跑已验证成功的任务。缺少权限或需扩大范围时停止相应操作并说明阻塞。aggregated_raw.md 不是成品;必要证据缺失时报告已完成范围、具体阻塞及恢复条件,不把部分材料称为完整报告,也不发送内部 Prompt 或调度日志充当成品。