用途:当问题需要多个 CLI 工具交叉验证或多元分析视角时,使用 maestro-collab。协调器通过 maestro delegate shell 调用让各 CLI 工具独立分析同一需求,全部完成后做交叉验证,识别共识与冲突,综合为统一报告。
主要能力:
- 多工具并行委派分析(协作式 fan-out)。
- 交叉验证:将每条发现标记为 CONSENSUS(2+ 工具一致)、CONFLICT(工具间矛盾)、UNIQUE(仅 1 个工具提出),并计算 consensus_level。
- 冲突边界质询(boundary grill),并把结果写入报告。
- 生成产物:collab-report.md、context.md(Locked/Free/Deferred)、conclusions.json、per-tool/{tool}-output.md 原始输出。
- 与下游兼容:maestro-plan(通过 --dir)、maestro-analyze(作为先前上下文)、maestro-ralph(artifact chain 查找 type=collab)。
使用方式:
- 标志:--tools <list> 逗号分隔的 CLI 工具(默认前 3 个已启用);--mode analysis|write(默认 analysis);--rule <template> 所有委派共享的规则模板;-y 跳过确认。
- 未指定 --tools 时,读取 ~/.maestro/cli-tools.json,过滤启用且符合条件的工具,取前 3 个;--mode write 时排除 api-endpoint;至少需要 2 个工具。
- 委派调用示例:maestro delegate "<shared_prompt>" --to <tool> --mode <mode> [--rule <rule>]。
- 会话目录:.workflow/.maestro/{YYYYMMDD}-collab-{slug}/;暂存目录:.workflow/scratch/{YYYYMMDD}-collab-{slug}/。
常用 --rule 模板:analysis-review-code-quality(代码质量多维评审)、analysis-review-architecture(架构设计评审)、analysis-diagnose-bug-root-cause(Bug 根因诊断)、analysis-assess-security-risks(安全风险评估)、analysis-analyze-performance(性能瓶颈分析)、analysis-analyze-code-patterns(代码模式/反模式识别)、planning-plan-architecture-design、planning-breakdown-task-steps、planning-plan-migration-strategy、universal-universal-rigorous-style。
限制与规则:不使用 spawn_agents_on_csv 或 spawn_agent,所有 CLI 调用由协调器通过 shell_exec 直接发起;不得用内部生成的分析替代 CLI 输出;不得总结或改写,须原样保存 CLI 原始输出;每个 shell_exec 必须等待完成,不设最大超时,不提前退出。错误码:E002 符合条件的工具少于 2 个;E004 全部委派失败或完成少于 2 个;W001 一个工具失败可继续;W004 consensus_level 低于 40% 标记低置信。至少 2 个工具成功时可部分降级继续。