用途：为技术文档生成清晰的 Mermaid 图表，并通过可重复的验证回路在最终交付前捕获语法和渲染错误。
主要能力：根据沟通意图选择最小合适的图类型——flowchart 用于流程与架构，sequenceDiagram 用于交互时序，stateDiagram-v2 用于状态转换。生成 Markdown 时每个图表仅使用一个 Mermaid 代码围栏，开栏为 mermaid、闭栏为 ，围栏标记位于第 0 列。
验证方式：使用 mmdc 校验完整 Markdown 文件： mmdc -i <input.md> -o /tmp/<name>-rendered.md -a /tmp/<name>-mermaid-artifacts
失败处理：读取 mmdc 原始输出，在失败的围栏中做最小针对性修复，然后重跑同一整文件校验命令，最多重试 3 次。仍失败则返回尽力修正的图表、验证摘要与可能根因、Mermaid CLI 原始错误摘录及下一步手动修复建议。重试规则：除非错误表明类型关键字无效，否则不改变图表类型；每次重试优先最小编辑以免引入新语法错误；保留用户意图与语义；验证成功即提前停止。
多图表文档：对包含多个 Mermaid 块的现有文件运行一次整文件校验，解析 CLI 输出识别块数量与渲染产物，依据解析错误片段确定失败围栏，仅修补失败块后再重跑整文件校验，最后给出汇总：总块数、通过、失败、已修复、未解决。
运行时要求：mmdc 须在 PATH 中可用；在沙箱 AI 工具中需显式允许执行 mmdc；以 mmdc 的 stdout/stderr 作为通过与否及诊断的唯一依据。任何非零退出码视为失败。若因依赖、访问或输入问题（如沙箱中 mmdc 不可执行）导致无法验证，应立即停止重试，并明确说明未执行验证，附上失败的确切 mmdc 命令、退出码（如有）、原始 stderr 摘录，以及授予 mmdc 执行权限或修复文件/路径权限的下一步。输出须始终包含最终的 Mermaid Markdown 块和简短验证结果摘要。该技能以 🎨 作为上下文标记，需在响应开头按引入顺序输出活动标记。