用途:maestro-link-coordinate 是一个分步模式(step-mode)的链图协调器,通过 maestro coordinate CLI 端点,逐个节点驱动链图执行,用于把意图(intent)按预设链图逐步推进到完成。
主要能力:以 start/next/status 等子命令逐节点遍历。每次 coordinate next 前进一个图节点;decision 节点由 walker 按 expr 快速路径或 LLM 决策兜底解析;gate 节点在条件满足时自动旁路;checkpoint 节点暂停等待用户确认。会话由服务端持久化,-c 可恢复上次暂停节点。使用 --list 列出可用链图,--chain 强制指定链,-y/--yes 跳过节点间确认,--tool 覆盖命令节点的 CLI 工具(默认 claude)。
必要用法:
- 列出链图:$maestro-link-coordinate "--list"
- 启动:$maestro-link-coordinate "implement OAuth2 authentication"
- 指定链:$maestro-link-coordinate --chain quality-full-cycle "fix all test failures"
- 续跑:$maestro-link-coordinate -c "MLC-20260401-143022"
- 自动模式:$maestro-link-coordinate -y "refactor auth module"
使用的 CLI 端点:maestro coordinate list / start "intent" --chain X / next [sessionId] / status [sessionId] / run "intent" / watch <sessionId> [--follow] / report。
适用场景:需要按图分步执行的开发与流程协调任务,如实现认证、修复测试失败、重构模块等。
限制与规则:--list 时绝不启动会话;一次只推进一个节点,禁止批量推进;decision 节点由 walker 解析,不要手动干预;checkpoint 为硬暂停,未经用户明确确认不得自动推进;恢复状态在服务端,-c 仅提供 sessionId;-y 时改用 coordinate run 而非 start+next 循环;循环结束后调用 coordinate status 获取权威最终状态。错误码 E001-E005 分别覆盖缺少意图、链图未找到、节点执行失败、恢复会话未找到、CLI 端点不可用。具体安装与配置信息资料未提供。