架构图生成器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_7f8c14e8/architecture-diagram。
技能介绍
系统架构可视化的痛点
在软件开发和系统设计中,将复杂的模块关系、数据流向和用户角色可视化至关重要,但传统绘图工具如 Visio 或 Draw.io 需要手动拖拽,耗时且难以维护一致性。对于频繁迭代的架构,快速生成可交互的图表成为技术团队的核心需求。
架构图生成器的核心能力
该技能通过自然语言描述自动生成基于 HTML 的架构图,无需外部依赖,直接在浏览器中渲染。其核心工作流程如下:
- 描述解析:用户输入系统描述(如模块层级、交互关系),技能解析出关键元素。
- 结构规划:基于预定义的模板(如
assets/template.html),自动规划分层布局,包括用户角色行、分组区块和卡片组件。 - 组件映射:使用提供的 CSS 类名生成 HTML 代码,例如:
- 卡片使用 .card 类,并通过 card-{theme} 控制主题色(如 web、api)。
- 连接线使用 .flow-arrow 和 .h-connector 类表示数据流。
- 响应式设计通过媒体查询实现,768px 以下自动切换纵向布局。
- 文件输出:生成自包含的
.html文件,仅引用 Google Fonts CDN(如 Inter 字体),便于分享和归档。
关键实现细节
技能严格遵循 Paper.design 风格:
- 视觉一致性:背景为
#edebe1暖奶油色,卡片使用#f5f3eb浅色表面,搭配细边框和 3px 彩色指示条。 - 交互与动画:hover 效果添加上浮和阴影,组件通过
fadeUp错帧渐入动画(如.section-N控制延迟)。 - 扩展性:当架构复杂时,可通过 CSS 变量(如
--accent-{name})新增颜色或组件,但需手动修改模板。
适用边界与注意点
- 描述依赖性:生成质量高度依赖用户输入的清晰度;模糊描述可能导致图表结构不合理。
- 自定义限制:虽然支持主题扩展,但预定义类名(如
.card-web)固定,深度定制需编辑 CSS。 - 浏览器兼容性:文件依赖现代浏览器渲染,旧版 IE 可能不支持动画或 Flexbox 布局。
- 无外部工具:不集成版本控制或协作功能,适合作为独立文档或演示用途。
使用场景
- 系统设计师在完成微服务拆分方案后,需要将模块交互关系(如 API 网关、数据库集群)快速转化为可分享的交互式图表,以便团队评审。
- 技术写作者在撰写项目白皮书时,需要将用户角色、前端应用、后端服务的数据流整合为一个自包含的 HTML 文件,直接嵌入在线文档中。
- 开发团队在迭代会上,需将临时讨论的架构变更(如新增缓存层)用标准化模板生成示意图,确保所有人对结构变化有统一理解。
- 初创公司技术负责人向投资人汇报时,需要使用暖色极简风格的架构图展示系统扩展性,强调核心模块与外部依赖的关系。
适合人员
- 需要将设计方案可视化的系统架构师,其诉求是快速生成符合团队设计语言的可交互图表以减少沟通成本。
- 负责维护技术文档库的软件工程师,其诉求是创建可更新、响应式的架构图嵌入文档,避免使用外部工具导致的版本脱节。
- 在跨部门会议中汇报技术方案的技术经理,其诉求是生成视觉一致的专业图表来清晰传达系统边界和依赖关系。
- 教育机构中教授软件工程的教师,其诉求是生成示例架构图用于教学材料,展示如何将需求转化为模块化设计。