interactive-diagram-htmllisted
Install: claude install-skill XuGuanghaiGoogle/interactive-diagram-html
# 交互式图解 HTML
把设计或计划做成一份可以直接发给评审者的单文件 HTML:图上每个方块都能点开,在右侧看到作用、功能要点、输入输出和阶段范围,图下附一览表和说明卡片。
结构上分成两部分:**引擎固定、数据可变**。交互行为都写在 `assets/engine.html` 里,已经调试好;每次任务只写一份数据 JSON,交给 `scripts/build.mjs` 校验后注入引擎。这样能保证每次生成的交互都一致,而方块重叠、连线穿过方块、ID 写错这类布局问题,脚本会直接指出来,不需要靠人眼去找。
## 适用范围
- 系统 / 环境构成图、处理流程图、开发计划(时间轴 + 泳道 + 里程碑)、业务流程(泳道)、组织体制图、迁移计划、路线图等。
- 需要"图 + 逐项说明 + 一览表"合在一份文件里,给评审或交接用的场景。
- 用户想自己在浏览器里拖动调整布局、补连线,再把结果存回数据文件的场景(编辑模式)。
不适用:只要一张静态图片(直接用 mermaid 等更快);以数据图表为主体的报表(柱状图、折线图);幻灯片;多人同时在线编辑的白板。
## 前置条件
Node.js ≥ 18,不需要安装任何 npm 包。下文中的 `$SKILL` 指本 skill 所在目录,也就是加载时提示的 Base directory。
## 工作流程
### 1. 确认场景(第一轮提问)
如果有 AskUserQuestion 工具,就用它把问题一次问完;没有的话,就用一条简短的消息列出选项。用户已经说明的内容不要再问。
- **场景**:系统 / 环境构成图、处理流程图、开发计划、业务流程(泳道)、组织体制图、其他
- **页面语言**:日语、中文或英语。默认跟随用户对话时用的语言;如果用户已有同类文档,优先沿用那些文档的语言
- **阶段范围**:是否需要标出 M0 / PoC、P0 / P1、MVP 这类范围,并提供开关
- **是否需要编辑**:生成后要不要在浏览器里自己拖动方块、调整宽度、画连线并保存。默认"只看不改";用户要自己调整布局、或预计会反复微调位置时选"需要编辑"
- **素材**:已有的文档、drawio、表格或代码仓库路径。有素材就先读,读得到的内容不要再问用户
确认场景后,读 [references/scenarios.md](references/scenarios.md) 里对应的那一节。那里给出了该场景推荐的布局类型、分组、节点类别、面板字段、表格和卡片,还有第二轮要问的问题。
### 2. 收集内容(第��轮提问)
按场景给出的问题清单提问,每轮最多 4 个问题,只问那些会实质改变图的内容。信息不足、但有合理默认值的地方,直接采用默认值,并在大纲里标出来。
### 3. 先给大纲,用户确认后再画
用简短的列表给出以下内容,请用户确认或修改:
- 分组(容器或泳道)
- 节点清单:按分组列出,每个节点一行,写名称、一句话作用和阶段
- 主要连线,以及它们表示什么(数据流、依赖或调用)
- 表格和说明卡片的标题
这样做是因为改大纲只需几秒,而改一张已经排好坐标的图,往往要把整张图重排一遍。
### 4. 写数据 JSON
- 文件放在输出 HTML 的同一目录,命名为 `<名称>.data.json`,保留下来,方便以后修改。
- 字段说明见 [references/data-schema.md](references/data-schema.md),坐标和走线的写法见 [referen