← ClaudeAtlas

interactive-diagram-htmllisted

通过交互式提问,把系统构成图、环境构成图、处理流程图、开发计划(含功能说明与里程碑)、业务流程、组织体制等整理成单文件交互式图解 HTML——点击方块在右侧看说明、拖拽平移与缩放、阶段范围开关、图下附一览表与说明卡片;需要时还能开启编辑模式,在浏览器里拖动方块、调整宽度、画连线并保存回数据文件。用户提到构成图、架构图、流程图、开发计划、路线图、泳道图、WBS、system / architecture diagram、構成図、フロー図、開発計画、ロードマップ,或想把设计、计划"做成能点开看说明的 HTML / 图"、"在页面��拖动调整布局"时都应使用,即使没有明说"交互式"。
XuGuanghaiGoogle/interactive-diagram-html · ★ 3 · Web & Frontend · score 71
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