SuperAPI AI 工具集

mermaid

通用与其它

查看项目

更新于 10-15 17:34

技能介绍

用途:根据用户描述生成 Mermaid 图表源码,作为侧路工具嵌入 PRD、研究笔记、issue、架构提案等产物中。用户明确要求 Mermaid 图表,或某流程技能需要内嵌图表时可调用;若用户想要白板草图应改用 /excalidraw-diagram,若需要渲染后的图片文件则不适用,因为本技能只产出源码。

主要能力:支持 23 种图表类型,包括流程图、时序图、类图、状态图、ER 图、甘特图、饼图、思维导图、时间线、Git 图、象限图、需求图、C4 图、桑基图、XY 图、块图、数据包图、看板、架构图、雷达图、树状图、用户旅程和 ZenUML。每种类型在 references/ 下有对应语法参考,生成前应先阅读。

使用方式:先识别图表类型,描述含糊时提一个澄清问题;再读取对应参考文件;生成代码并用 ```mermaid 围栏包裹,使用语义化节点 ID 和可读标签,按需给出方向提示;仅在提升清晰度时使用主题或指令;最后用 mmdc 验证渲染。验证命令示例:npx --yes -p @mermaid-js/mermaid-cli mmdc -i 文件 -o 输出.svg。

限制:Mermaid 语法严格且对版本敏感,语法错误在 Markdown 查看器中会被静默吞掉,必须渲染验证。常见陷阱包括参与者别名中的 + 或 -、未加引号的比较符号、节点标签中的括号、& 符号、以 { 开头的消息、嵌套不平衡括号、节点标签内的 Markdown 链接等。面向主题感知查看器的时序、状态、ER 图需加对比度安全指令。本技能不单独产出 GitHub 产物,也不推进流程,完成后控制权返回调用方。