dynamic-flow-diagramlisted
Install: claude install-skill qidian777/dynamic-flow-diagram
# 动态流程图生成器
把业务流程图从「一张静态图片」升级为「一件会讲解的工具」。产出物永远是**单个 HTML 文件**:双击即用、无需联网、可直接发给同事。
## 什么时候用 / 不用
| 用 | 不用 |
|---|---|
| 流程培训、新人带教、评审汇报 | 需要真实系统联动的可执行流程引擎 |
| 把 Visio/Axure 老图变成可交互版本 | 只要一张静态配图(直接截图更快) |
| 梳理「谁在什么阶段做什么」 | 架构图、思维导图(形态不同) |
| 流程变更前后对比讲解 | 数据看板(用图表类技能) |
## 两种模式,先选后做
| | 单图模式(v1) | 工作台模式(v2) |
|---|---|---|
| 场景 | 一张流程图的培训/评审 | 全公司多张流程的体系梳理 |
| 产出 | 一个 HTML 动态流程图 | 一个 HTML 流程工作台(五视图) |
| 数据 | 直接改 template.html 里的数组 | 中央清单 manifest → 构建脚本 |
| 坐标 | 手写 x/y | 自动布局(拓扑分层 + 泳道定列) |
| 判断依据 | 用户只给了一张图/一个流程 | 用户提到"所有流程/多张流程/流程体系",或流程之间存在子流程引用 |
单图模式走下面"五步工作流";工作台模式先读 `@references/workbench-spec.md`。
## 工作台模式六步
1. **取材**:三种入口殊途同归——vsdx 逐页解析、Excel 清单、口述建模,终点都是 manifest
2. **建字典**:先定部门/角色/系统三张全局表,和客户确认口径,再动手写流程
3. **写 manifest**:参考 `@examples/demo-manifest.yaml` 的结构;坐标不用写
4. **体检**:`python scripts/build_workbench.py <manifest> --check`,断链和术语问题先清后建
5. **构建**:`-o` 产出单文件 HTML;`--strict` 用于交付把关
6. **验收**:`node scripts/shot_workbench.js <html> <shots>` 跑八图断言,再按 workbench-spec 的四条附加项过一遍
工作台的铁律(在 v1 七条之上追加):
- **manifest 是唯一事实**。要改流程改 manifest 重新构建,永远不要直接改产出的 HTML
- **字典先行**。角色和系统口径没和客户对齐之前,不写节点
- **`--strict` 不过不交付**。断链是"点击就 404"级别的问题
## 五步工作流(单图模式)
### 第 1 步:取材
- `.vsdx` → 跑 `scripts/parse_vsdx.py`(见 `references/layout-rules.md` 里"解析"一节);多页文件先看 `pages.xml` 选结构最全的一页,动手前跟用户确认选哪页
- `.vsd`(旧二进制)→ 请用户另存为 `.vsdx`,或提供 PDF/高清截图
- 图片/PDF → 按版面人工重建,节点文字必须回读给用户确认
- 纯文字流程 → 直接建模,缺的角色/系统先按"待确认"标注
### 第 2 步:建模(先数据后图形)
先把流程抽成四张表再动手写 HTML,跳过这步一定返工:
1. **阶段(PHASES)**:纵向分段,如 入库/借出/归还/报废
2