用途:把工作流需求翻译成 SuperPlane 应用及其画布 YAML,通过 superplane CLI 完成校验、生成与应用。
主要能力:先用 superplane index actions / index triggers 查询可用动作与触发器及 schema;用 superplane integrations list 与 list-resources 核对已连接集成和资源值;用 expressions({{ }}、$['节点名'].data.、root().data.、previous().data.*)配置字段;用 If/Filter 分支、Merge 汇聚、Approval/Time Gate 等待;并按 515×215 节点尺寸以 +600px(x)、+300px(y)规则排布节点避免重叠。
使用方式:验证 command -v superplane 与 superplane whoami;未连接时先 superplane connect <URL> <TOKEN>。生成起点 YAML:superplane apps canvas init。创建应用:superplane apps create --canvas-file canvas.yaml。迭代更新:superplane apps staging update --file canvas.yaml 后 staging commit --message "...",或直接 superplane apps canvas update -f canvas.yaml --message "..."。完成后用 superplane apps canvas get <name> -o yaml 检查 errorMessage/warningMessage,并至少跑一次真实触发核对通道输出。
适用场景:需要将触发、动作、分支、等待与外部系统集成按图搭建为可提交版本的工作流应用。
限制:必须使用 CLI 获取真实名称、ID 与 schema,不能仅凭文档猜测;集成未连接时不要生成引用它的 YAML;资源值需经 list-resources 校验;未确认 payload 字段前不要写表达式。缺少可用 CLI 会话或连接信息时,应停止并请用户处理。