前言¶
技术文档里常见有序列表、分步说明和章节嵌套，读者要在脑子里串成一条线。手写 Mermaid 能画图，但要先把 prose 拆成节点和边，再选 flowchart、graph 等语法，维护成本不低。若希望 Agent 在对话里根据现有 Markdown 直接产出可渲染的流程图，可以装一个面向「文档 → Mermaid」的 Skill，而不是每次从零写图。
下面介绍 SkillHub 上的 Markdown转流程图（坐标 @user_6df795bb/markdown-to-flowchart，版本 1.0.0）。
这是什么¶
Markdown转流程图 是社区来源（community）的 Agent Skill，发布者为 user_6df795bb，分类为 dev-programming。它按通用 SKILL.md 规范编写，供 Cursor、Claude Code、Codex 等支持 Skills 的客户端加载。
Skill 的定位是：将任意 Markdown 文档转换为 Mermaid 流程图，用于可视化文档中的步骤、流程、架构、依赖关系等。标签 requires_api_key=false，不依赖额外 API Key。
核心功能¶
根据 SkillHub 页面说明，已核实的能力包括：
- 输入：用户提供的 Markdown 正文（或指向文档内容的上下文），涵盖部署、安装、配置步骤，架构与 API 说明，README、教程、决策与任务流程、运维与故障排查等结构化文字。
- 输出：Mermaid 流程图代码，便于在支持 Mermaid 的编辑器、文档站或预览器中渲染。
- 触发意图：当用户说「做流程图」「生成流程图」「可视化文档」「画个图」等类似需求时，Agent 应启用该 Skill 的处理方式。
SkillHub 统计（页面展示）：评分 100000，下载 10327，安装 137。
安装与启用¶
官方推荐两种方式，本质都是按 SkillHub 安装文档拉取 @user_6df795bb/markdown-to-flowchart。
方式一：让 Agent 按官方提示安装¶
在对话中发送 SkillHub 给出的安装提示（原文）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_6df795bb/markdown-to-flowchart`。
Agent 会读取 SkillHub 安装与优先源配置，检查 skillhub CLI 并按规范安装到当前环境的 Skills 目录。
方式二：本机用 skillhub CLI¶
先确认 CLI 是否可用：
command -v skillhub && skillhub --version
未安装时，可按安装文档执行完整安装（示例为文档中的推荐命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录；装到默认 ./skills/ 可能不会被客户端识别。安装文档给出的常用路径示例：
| 客户端 | Skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
在对应目录下安装本 Skill 的命令形式为（与安装文档第三节一致，将技能名换为本坐标）：
skillhub install user_6df795bb/markdown-to-flowchart --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你实际使用的 Agent 路径。安装后按各客户端要求刷新或重启，使 Skill 生效。
典型用法¶
公开资料未附带固定 CLI 子命令；用法以「对话 + Skill 指令」为主，可复现的流程如下。
- 确认已安装
@user_6df795bb/markdown-to-flowchart且 Agent 已加载 Skills。 - 粘贴或引用需要可视化的 Markdown（例如 README 中的安装步骤、故障排查清单）。
- 用 Skill 说明中的意图触发，例如：「把下面这段 Markdown 生成 Mermaid 流程图」或「可视化这份部署文档」。
- 在回复中拿到 Mermaid 源码，粘贴到支持 Mermaid 的预览环境核对节点与连线是否符合原文顺序与分支。
输出为 Mermaid 文本，具体图表类型（流程图、时序等）由 Skill 内指导 Agent 根据文档结构选择；若需固定版式，可在提问时补充约束（如「只保留主路径，省略异常分支」）。
适用场景与注意¶
适合谁：写技术文档、运维手册、架构说明的开发者；希望在评审或交接时用一张图概括步骤，又不想长期手写 Mermaid 维护的团队。
适用内容：步骤链、分支判断、依赖关系、模块协作等能从 Markdown 结构推断出「先后」与「分支」的文本。官方列举的场景包括技术文档、系统架构、API 文档、README、教程、决策与任务流程、项目管理、运维与故障排查等。
注意：
- 复杂 prose 或表格密集段落，自动构图可能漏节点或合并过度，生成后应人工对照原文校对。
- Mermaid 需在目标平台开启支持；不同渲染器对语法子集支持略有差异。
- 版本以 SkillHub 为准，当前为 1.0.0；升级可通过
skillhub与安装文档中的更新流程处理。
结尾¶
Markdown转流程图 把「文档已有、图还没有」的缺口补上：在对话里用自然语言要图，由 Agent 按 Skill 把 Markdown 转成 Mermaid 流程图，且无需 API Key。安装与详情见 SkillHub 官方页：
- 页面：https://www.skillhub.cn/skills/user_6df795bb/markdown-to-flowchart
- API 条目：https://api.skillhub.cn/user_6df795bb/markdown-to-flowchart
