前言¶

流程图画到一半，发现工具要么太重（要装 BPMN 建模器），要么太随意（手画框图，改一次连线全乱）。更常见的是：需求评审会上要一张审批流，代码评审时要一张系统交互图，文档里要一张泳道图，三张图风格还不统一。

下面介绍的是一个 Agent Skill，用来把这类流程可视化需求收敛成一份可复现的代码产物：你描述流程，它产出 Mermaid flowchart 或 PlantUML 源码。

这是什么¶

「流程图绘制向导」（坐标 @user_af163eaa/z-diagram-flow）是一个社区来源的 Agent Skill，版本 1.0.1，发布者 user_af163eaa，在 SkillHub 上的分类为 dev-programming。

它的定位是一份流程可视化指南：输入业务流程描述，输出 Mermaid flowchart 或 PlantUML 代码。它不替代 BPMN 引擎，也不做流程仿真或表单设计。

需要说明的是，官方页面未标注 API Key 要求（标签为 requires_api_key=false）。

核心功能¶

根据官方简介，该 Skill 的能力范围如下：

1. 绘制业务流程图与泳道图。
2. 输出 Mermaid flowchart 代码，也输出 PlantUML 代码，两种语法可按需选择。
3. 覆盖三类常见流程：审批流、业务流程、系统交互。

它不做的事同样明确：不做 BPMN 级别的过程引擎能力（如流程状态管理、任务指派、超时重试），这些应由专门的 BPMN 引擎承担。

获取与启用¶

官方地址：https://api.skillhub.cn/user_af163eaa/z-diagram-flow

SkillHub 页面：https://www.skillhub.cn/skills/user_af163eaa/z-diagram-flow

已抓取资料中未提供 npx skills add 之类的安装命令，也没有给出目录路径或配置文件字段。该 Skill 基于通用 SKILL.md 格式，具体启用方式以 SkillHub 页面说明为准，本文不臆造安装步骤。

典型用法¶

官方资料未附可复现的示例输入输出。下面这个最小示例用于说明该 Skill 的输出形态（Mermaid flowchart），不是官方文档示例：

flowchart TD
    A[提交申请] --> B{金额 ≤ 10000}
    B -- 是 --> C[主管审批]
    B -- 否 --> D[部门经理审批]
    C --> E[归档]
    D --> E

使用方式是把流程描述交给 Agent，并指明要用 Mermaid 还是 PlantUML，再把产出代码贴到支持对应语法的渲染环境里查看。

适用场景与注意¶

适合的场景：文档中的审批流说明、需求评审用的业务流程图、多个角色或系统之间的交互图。这类图的价值在于把逻辑讲清楚，而不在于长期维护状态。

需要注意的限制：

1. 它产出的是源代码，不是图形编辑器。连线调整、样式美化需要在渲染环境或代码里改。
2. 不替代 BPMN 引擎。如果流程要真正驱动任务流转、状态持久化、人工待办，应使用 BPMN 引擎。
3. 泳道图的表达能力取决于所使用的 Mermaid 或 PlantUML 语法版本，请在目标渲染环境先验证。
4. 官方页面没有提供示例和详细文档，上手前建议先用一个小流程验证输出是否符合预期。

结尾¶

这个 Skill 的价值在于把「画流程图」这件事从打开建模工具、手动拖框，变成直接产出可版本化、可评审的 Mermaid 或 PlantUML 源码，覆盖审批流、业务流程和系统交互三类场景。

官方地址：https://api.skillhub.cn/user_af163eaa/z-diagram-flow