SuperAPI AI 工具集

maestro-player

通用与其它

查看项目

更新于 10-16 05:48

技能介绍

用途:按模板播放工作流,支持检查点恢复。会话状态写入 .workflow/.maestro/MCP-{YYYYMMDD-HHmmss}/state.json,波次 CSV 写入 .workflow/.csv-wave/;~/.maestro/templates/workflows/ 下模板在播放期间只读。

主要能力:支持 --context key=value(可重复)、-c [session-id] 恢复、--list 列出模板、--dry-run 仅展示波次计划。入口路由:--list 或无参数扫描 index.json 显示模板;-c 进入 S_RESUME;模板 slug/路径进入 S_LOAD。DAG 经拓扑排序后分为屏障(solo)与非屏障(并行)波次。屏障节点包括 checkpoint、maestro-plan、maestro-execute、maestro-analyze、maestro-brainstorm、maestro-roadmap,各自读取对应产物并更新上下文。

使用方式:确认后初始化会话,逐波执行;技能节点解析运行时引用后写 wave-{N}.csv,仅含 pending 行,再调用 spawn_agents_on_csv 派生子代理,读取 wave-{N}-results.csv 映射状态。子代理须原样执行技能调用并调用 report_agent_job_result,输出需匹配 RESULT_SCHEMA。

限制:检查点可暂停;波次内部分失败继续并标记 incomplete,全部失败可重试一次,仍失败则中止。错误码 E001/E002/E004/E005/E007 对应模板缺失、JSON 无效、DAG 环、恢复会话缺失、屏障产物缺失。terminal_pipeline 节点须作为 solo 终端屏障运行,不得并发执行外层计划/执行/测试/评审。