用途:加载并执行工具规格(tool spec),可按名称、关键词或分类定位,随后按工具定义中的步骤顺序执行。
主要能力:直接模式依据工具名加载完整步骤并顺序执行;分类模式先列出某分类下的可用工具,由用户选择后再执行;支持关键词过滤,例如 --category review --keyword api。空参数进入交互模式,列出全部工具供选择。执行过程按步骤报告进度,遇到阻塞时询问用户。
使用方式: $maestro-tools-execute "integration-test" $maestro-tools-execute "--category coding" $maestro-tools-execute "--category review --keyword api" $maestro-tools-execute
加载时按名称会先搜索全部分类,找不到再用 knowhow 重试;按分类使用 maestro load --type spec --category <category>;空参数使用 maestro search "tool" --type knowhow。对于 ref 条目,需先用 maestro load --type knowhow --id <knowhow-id> 展开详情。
流程受四道强制阻断门控制:解析到加载、加载到确认、确认到执行、执行到报告。只有解析出有效工具、且用户通过 request_user_input 确认执行模式后才执行;选择仅查看则只展示步骤后结束。执行中步骤失败会提示重试/跳过/中止,缺少前置条件会列出缺失项并询问。
输出边界:文件写入由各工具自身的步骤定义决定,该命令本身除加载工具规定的写入外不写任何文件。
错误码:E001 无匹配工具;E002 多个匹配需用户选择;E003 步骤执行失败。适用场景为按角色或名称调用预定义工具流程并安全地逐步执行。限制:具体工具集与内容取决于 maestro-flow 仓库的规格定义,本资料未提供更多细节。