架构图与流程图绘制
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_60120345/diagram-builder-pro。
技能介绍
解决的问题
在架构评审、方案文档和排障说明中,纯文字描述组件关系往往不够直观。工程师需要快速画出系统架构、微服务、网络拓扑、业务流程、时序、状态机或 ER 图,但手写 SVG 容易在颜色、间距、箭头方向、裁切上反复调整。
能力与工作流
该技能提供两类输出:
- 内联可视化:通过
read_me加载样式规则,再用show_widget渲染固定viewBox 0 0 680的 SVG/HTML,适合在对话中直接查看。 - Mermaid 代码块:输出
flowchart、sequenceDiagram、stateDiagram-v2、erDiagram等语法,便于嵌入 Markdown 文档。
绘制时会遵循分层布局、marker 箭头方向、refX/refY 对齐、图例位置等规则,并优先保持中文标签可读。
适用边界
更适合作为方案草图和技术说明图:单图建议不超过 20 个节点,复杂系统可拆成多个聚焦视角。它不替代正式 UML 建模工具,也不保证业务语义完全准确,关键组件关系仍需人工确认。
使用场景
- 评审云原生方案时,画出 API Gateway、服务网格与数据库的分层架构草图。
- 写系统设计文档时,将用户请求到服务、数据层的调用关系整理成时序图。
- 梳理业务流程时,把审批、异常分支和角色泳道画成可嵌入文档的 Mermaid 图。
- 排查系统故障时,用内联 SVG 快速画出组件依赖和请求链路供团队讨论。
适合人员
- 后端工程师:评审微服务方案时,需要快速画出 API Gateway、服务网格与数据库的分层架构。
- 系统架构师:写技术文档时,需要把调用链、状态机和 ER 关系整理成可嵌入的图。
- SRE:故障复盘时,需要用组件依赖和请求链路图解释流量走向与影响范围。
- 技术产品经理:向研发同步流程时,需要把审批分支和角色泳道画成流程图。