Agent Skills
返回列表
本地架构图引擎

本地架构图引擎

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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工程师:排障时需要根据调用链生成时序图,定位跨服务依赖故障