前言¶
需求文档里最常见的一类内容是流程:审批怎么走、用户从进入到付费经过几步、两个系统之间谁调谁、运维操作按什么顺序执行。这些内容通常先以口头或邮件形式出现,落到文档和代码里时容易出现三件事——节点边界不清楚、判断条件只写了主干、异常路径和责任人被漏掉。
下面介绍的 Skill 专门处理这一类任务:把一段描述整理成节点、分支、异常和责任边界都明确的图解。
这是什么¶
流程图助手(@user_b4da0893/flowchart-planner-cn)是一个基于通用 SKILL.md 格式的 Skill,发布者为 user_b4da0893,来源标记为 community,当前版本 1.0.0,在 SkillHub 上归入 office-efficiency 分类。
它解决的问题是:给定一段业务流程描述,产出结构化的图解,而不是一段散文。覆盖的场景包括业务流程、审批流、用户旅程、系统交互和操作说明。
核心功能¶
根据官方页面给出的简介,这个 Skill 的能力可以拆成四组。
- 图型选择。根据描述内容判断该用流程图、泳道图还是用户旅程图,而不是一律输出同一种形状。
- 结构拆解。把整段描述拆成节点,识别判断条件形成的分支、异常路径,以及需要按角色或系统划分的泳道,并给节点编号。
- 多种输出形式。可以输出 Mermaid 代码、文本草图,或者绘图规格(即给下游绘图工具用的结构化描述),三种形式按用途选。
- 一致性检查。输出前做一致性检查,用于发现主干与分支不一致、编号断裂、责任边界重叠之类的问题。
页面标签显示 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[记录驳回原因]
在这个示意里,判断条件、异常路径(退回补充材料、记录驳回原因)和结果节点都单独列出,而不是并进主干描述中。
适用场景与注意¶
适合的场景:业务流程梳理、审批流定义、用户旅程整理、系统交互说明、操作手册编写。凡是需要把一段流程描述转成可评审、可维护的结构的地方,都能用。
需要注意的几点:
- 来源是
community,不是官方团队维护,输出结果需要自己核对,尤其是业务术语和角色名称。 - 版本号是
1.0.0,属于早期版本,接口和输出格式后续可能调整。 - 评分显示为
100000,下载1665次,安装数页面显示为0。评分数值偏高,参考意义有限,建议以实际试用为准。 - 输出质量取决于输入描述的完整度。描述里没有的异常路径和角色,Skill 无法凭空补出来,需要在输入阶段提供。
结尾¶
流程图助手的价值在于把流程描述从散文变成结构,让节点、分支、异常和责任边界在图里直接可见,而不是散落在文字里。如果你手上有正在整理的流程描述,可以从一次小范围的图解开始试。
官方地址:https://api.skillhub.cn/user_b4da0893/flowchart-planner-cn
SkillHub 页面:https://www.skillhub.cn/skills/user_b4da0893/flowchart-planner-cn