Mermaid Architect

核心功能

Mermaid Architect 是一个专注于生成高质量 Mermaid 图表的专用技能，覆盖四大核心图表类型：

• Flowcharts（流程图）：业务流程映射、决策树可视化
• Sequence Diagrams（时序图）：API 调用链路、用户交互流程
• Class Diagrams（类图）：面向对象结构、数据库模式设计
• State Diagrams（状态图）：生命周期管理、状态流转

显著优点

1. 语法健壮性：强制使用引号包裹含特殊字符的标签，避免解析错误
2. 布局优化：内置 ELK 布局引擎支持，图表自动排版美观
3. 安全设计：节点 ID 规范（camelCase/PascalCase，禁用保留字），降低语法冲突风险
4. 方向智能推荐：TD 用于层级结构，LR 用于时间线场景
5. Subgraph 规范化：显式 ID + 标签分离，避免空格导致的解析问题

潜在局限

• 输出为代码块形式，需配合 Mermaid 渲染环境（如 GitHub、Notion、专用编辑器）查看图形
• 复杂图表的自动布局可能出现节点重叠，需手动微调
• 不支持交互式编辑，仅作一次性生成

适用人群

• 技术文档撰写者、系统架构师、产品经理
• 需要快速将文字描述转化为标准化图表的开发者
• 追求图表一致性与语法安全性的团队

风险说明

• 无代码执行权限，仅生成静态文本
• 输入内容可能包含敏感信息，建议避免在标签中硬编码机密数据
• 依赖外部 Mermaid 引擎渲染，不同平台兼容性存在差异

核心用法

Mermaid Architect 是一个专注于图表生成的文档型 Skill，并非可执行程序，而是提供完整的 Mermaid 语法规范与最佳实践指南。用户触发关键词如 "diagram"、"flowchart"、"sequence diagram" 或 "visualize this process" 时，该 Skill 指导 AI 生成符合规范的 Mermaid 代码块。

主要能力覆盖：

• 流程图 (Flowcharts)：进程映射、决策树
• 序列图 (Sequence Diagrams)：API 调用、用户交互
• 类图 (Class Diagrams)：面向对象结构、数据库模式
• 状态图 (State Diagrams)：生命周期管理

关键语法规范：

• 节点标签含括号、逗号或冒号时必须使用引号包裹
• 节点 ID 禁用空格，推荐 camelCase/PascalCase/下划线命名
• 避免保留字：end、subgraph、graph、flowchart
• 层级结构用 TD (自上而下)，时间线用 LR (自左而右)
• 子图语法：subgraph id [Label]（ID 无空格，标签可含空格）

显著优点

1. 零安全风险：纯 Markdown 文档，无可执行代码、无网络调用、无外部依赖
2. 语法健壮性：内置防御性编程规范，避免常见 Mermaid 语法错误
3. 多场景覆盖：支持四种核心图表类型，满足技术文档、架构设计、流程梳理需求
4. 可验证性：提供验证脚本 scripts/validate-mmd 确保生成代码合规

潜在缺点与局限性

1. 非自动化工具：本身不生成图表，需配合 Mermaid 渲染引擎使用
2. 学习成本：需理解节点 ID 与标签的区分、引号转义等细节
3. 布局受限：依赖 Mermaid 引擎的自动布局，复杂图表可能需手动调整
4. T3 来源等级：个人开发者/GitHub 社区项目，无企业背书

适合人群

• 技术写作者、架构师、产品经理需绘制系统流程图
• 开发团队需规范 API 交互文档
• 开源项目维护者需可视化项目结构
• 任何需将复杂逻辑可视化的知识工作者

常规风险

实际风险极低。该 Skill 为纯文档型（T-MD 分类），经六维扫描（静态代码、动态行为、依赖审计、网络分析、隐私合规、威胁情报）全部通过，评分 98/100，评级 S+ 顶级安全。无数据收集、无权限申请、无已知 CVE 漏洞。唯一建议：当前未明确开源许可证，使用者应留意合规性。