mermaid

Mermaid Diagrams Skill 是一款基于文本的图表生成工具，通过调用官方 Mermaid CLI（mmdc）将类 Markdown 语法的 .mmd 文件渲染为高质量的 PNG、SVG 或 PDF 图像。

核心用法：用户通过简单的文本语法定义图表结构，支持流程图（Flowchart）、时序图（Sequence）、类图（Class）、状态图（State）、甘特图（Gantt）、思维导图（Mindmap）等十余种标准图表类型。工作流程遵循"编写-渲染-展示"三步模式：首先根据需求选择合适的图表类型并编写 .mmd 文件，随后调用 mmdc 命令行工具进行渲染（支持自定义主题、背景透明度、分辨率缩放等参数），最后通过文件读取工具展示生成的图像。该技能特别适合需要频繁生成技术架构图、业务流程图或数据可视化图表的场景。

显著优点：作为"代码即图表"（Diagram as Code）理念的代表工具，其最大优势在于文本化带来的版本控制友好性——图表源码可与项目代码一同托管在 Git 中，支持差异对比和协作编辑，解决了传统图形文件难以合并冲突的痛点。输出质量方面，支持 -s 2/3 参数生成高分辨率图像以适应 Retina 屏幕，提供 dark、forest 等多种内置主题及完整的 CSS 变量自定义能力。此外，通过 JSON 配置文件可深度定制颜色体系，满足企业品牌视觉要求。

潜在局限：环境依赖是首要门槛，用户必须预先安装 Node.js 运行时和 @mermaid-js/mermaid-cli npm 包，在受限环境（如无网络连接的生产服务器）中难以部署。功能层面，复杂的图形布局（如大型系统的架构图）可能需要手动调整节点位置，自动布局算法在极端复杂场景下可能产生重叠或排版混乱。维护层面，该技能由个人开发者（T3 来源）维护，长期更新和技术支持的持续性存在不确定性。

目标群体：主要面向技术文档工程师、系统架构师、产品经理和开发团队。技术写作者可利用其快速生成 API 文档中的调用流程图；架构师适合绘制微服务架构图和数据库 ER 图；项目经理可使用甘特图功能进行进度规划；开发团队则常用于绘制 Git 工作流和状态机设计。对于需要频繁更新图表内容的敏捷团队尤为适用。

使用风险：性能方面，渲染大型图表（数百个节点）时可能消耗较多内存和 CPU 资源，建议在本地环境而非生产服务器执行。依赖风险方面，若 npm 包安装失败或版本不兼容（当前要求 >=10.0.0），将导致功能完全不可用。操作风险包括临时文件管理（虽使用 mktemp 安全创建，但仍需确保 /tmp 目录有足够空间）和输入验证（恶意构造的 Mermaid 语法虽不会导致代码注入，但可能产生资源消耗型渲染）。建议仅在可信输入环境下使用，并定期清理生成的临时文件。