前言¶

画架构图常见的三条路都有代价：打开 Draw.io 拖框，图存在工具里，改完要重新导出；手写 Mermaid，布局靠渲染引擎，遇到复杂结构常常要反复调语句；写文档时图和正文分开维护，时间一长两边对不上。

下面介绍的 Skill 想把这些合并成一步：用自然语言描述要画什么，Skill 自己决定图的类型和输出形态，产出可以直接放进文档或页面的结果。

这是什么¶

「架构图专业绘制」是一个基于通用 SKILL.md 格式的 Agent Skill，坐标 @user_d28c9161/smart-arch-diagram，由社区发布者 user_d28c9161 发布并维护，当前版本 1.0.0，分类 dev-programming，来源标记为 community。

它解决的问题是：从一段需求描述到一张可用的图，中间的选型和排版工作交给 Skill，人只需要把意图说清楚。

核心功能¶

官方简介列出的能力有三项，全部围绕”从意图到成品图”这条链路：

1、智能意图挖掘：从自然语言描述里判断要画哪种图、需要哪些节点和连线，不需要用户手写图描述语法。
2、多模式渲染：同一个意图可以走不同的渲染路径，产出风格和复杂度不同的结果。
3、精美模板：提供现成的模板作为起点，避免每次从空画布开始排版。

覆盖的图类型：

• 系统架构图
• 微服务架构
• 业务流程图
• 时序图
• 状态机
• ER 图

三种输出模式¶

这是它和单纯 Mermaid 生成器的主要区别。同一个 Skill 可以按场景选择输出形态：

1、HTML 模板：产出精美架构图，适合放在内部文档站点、Wiki 页面或演示材料里，样式由模板控制。
2、内联 SVG：产出灵活结构图，适合需要二次编辑、嵌入现有页面或与代码一起版本管理的场景。
3、Mermaid 代码块：产出 Mermaid 源码，适合直接写进 Markdown 文档、README 或 issue，由前端渲染。

选型建议：要好看、要对外展示，走 HTML；要能改、要嵌入页面，走 SVG；要进代码仓库随文档一起维护，走 Mermaid。

安装与启用¶

已抓取资料里没有给出官方安装命令，也没有 Cursor / Codex CLI / Claude Code 各自的差异说明。这里不补造命令，请以官方页面为准。

官方地址: https://api.skillhub.cn/user_d28c9161/smart-arch-diagram
SkillHub 页面: https://www.skillhub.cn/skills/user_d28c9161/smart-arch-diagram
坐标: @user_d28c9161/smart-arch-diagram
版本: 1.0.0
分类: dev-programming
来源: community
标签: requires_api_key=false

有一点可以确认：requires_api_key=false，与简介里”零依赖离线可用”一致，说明它不依赖外部模型 API，也不需要配置密钥。

典型用法¶

官方简介没有提供可复现的示例（没有给出输入样例和对应输出），这一节不补造案例。

按简介描述的能力，用法是：在对话里直接用中文或英文说明要画什么图、包含哪些组件、组件之间怎么调用，然后指定输出模式。例如说明”画一个微服务架构，包含网关、两个服务和一个数据库，用 Mermaid 输出”——这是对能力范围的描述，不是官方示例，实际措辞以你使用的 Agent 客户端为准。

适用场景与注意¶

适合的场景：

• 需要在同一份文档里混用多种图（架构图加时序图加状态机），不希望维护多个工具。
• 运行环境离线或不允许配置外部 API key。
• 图要随代码一起进仓库，倾向 Mermaid 或 SVG 这类文本可版本管理的形态。
• 团队文档需要统一模板，不希望每个人画出来风格各异。

需要注意的地方：

• 来源是 community，不是官方维护，质量取决于发布者更新。
• 当前版本 1.0.0，属于初始版本。
• 抓取时点 SkillHub 页面显示评分 100000、下载 984 次、安装 0 次。评分与下载量是平台展示数据，安装数为 0 说明它还没有经过大量实际部署验证，选型时要留出验证成本。
• 模板的精美程度和 Mermaid 渲染兼容性需要实际跑一次才知道，建议先拿一个真实图试输出，再决定是否接入文档流程。

结尾¶

这个 Skill 的价值在于把”选型、排版、导出”三件事压成一次对话：你说清楚意图，它决定图类型和输出形态。零依赖、不需要 API key，意味着它可以在离线环境和 CI 文档构建里直接用，不需要额外申请密钥。

缺点也明确：社区来源、1.0.0 版本、安装数为 0。适合作为内部文档产线的候选组件先试用，不适合作为关键交付物的唯一依赖。

官方地址: https://api.skillhub.cn/user_d28c9161/smart-arch-diagram
SkillHub 页面: https://www.skillhub.cn/skills/user_d28c9161/smart-arch-diagram