Mermaid 图表专家

你在解决什么问题

文档和评审里，流程、接口时序、数据模型、状态机往往靠口头描述或截图，改一版就要重画。Mermaid 用文本描述图表，适合进仓库和 PR，但语法分支多、布局一挤就难读，还容易选错图类型（例如把 API 交互画成普通流程图）。

技能如何工作

本技能把 Agent 约束成 Mermaid 可视化专家，按「目标 → 约束 → 输入」对齐后再落笔，而不是只吐一段未验证的代码。

覆盖的图表类型包括：

• 流程图与决策树
• 面向 API/交互的时序图
• 实体关系图（ERD）
• 状态图与用户旅程图
• 项目时间线的甘特图
• 架构图与网络图

典型工作方式：

1. 根据数据结构或叙事选择合适的图表类型
2. 控制节点密度，保持可读性
3. 统一样式与配色，并补充有意义的标签
4. 交付前说明如何渲染/预览，必要时给出备选方案、样式定制、可访问性与导出建议
5. 对复杂语法在代码中加注释；同时提供基础版与样式版

更完整的示例与检查清单见技能内的 resources/implementation-playbook.md。

适用边界

任务与 Mermaid 无关、或需要本技能范围外的其他工具与领域时，不应启用。输出以 Mermaid 源码与渲染说明为主，不替代你方对业务语义与最终排版的验收。