用途:当用户需要 BPMN 图、泳道图、业务流程图或带角色/泳道与阶段的流程图时使用,在 draw.io 中产出正确的 BPMN 泳道图。该技能是薄前端,确定性引擎、校验器与规则位于 drawio-ai-kit 包,通过 drawio-ai CLI 调用。
必要用法:先做预检,CLI 须已安装,命令为:command -v drawio-ai >/dev/null 2>&1 || echo "Install the Kit first: npm i -g github:sparklabx/drawio-ai-kit"。若 drawio-ai 不在 PATH 上,应停止并让用户自行运行 npm i -g github:sparklabx/drawio-ai-kit,不要自行执行安装命令。
主要能力:若运行环境支持可执行 shell 且能读图的自主子代理,可在子代理中运行整个构建循环;否则走内联路径。内联流程依次运行 drawio-ai workflow、drawio-ai principles --mode bpmn 获取构建到校验、渲染的流程与 BPMN 领域规则,再用声明式布局引擎构建,不手写坐标。用 src/bpmn.mjs 的创建器与 pool() 原语,节点带 { lane, col } 标签自动布局。之后执行 drawio-ai validate <file> 与 drawio-ai render <file> -o <file>.png,并读取 PNG 做视觉自检。
限制与规则:网关必须有至少两个出边或至少两个入边;红色强调仅用于阻断型结束事件(错误/取消/终止),其余单色;顺序流为实线圆角;仅一个开始事件(无入流),结束事件在右侧(无出流);默认水平,向 pool() 传 orientation: "vertical" 可改为垂直泳道。图标须来自 drawio-ai search,不重新着色。输出应写到用户项目下的绝对路径,不写入 Kit 或当前工作目录。收费、价格等信息暂未提供。