本地架构图引擎
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md ,安装 @user_7ae399a8/architect-diagram-pro
技能介绍
解决传统绘图的痛点
在软件工程中,绘制架构图往往面临两难:使用在线绘图工具存在数据隐私泄露风险,且难以将内部服务细节准确表达;而手写 SVG 或 Mermaid 代码则极易出现文字压线、节点重叠、坐标冲突等低级排版错误,后期调整成本极高。
四层架构与工作流
该技能采用纯本地、零外部依赖的四层设计模型(语义层、护栏层、模板层、生成层),确保数据不出本机的同时,输出符合工程规范的图表。
核心工作流分为六个严谨的步骤:
- 澄清意图:在输出形态(
自包含 HTML、内联 SVG或Mermaid)和图类型上通过不超过 3 个选项快速对齐。 - 语义规划与坐标预演:严格遵循“三不变式”,并在编写代码前强制执行 Mental Sandbox。它要求先以纯文本输出
画布 680×420的坐标规划,排除冲突后再落笔。 - 能力预检与轨道选择:根据图表类型选择最佳输出轨道。
- 生成与自检:HTML 轨道基于暖色极简模板(零 CDN 依赖);SVG 轨道通过
CSS 类复用以降低 token 消耗。输出前逐条核对防压字、箭头避让等硬性规则。
适用边界与限制
此技能专注于结构化图表(如分层架构、网络拓扑、数据流、ER 图等),节点建议控制在 20 个以内以保证可读性。
它明确不支持统计图(饼/柱/折线)、3D/地图、思维导图及 PNG/PDF 直出。遇到不支持的类型,系统会主动说明原因并提供替代方案,而非强行绘制。此外,所有文件读取严格限制在当前工作区,超出范围或未显式指定的输入将被拒绝。
使用场景
- 迭代评审前,需要为订单系统梳理整体分层,产出自包含HTML架构图,节点控制在20以内
- 梳理机房网络拓扑与服务依赖,要求内联SVG输出且箭头不压文字,用于运维文档归档
- 数据库重构阶段,需要快速画出核心实体关系ER图并明确数据流向,验证表结构设计
- 编写接口文档时,需要补充请求-响应时序图和状态机,确保调用方理解流转逻辑
适合人员
- 后端工程师:想把复杂的服务模块交互转换为规范的分层架构图或数据流图
- 前端工程师:需要在PR说明中附加自包含HTML视图,方便非技术人员直接查看
- 架构师:负责设计评审,需要快速产出符合严格排版规范的分层图和网络拓扑图
- SRE工程师:排障时需要根据调用链生成时序图,定位跨服务依赖故障