SuperAPI AI 工具集

maestro-session-manage

通用与其它

查看项目

更新于 10-15 20:11

技能介绍

用途:管理 Maestro Flow 的 v3 Session,覆盖默认运行循环不执行的显式状态转换。会话完成(maestro session complete)本身属于默认 Run 循环,本工具侧重检查、知识评审与手动转换。

主要能力:无参数时执行检查,输出会话状态与 resume-view 投影;--complete 执行就绪检查、知识对账并补全会话、推进 DAG;--archive 仅对 completed/failed 会话做可选冻结;--unarchive 把 archived 会话恢复为 open;--knowledge 只做知识评审与晋升,不改生命周期。共享标志有 --session、-y/--yes、--skip-knowledge。

使用方式:先读取会话状态 maesto session status --session {session_id} --json 与 resume-view;知识对账用 maestro knowledge review {session_id} --json,解决候选用 --resolve <candidate-id> --as duplicate|related|conflict|supersede|unique,晋升用 maestro knowledge promote {session_id} --all 或 --candidate <candidate-id>。生命周期转换需带 --participant、--actor、--request-id、--reason、--expected-orchestration-revision、--json 并核对回执。

限制:--complete 要求无运行中 Run、链步骤均完成或跳过且有证据、无开放决策门;归档会话拒绝一切变更,须先 --unarchive;存在校验或评审 Run 时关键门须通过。错误码包括 E001 至 E006 与警告 W001 至 W004。具体安装方式、收费与平台支持暂未提供。