SuperAPI AI 工具集

architecture-diagram

数据与分析

查看项目

更新于 10-16 01:18

技能介绍

用途:把口头描述的系统架构整理成一张清晰的 Mermaid 架构图,呈现客户端、服务、数据存储和第三方组件,并按逻辑层分组、标注连接类型,而不是一堆无差别的方框。

主要能力:按前端/后端/数据/第三方或按团队、领域分组;用实线箭头表示同步调用(HTTP/gRPC),用虚线箭头表示异步或事件(队列/事件总线);数据库等存储用 [(name)] 表示,队列/总线用 [[name]] 表示;输出包含系统名与边界说明、Mermaid 代码块、组件图例(说明非显而易见组件的用途)以及备注(信任边界、单点故障、同步与异步、待复查项)。

必要输入:组件(服务、应用、数据库、队列、外部 API);连接关系(谁调用谁、同步还是异步、数据流向);逻辑分组;关注范围(整个系统还是某个切片,如仅结账路径)。这些信息未提供时需先询问。

使用方式:以 flowchart LR 或 TD 编写,用 subgraph Name ... end 划分逻辑层;节点标签简短、ID 唯一,标签内不使用括号或引号,确保 Mermaid 无需修改即可渲染。

适用场景:需要快速说明系统如何组合、梳理依赖与数据流、识别风险点(数据存储、外部依赖、单点故障)时。

限制:不应用于绘制无分层的平铺框图;不应省略数据存储与外部依赖;不应混淆同步与异步;当需求只针对某个切片时不应塞入整个系统;标签中的特殊字符会破坏 Mermaid 渲染。具体安装命令、收费与平台信息暂未提供。