流程图助手:把口头流程整理成可维护的图解

前言

需求文档里最常见的一类内容是流程:审批怎么走、用户从进入到付费经过几步、两个系统之间谁调谁、运维操作按什么顺序执行。这些内容通常先以口头或邮件形式出现,落到文档和代码里时容易出现三件事——节点边界不清楚、判断条件只写了主干、异常路径和责任人被漏掉。

下面介绍的 Skill 专门处理这一类任务:把一段描述整理成节点、分支、异常和责任边界都明确的图解。

这是什么

流程图助手(@user_b4da0893/flowchart-planner-cn)是一个基于通用 SKILL.md 格式的 Skill,发布者为 user_b4da0893,来源标记为 community,当前版本 1.0.0,在 SkillHub 上归入 office-efficiency 分类。

它解决的问题是:给定一段业务流程描述,产出结构化的图解,而不是一段散文。覆盖的场景包括业务流程、审批流、用户旅程、系统交互和操作说明。

核心功能

根据官方页面给出的简介,这个 Skill 的能力可以拆成四组。

  1. 图型选择。根据描述内容判断该用流程图、泳道图还是用户旅程图,而不是一律输出同一种形状。
  2. 结构拆解。把整段描述拆成节点,识别判断条件形成的分支、异常路径,以及需要按角色或系统划分的泳道,并给节点编号。
  3. 多种输出形式。可以输出 Mermaid 代码、文本草图,或者绘图规格(即给下游绘图工具用的结构化描述),三种形式按用途选。
  4. 一致性检查。输出前做一致性检查,用于发现主干与分支不一致、编号断裂、责任边界重叠之类的问题。

页面标签显示 requires_api_key=false,也就是说这个 Skill 不需要配置 API Key 即可使用。

安装与启用

官方页面给出的坐标和地址如下。安装命令、安装目录和配置文件字段在已抓取资料中没有提供,这里如实说明,不推测。

SkillHub 页面: https://www.skillhub.cn/skills/user_b4da0893/flowchart-planner-cn
接口地址:     https://api.skillhub.cn/user_b4da0893/flowchart-planner-cn
坐标:         @user_b4da0893/flowchart-planner-cn

调用方式与所有通用 SKILL.md 格式的 Skill 一致:把流程描述作为输入交给 Skill,由它完成拆解和输出。具体接入方式(Cursor、Codex CLI、Claude Code 等)在官方资料中没有分别说明,因此这里不写未经核实的差异。

典型用法

用法分三步:给描述、指定输出形式、检查结果。

1、准备一段流程描述。描述应当包含参与角色、先后顺序、判断条件,以及已知的异常情况。只有主干没有异常描述时,一致性检查能发现的分支缺口有限。

2、说明需要哪种输出。如果目标是把图放进文档或 wiki,用 Mermaid;如果只是评审时快速看一遍,用文本草图;如果下游要接绘图工具,用绘图规格。

3、拿回结果后先看一致性检查项,再决定是否接受这张图。下面是一个按官方能力描述构造的示意,不是官方页面给出的样例。

flowchart TD
    A[用户提交申请] --> B{是否包含必填材料}
    B -->|是| C[进入人工审核]
    B -->|否| D[退回补充材料]
    C --> E{审核结果}
    E -->|通过| F[通知申请人]
    E -->|不通过| G[记录驳回原因]

在这个示意里,判断条件、异常路径(退回补充材料、记录驳回原因)和结果节点都单独列出,而不是并进主干描述中。

适用场景与注意

适合的场景:业务流程梳理、审批流定义、用户旅程整理、系统交互说明、操作手册编写。凡是需要把一段流程描述转成可评审、可维护的结构的地方,都能用。

需要注意的几点:

  1. 来源是 community,不是官方团队维护,输出结果需要自己核对,尤其是业务术语和角色名称。
  2. 版本号是 1.0.0,属于早期版本,接口和输出格式后续可能调整。
  3. 评分显示为 100000,下载 1665 次,安装数页面显示为 0。评分数值偏高,参考意义有限,建议以实际试用为准。
  4. 输出质量取决于输入描述的完整度。描述里没有的异常路径和角色,Skill 无法凭空补出来,需要在输入阶段提供。

结尾

流程图助手的价值在于把流程描述从散文变成结构,让节点、分支、异常和责任边界在图里直接可见,而不是散落在文字里。如果你手上有正在整理的流程描述,可以从一次小范围的图解开始试。

官方地址:https://api.skillhub.cn/user_b4da0893/flowchart-planner-cn
SkillHub 页面:https://www.skillhub.cn/skills/user_b4da0893/flowchart-planner-cn

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye