SuperAPI AI 工具集

wkc-workflow-diagram

办公与效率

查看项目

更新于 10-16 06:44

技能介绍

用途:把项目中的技能定义整理为可交互的离线工作流图,直观说明各技能及其关系;在技能定义或图谱内容变化后更新图。

主要能力:读取项目说明、工作流文档与技能定义,生成 workflow.json、layout.json、diagram.html、README.md 及截图,输出到 <project>/docs/dev-agents/diagram/。JSON 是既有内容的唯一来源,不从 diagram.html 恢复数据。仅在源定义确实建立关系时才添加边,命令与链接只取自源内容。更新时只新增源新确立的内容、移除已确认消失的内容或按用户指示改动,不在源变化时改写现有文本,冲突则报告。

使用方式:需要 Node.js 22 或更高版本,以及用于视觉检查的浏览器工具;无需安装、配置或联网。需指定目标项目、纳入的技能及已有图数据;未指定目标时使用当前仓库,范围不明时先询问。运行 README.md 辅助章节给出的 check 与 build 命令,脚本位于本 SKILL.md 相对的 scripts/diagram.mjs,并按需传入 --documentation-base。可后台启动 preview 检查页面,结束后以 SIGTERM 停止。所有写入限于 <project>/docs/dev-agents/diagram/,临时文件放其 .cache/。

适用场景:技能作者仓库与使用技能的项目的技能关系可视化与更新。

限制:不调用所绘制的技能或其命令,不推断依赖,不添加未发布技能;无相关定义时报告并保持现有图不变;不记录绝对路径、临时目录或预览端口。