技术图表制作Skill：用 Mermaid 语法把架构、流程与数据模型一次画清楚
- 一句话定位：这是一个把"画技术图"变成"写结构化文本"的技能，基于 Mermaid 语法产出架构图、序列图、ERD、流程图、状态机图和类图。
- 覆盖六类主流技术图：C4 架构图（上下文/容器/组件）、序列图、实体关系图、流程图、状态图、类图，基本覆盖系统设计与文档的常见需求。
- 结构化方法而非随手涂鸦：技能内置"先选图表类型、再套语法模式、最后按最佳实践收敛复杂度"的流程，输出更规范、更易维护。
- 图表即文本，可进 Git：生成结果是 Mermaid 代码，能随代码一起版本管理，改图不用重画。
- 适合谁用：后端/架构工程师、技术文档作者、Tech Lead、需要向非技术方解释系统的产品与运营同学。
该技能叫什么？如何一键安装 AI 技能提升开发效率？
技能中文名：技术图表制作Skill 技能英文名：diagramming 技能ID：13510
它要解决的问题很具体：技术人画图往往卡在三件事上——工具太重（打开绘图软件拖拽半天）、风格不统一（每个人画的图各有一套图例）、图会过期（代码改了，图还是半年前的）。这个技能把绘图过程改造成"描述需求 → 生成 Mermaid 代码 → 渲染成图"的链路，让图表和文字文档一样可编辑、可复用、可版本化。
一键安装的思路与步骤（具体命令、安装包地址与入口以官方说明为准）：
- 确认安装前提：你需要在支持 AI 技能（Skill）机制的客户端或平台中使用它；确保当前账号具备技能安装权限，并且有可用的模型额度。
- 找到技能入口：在技能市场/技能管理页中按技能名称「技术图表制作Skill」或技能ID「13510」检索，也可以在支持技能安装的客户端中通过技能 ID 直接定位。
- 执行安装/启用：按官方说明完成安装或启用操作（不同平台可能表现为"安装"“添加”"启用"等按钮）。安装与启用方式以官方说明为准。
- 验证是否生效：新建一次对话，输入该技能的触发词之一（如
mermaid、flowchart、sequence diagram、架构图、ERD），或直接用自然语言说"帮我画一个登录流程的序列图"。如果返回的是带flowchart、sequenceDiagram、erDiagram等关键字的 Mermaid 代码块，并配有图表类型选择与结构说明，说明技能已生效。 - 渲染查看效果：将返回的 Mermaid 代码粘贴到支持 Mermaid 渲染的工具中查看成图；若渲染报错，把报错信息回传给技能，让它修正语法即可。
该技能的主要功能和特点
- 图表类型智能匹配：技能内置一张"图表类型—使用场景"对照表：架构图/C4 用于展示系统结构与组件，序列图用于展示随时间变化的交互，ERD 用于数据模型与关系，流程图用于决策逻辑与过程，状态图用于状态转换。你只要描述"我要表达什么"，它就能选对图种。
- C4 分层架构建模：支持上下文图（层级1，系统与外部依赖）、容器图（层级2，应用/数据库/服务等技术构建块）、组件图（层级3，容器内部结构），适合做架构文档、新人入职讲解和干系人沟通。
- 序列图表达力完整：覆盖
participant参与者声明、autonumber自动编号、alt/else/end条件分支、loop循环、par并行、Note over注释，能画出基本的请求响应流、错误处理流、异步处理流、API 认证流和微服务协作流。 - ERD 关系语义清晰：支持
||（恰好一个）、o|（零个或一个）、}|（一个或多个）、}o（零个或多个）四种基数表示法，还能在关系上直接写"下单 (1:N)"这类中文标签，字段支持 PK/UK/FK 标注。 - 状态机与类图支持：状态图可表达订单生命周期、连接状态重连（含指数退避、最多重试次数注释）等；类图支持泛型、接口
<<interface>>、可见性修饰与继承/依赖关系。 - 语法模式规范化：方向控制（
TB从上到下、LR从左到右）、节点形状（矩形=过程、圆角=开始结束、菱形=决策、圆柱=数据库、圆形=连接点）、箭头类型（实线、虚线、粗线、特粗线）、subgraph分组，都有明确约定，减少"画出来不像技术图"的问题。 - 最佳实践内建：一个图表一个概念、命名一致、流程方向统一、关系必须打标签、拆解过大的图、加标题与简要描述——这些不是口号，而是技能在生成时会主动执行的约束。
- 与"直接让 AI 随手画图"的差异：普通工具给你一张图，这个技能给你一套可维护的图表资产：命名统一、结构分层、复杂度可控、能贴进仓库随代码演进。
如何使用该技能？
- 明确你要表达的对象。先在脑子里回答三个问题：这张图给谁看（开发/老板/客户）、要表达结构还是时序、颗粒度是系统级还是模块级。
- 用自然语言或触发词发起调用。可以直接说需求，也可以带上触发词，例如：
用 mermaid 画一个电商下单的 sequence diagram，包含库存检查和支付授权两个并行分支。 - 按图表类型给出关键要素。以序列图为例，把参与者（客户端、API 网关、认证服务、数据库）和主流程写清楚：
- 输入示例：
画一个 API 认证序列图：客户端 POST /login 提交凭证，网关调用认证服务，认证服务查用户库，有效则生成 JWT 并写 Redis 缓存，返回令牌；无效返回 401 - 输出说明：技能会返回带
autonumber与alt/else分支的sequenceDiagram代码，并提示"参与者已提前声明、分支已标注成功/失败路径"。
- 输入示例：
- 用 Mermaid 语法微调。生成后你可以继续追加指令，比如"把方向改成
flowchart LR"“把数据库节点从矩形改成[(数据库)]”“这个图太大了，按 CI 管道和 CD 管道拆成两个 subgraph”。 - 渲染与回归验证。把代码贴到支持 Mermaid 的渲染器中查看效果；若有语法错误，直接回传错误信息让它修复。
- 沉淀进文档。把最终代码写入 README、设计文档或架构决策记录（ADR），后续需求变更时只改文本，图自动跟随更新。注意：Mermaid 的 C4 图渲染依赖渲染端支持，部分渲染器对 C4 语法支持有限，遇到不兼容可退回
flowchart表达同一结构，具体以所用渲染器说明为准。
同类型竞品对比分析
| 方案名称 | 定位 | 核心功能 | 安装/使用门槛 | 适用场景 | 优势与不足 |
|---|---|---|---|---|---|
| 技术图表制作Skill（diagramming） | AI 技能：用自然语言驱动 Mermaid 生成技术图 | C4 架构图、序列图、ERD、流程图、状态图、类图，含图表类型选择与最佳实践约束 | 需在支持技能机制的平台安装启用；生成结果需渲染端查看 | 架构文档、API 流程、数据建模、状态机设计 | 优势：图表即文本、可版本化、结构化规范、六类图一站式；不足：依赖模型与渲染器，复杂视觉美化不如专业绘图工具 |
| PlantUML | 老牌文本化 UML 绘图工具 | UML 全家族图、部署图、时序图，生态成熟 | 需要本地 Java 环境或服务端渲染，语法学习成本中等 | 传统 UML 建模、企业级文档 | 优势：成熟稳定、UML 覆盖最全；不足：需要额外渲染服务，样式偏传统，需自行写代码无 AI 辅助 |
| draw.io / Excalidraw | 可视化拖拽绘图工具 | 自由绘制、模板库、手绘风格、导出多格式 | 门槛最低，打开即用 | 白板讨论、演示幻灯片、非正式示意图 | 优势：所见即所得、美观自由度高；不足：图为二进制/图形文件，难做版本 diff，改动靠重画，团队风格难统一 |
| 直接在代码库手写 Mermaid / 通用 AI 对话生成图 | 无技能封装的替代路径 | 手写或让通用助手临时生成 | 零安装成本 | 偶发的一次性画图需求 | 优势：无需安装；不足：缺少图表类型选择与规范约束，命名不一致、图越画越乱，复杂分支和基数关系容易写错 |
选择建议：图要长期维护、要进仓库、要给团队看，用这个技能；只是一次性白板草图，拖拽工具更快；需要严格 UML 规范输出，PlantUML 仍是稳妥选择。
该技能的典型应用场景与实际体验情况
场景一：后端工程师写接口文档
痛点：接口文档里只有文字描述，新人要反复问"这个请求到底经过哪些服务"。使用方式：把接口调用链路口述给技能，要求生成带 autonumber 的序列图，并把失败分支写成 alt/else。实际体验：上手难度低，只要能把流程讲清楚就能出图；效果是成功路径与错误路径（400/401/409/402）一目了然；注意点是一次不要把五六条链路塞进一张图，技能本身也会提示"一个图表一个概念"。
场景二：架构师做系统说明与新同事入职材料 痛点：架构图每次都由不同人画，图例、命名、箭头含义各不相同。使用方式：用 C4 三层模型分别生成上下文图、容器图和组件图，命名沿用统一的"XX服务"“XX数据库”。实际体验：分层的好处非常明显，给老板看上下文图、给开发看容器图，同一套素材复用；注意事项是 C4 语法在不同渲染器的支持度存在差异，跨平台分享前先验证渲染效果，以官方说明为准。
场景三：数据开发做数据库设计评审
痛点：ERD 靠截图，字段和基数的变更没人同步。使用方式：描述业务实体与关系，让技能生成带 PK/FK 标注和 ||--o{ 基数符号的 erDiagram，关系上写中文标签如"下单 (1:N)“。实际体验：评审时能直接对着文本讨论"这里应该是零个还是一个”，争议点收敛很快；注意点是实体字段不要贪多，核心字段优先，扩展字段在文档正文补充。
场景四：产品/运营同学画流程与状态
痛点：不熟悉绘图工具，画出来的流程图方向乱、判断分支不规范。使用方式：用自然语言描述"用户登录失败三次锁定账户"“订单从草稿到已退款"这类规则，让技能生成 flowchart TD 或 stateDiagram-v2。实际体验：即使不懂语法也能拿到结构清晰的图，决策节点用菱形、起止用圆角矩形的约定让图看起来就"专业”；注意点是业务规则里的时间条件（如超时 24h）要主动说明，否则容易被简化掉。
该技能能为用户带来的价值
- 效率提升：把"打开工具—拖拽布局—调对齐—导出截图"的十几分钟流程，压缩成"一句话描述 + 一次渲染"。日常需求图的产出从"排期半天"变成"对话几分钟"。
- 降低门槛：不会 Mermaid 语法、不熟悉 UML 规范的产品、运营、测试同学，也能产出符合技术文档习惯的图；反向也帮工程师省去查语法的时间。
- 质量与一致性收益：命名约定、方向控制、关系标签、复杂度拆分被固化为默认行为，团队图表从"十个人十种画法"收敛为一套风格。
- 可维护性带来的长期价值：图表以文本形式沉淀在仓库里，随代码走 Code Review，改了逻辑就改图，避免"图与系统脱节"这类最常见的技术债。
- 沟通成本的降低：分层的 C4 图让不同受众各取所需，减少"这张图到底画的是什么"的解释成本。
常见问题 FAQ
Q1：这个技能怎么安装？安装完怎么确认生效？
A：在支持技能机制的客户端或平台中按技能名称「技术图表制作Skill」或技能ID「13510」检索，按官方说明完成安装或启用。验证方式：新建对话输入 mermaid、flowchart、ERD 等触发词，或直接说"帮我画一个登录序列图"，若返回带 sequenceDiagram/flowchart 关键字的 Mermaid 代码并附图表类型建议，即表示已生效。具体安装入口与命令以官方说明为准。
Q2：这个技能收费吗？画出来的图能直接商用吗？ A：技能本身的收费方式取决于所在平台的计费规则，以官方说明为准。图表内容由你的输入生成，Mermaid 代码可用于你的项目文档中；如需对外发布或商用，建议同时确认平台条款与渲染工具的使用许可。
Q3：它和直接让 AI 聊天机器人画图有什么区别？ A:区别在"结构化"。普通对话往往直接吐一张图，命名和语法各次不同；这个技能会先判断图表类型（架构/时序/数据/流程/状态），再套统一的方向、节点形状、箭头语义规范，并主动提示拆解过大图表，产出的是可维护的图表资产。
Q4：它支持哪些图表？会不会画出渲染不了的语法？
A：支持 C4 架构图（上下文/容器/组件）、序列图、ERD、流程图、状态图、类图。Mermaid 的 C4 扩展语法在其他部分渲染器中支持度有限，遇到渲染失败可以把报错回传让它修正，或改用 flowchart 表达同一结构，具体兼容性以所用渲染器的官方说明为准。
Q5：适合谁用？和 draw.io、PlantUML 怎么选？ A：适合需要长期维护技术文档的工程师、架构师、技术写作者，以及需要频繁输出流程图的产品与运营。要"快出草稿、随机美化"选 draw.io/Excalidraw；要"严格 UML 规范、纯文本建模"选 PlantUML；要"自然语言驱动 + 规范约束 + 可版本化"，选本技能。