SuperAPI AI 工具集

maestro-composer

智能体与模型

查看项目

更新于 10-15 20:10

技能介绍

用途:maestro-composer 是工作流模板的"设计器",把自然语言描述转化为可复用的工作流模板,而非直接执行流程。

核心流程:解析自然语言(Phase 1)→ 将步骤映射为执行器节点(Phase 2)→ 注入检查点并构建 DAG(Phase 3)→ 可视化并用户确认(Phase 4)→ 组装并持久化模板(Phase 5)。每个关键阶段都通过 request_user_input 交互确认。

三种入口模式:

  • 新设计:无标志且提供描述文本时从 Phase 1 开始。
  • 恢复设计:--resume 从 .workflow/templates/design-drafts/ 加载草稿。
  • 编辑模板:--edit <template-path> 加载并修改已有模板。

主要能力:按信号词识别候选节点类型(如 analyze/review → analysis;plan/design → planning;implement/build → execution;test/validate → testing)。自动为并行组分配 parallel_group,并在工件边界、执行门、Agent 生成、长时间运行等条件下自动注入检查点。最终输出到 ~/.maestro/templates/workflows/<slug>.json 并更新 index.json。

关键约束:工作流最多 20 个节点;模板 ID 格式为 wft-<slug>-<YYYYMMDD>,节点 ID 为 N-<seq>、检查点为 CP-<seq>;所有文件写入必须限于 ~/.maestro/templates/workflows/ 与 .workflow/templates/design-drafts/,禁止修改源代码、.claude/commands/ 或 .codex/skills/。DAG 需校验无环、无孤立节点。

可选的预加载规范:运行 maestro load --type spec --category arch 与 maestro load --type spec --category coding,缺失时可继续。使用命令包括 $maestro-player <slug> --context goal="..."、$maestro-composer --edit <path>、$maestro-player --list。错误码 E001–E006、警告 W001–W003 覆盖空描述、零步骤、超过 20 节点、DAG 环、找不到恢复会话或编辑模板、映射歧义等情况。