流程图绘制向导
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_af163eaa/z-diagram-flow。
技能介绍
它解决什么问题
需求评审或系统设计会上,用大段文字描述流程几乎注定失败:分支条件藏在段落里,角色职责混在一起,读到第二遍就会有人问"异常情况呢"。这个 Skill 只做一件具体的事:把口头或文档里的业务流程,翻译成结构清晰、可直接渲染的 Mermaid 或 PlantUML 流程图代码。它不生成图片,也不维护图表库,只产出 flowchart 语法文本,贴进任意支持渲染的工具即可查看。
核心能力与工作流程
Skill 的方法论归纳为四个要点:
- 明确起点/终点与参与角色:先定位流程的入口和出口,再列出全部参与方。
- 用 subgraph / 泳道分区:借助 Mermaid 的
subgraph语法划分泳道,让不同角色的职责边界一目了然。 - 标注判断分支与条件:所有菱形判断节点都要写明分支条件,不留"看情况"。
- 统一节点形状语义:开始/结束、处理、判断、数据各用固定形状,避免一张图多种画法。
实际使用时的工作流程更偏工程化:
- 列出步骤与角色,形成完整清单。
- 画流程图草稿,确定节点与连线。
- 套用
flowchart语法写成代码。 - 渲染校验分支完整性,确认每个判断都有去处。
适用边界与注意点
它适合三类场景:业务/审批流程的文档化、用泳道区分角色职责、梳理系统间交互流程。但要注意几点:
- ❌ 不能替代 BPMN 流程引擎,无法执行或管理运行态流程。
- ❌ 不适合复杂事件编排。
- ⚠️ 代码必须在渲染器中实际验证,语法错误往往渲染时才暴露。
- ⚠️ 涉密流程务必先脱敏,流程图同样会泄露内部逻辑。
使用场景
- 需求评审会上,把口头描述的报销审批流程画成 Mermaid 流程图,逐条确认分支走向
- 撰写产品需求文档时,需要用泳道图区分客服、运营、财务在退款流程中的各自职责
- 梳理订单系统与支付、风控服务之间的交互流程,输出 PlantUML 流程图附在技术方案里
- 接手遗留审批系统,把散落在邮件和会议纪要里的流程规则还原成完整流程图再谈改造
适合人员
- 产品经理:需要在需求文档里附上审批流泳道图,替代动辄千字的文字说明
- 后端工程师:在技术方案中用流程图描述系统间调用关系与判断逻辑,供评审对照
- 测试工程师:依据需求中的流程图核对分支覆盖,据此补齐异常路径的测试用例
- 业务分析师:把业务规则转成流程图,让开发与产品在评审时对着同一张图讨论