Agent Skills
返回列表
🎨

HTML 关系图解

设计多媒体 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/plannotator-effective-html-html-diagram。

技能介绍

问题从哪来

架构评审、故障复盘或方案对齐时,纯文字往往不足以让读者在同一屏内抓住组件连线、时序顺序或分支条件。强行把所有主题画成同一种 SVG 方框加箭头,反而增加认知负担。

技能在做什么

本技能要求先明确读者要回答的问题,再选用合适的图解形式:topology 表组件与连接,sequence 表有序消息,process 表步骤与分支,state 表状态迁移,hierarchy、timeline、matrix 或偏数量的视图按信息类型选取。渲染上按规模与信息类型在 HTML/CSS、SVG、Canvas 或 WebGL 之间选择,而不是默认 SVG。交付物是单个自包含 HTML 文件,内联必要 CSS 与 JavaScript,无构建步骤、不依赖外部服务;标签、分组、方向与连线在加交互之前就要可读,节点位置在需要对比状态时应保持稳定。若存在 design-artifact,需据此对齐版式与视觉层级,但关系语义与标注清晰度优先于装饰。构建后需在宽屏与窄屏下检查标签重叠、裁切、阅读顺序、键盘可达性与各交互状态。

边界与注意点

交互(筛选、路径追踪、平移缩放、动画)仅在有助于回答问题且符合 prefers-reduced-motion 时加入;图例只在记号不自解释时使用。技能不替代完整前端工程或设计系统,重点是用最小视觉模型把关系讲清楚,并回报所选图解形式、主要简化与假设。

使用场景

  • 微服务拆分评审前,需用拓扑图展示服务依赖与调用边界,供非后端同学快速对齐
  • 线上事故复盘会上,用时序图还原请求链路先后,替代冗长聊天记录口述
  • 发布流程改造讨论中,用流程图标出审批分支与交接点,避免遗漏异常路径
  • 状态机驱动的业务规则说明,需画状态迁移图并可在窄屏下仍可读标签

适合人员

  • 负责写 RFC 或设计说明的后端工程师,需要把组件关系画进评审材料而非只贴文字
  • 做 SRE 或值班的主程,复盘时要把跨系统消息顺序可视化给多方一起核对
  • 产品技术文档作者,要在单页 HTML 里交付可离线打开的交互式结构图
  • 带新人的 Tech Lead,用层次或矩阵图说明模块归属与重复依赖模式