Agent Skills
返回列表
Mermaid 图解

Mermaid 图解

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md，把 @zcwl/mermaid-diagram 安装到你的 AI 助手中。

技能介绍

解决什么问题

在技术方案、接口文档和架构评审中，流程图、时序图、思维导图和 ER 图经常需要即时补充。手写 Mermaid 容易出现子图闭合、箭头方向和节点命名等语法问题；从一段需求描述直接拿到可渲染的图代码，比反复打开绘图工具更顺手。

技能如何工作

@zcwl/mermaid-diagram 面向支持 SKILL.md 的 AI Agent 场景使用。典型调用时，把需求放入 content，再根据输出形态选择 mode，例如 json、text 或 markdown；如需统一视觉表达，可传入 style 参数并参考 references/style.md。

  • 图表类型：覆盖流程图、时序图、思维导图、ER 图等 Mermaid 图。
  • 输出形态：可生成 Mermaid 代码，或按 mode 返回结构化文本。
  • 风格控制：通过 style 调整输出风格，适合嵌入文档、笔记或 Agent 工作流。
  • 运行依赖：通常由 Agent 内置 LLM API 提供推理能力，支持 Windows、macOS、Linux 等环境。

适用边界与注意点

该技能更适合把清晰需求转成图表草稿，不适合替代需要人工判断的复杂架构决策。输入越具体，生成结果越稳定；若输出格式不符合预期，优先检查 content 是否包含实体、关系、分支和顺序。涉及敏感数据时，应谨慎放入提示词；批量生成多个图时，建议逐张检查节点命名和连线语义。

使用场景

  • 在接口联调前，把服务调用顺序和异步回调整理成可评审的时序图。
  • 写技术方案时，将部署模块、依赖关系和故障路径转成流程图。
  • 梳理数据模型时，把实体、字段和关联关系生成为 ER 图。
  • 做需求澄清时，把分支判断和用户路径整理成思维导图。

适合人员

  • 后端工程师：把服务调用、重试和依赖关系整理成时序图用于联调评审。
  • 技术文档作者：把架构说明中的模块关系转成流程图并嵌入 Markdown 文档。
  • 产品经理：把业务流程、异常分支和审批路径整理成流程图用于需求评审。
  • 数据工程师：把表结构、字段和关联关系整理成 ER 图沟通数据模型。