SuperAPI AI 工具集

compose-diagram

通用与其它

查看项目

更新于 10-16 08:45

技能介绍

compose-diagram 用于按用户需求新建、修改或可视化 LeanIX 图表。图表(diagram)与画布(canvas)指同一事物。

主要能力:以「草稿—提交」事务方式编辑图表;搜索 LeanIX 事实表并放置为单元格;添加事实表之间的真实关系边(依赖)或做钻取嵌套;添加纯视觉元素(标题、图例、注释、自定义形状与连线)。

使用方式:所有调用走 MCP 工具,无需 shell、curl 或令牌交换,认证由 MCP 服务器内部处理。生命周期为 create_diagram_draft 打开草稿(返回 draft_id),逐次变更,最后 commit_diagram_draft 持久化并返回 diagram_id,再通过 get_diagram_by_id 取稳定 URL 反馈给用户。工具须严格串行调用,不能并行。

关键规则:只放置 LeanIX 实体时用 add_diagram_fact_sheet_cell,关系用 add_diagram_dependencies 或 add_diagram_drill_down;纯视觉元素才用 add_diagram_cell / add_diagram_edge。不得手写或复制 XML;单元格内的 HTML 须原样传入,不可转义。先搜索再添加,不向用户索要 fact_sheet_id。若只有认证工具,应提示用户运行 /mcp 认证。

限制:未提交前不持久化;只读图表应用 get_diagram_by_id 而非开草稿。其余细节(如 xml-convention.md、relation 名称等)以技能内文档为准。