Agent Skills
返回列表
Mermaid 图表代码生成器

Mermaid 图表代码生成器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_52a81e7a/mermaid-generator。

技能介绍

要解决什么问题

在文档、评审或设计讨论里,你往往已经用自然语言把流程或架构说清楚了,但还要自己查 Mermaid 语法、补节点 ID、处理分支和层级,容易漏边、引号转义出错,改一轮才能渲染。这个技能把「描述 → 可运行代码」当成固定交付:输入是流程/架构叙述,输出是可直接放进 Markdown 的 mermaid 代码块。

技能如何工作

它会按约定流程推进,而不是一次性瞎猜结构:

  1. 确认图表类型:若你未说明,会先问是流程图、时序图、类图等哪一种 Mermaid 图表。
  2. 补齐描述:信息不足时会追问关键节点、分支条件、上下游与层级关系。
  3. 设计结构:在生成前把叙述映射成节点与边,流程图会刻意体现二级、三级等多层级,避免扁平一条线。
  4. 生成与校验:写出符合 Mermaid 规范的代码,并检查节点 ID、连线、引号与特殊字符转义,减少语法错误。
  5. 交付格式:最终结果放在 `mermaid 代码块中,便于复制到 Wiki、PR 或博客。

核心能力来自对 Mermaid 语法与各图表类型的熟悉,以及把流程分析、架构设计需求转成结构化图形的经验。

适用边界与注意点

  • 输出质量依赖你提供的描述粒度;边界条件、异常分支若未说明,图中可能不会体现,需要你在追问环节补全。
  • 复杂业务若节点过多,仍建议在生成后结合渲染结果微调文案与布局;技能侧重语法正确与结构清晰,不替代你在产品语义上的最终拍板。
  • 若你已明确图表类型与完整路径,可在一开始写全,可跳过「询问类型」步骤,加快一轮交付。

使用场景

  • 在 RFC 或设计文档里已用文字写好审批/发布流程,需要转成可渲染的多层级 Mermaid 流程图嵌入 Markdown
  • 梳理微服务或模块间的调用顺序与分支条件,希望根据口头或笔记描述直接得到语法正确的时序图或流程图代码
  • 评审前要把会议里记录的 onboarding、故障处理步骤整理成带二级、三级节点的流程图,避免手工查语法改 ID
  • 在 Wiki 或 PR 说明中补充部署/回滚路径,输入环境步骤描述后交付可粘贴的 `mermaid` 代码块

适合人员

  • 负责在内部 Wiki 维护服务交互与异常分支说明的后端工程师,希望描述即出可渲染图
  • 要把 PRD 里流程章节落到开发者文档里的技术写作者,需多层级流程图且少踩 Mermaid 语法坑
  • 准备架构或方案评审材料的技术负责人,习惯先用自然语言列模块关系,再快速生成结构化图表代码
  • 维护开源项目 README 的维护者,需把安装、配置、发布步骤从文字说明转为标准 Mermaid 流程图