用途:该技能用于创建技术图表,核心理念是“先可理解,再美观”。图表存在的意义是传达信息,若无法传达,美学无关紧要;两者可兼得时则兼顾。
主要能力:提供视觉设计原则参考(格式塔原则、网格系统、间距规则、配色、排版、复杂度预算、反模式、Tufte 数据墨水原则);Excalidraw 格式参考(JSON schema、元素类型、样式属性、箭头绑定、布局模板如线性、网格、放射、分层、决策树,以及图表类型约定);Mermaid 语法参考(流程图、时序图、类图、状态图、ER 图语法、主题、逐节点样式、子图)。
格式选择:图表位于 markdown(README、设计文档、PR 描述、wiki)、可接受自动布局、类型映射到 Mermaid 支持类型、重视版本控制可读性(文本 diff)、迭代速度优先于视觉打磨时用 Mermaid;需要精确空间布局、自由形式元素、视觉打磨(配色、一致间距、专业外观)、用于演示或外部文档或设计评审、生成后需手动编辑时用 Excalidraw。
核心设计规则:同一概念类型全程使用相同形状;同一类型关系保持统一流向;颜色编码语义(层级、状态、领域)而非装饰,最多 2–3 种强调色;不明显处均加标签;空白即结构,组内紧凑、组间间距为组内 2 倍;超过 20 个元素则拆分。
空间推理策略:Excalidraw 从布局模板开始,坐标取 50 的倍数,水平间距 250px、垂直 150px,先计数再系统分配坐标,从锚点向外扩展并检查重叠;Mermaid 交由引擎布局,用子图分组,标签简短,选对方向,避免用小写 end 作节点 ID。
图表类型指导:流程图以终止形状起止、决策用菱形并标注出边、单一流向、3–10 步为宜最多 15;架构图用框架或子图分组、按层级配色、连接标注协议与数据格式、3 种以上颜色或形状约定时加图例、明确系统边界;时序图参与者按首次交互从左到右、短别名、必要时编号消息、用激活框表示处理时长、3–6 参与者与 10–15 消息;ER 图含主外键、关系标注动词与基数、网格布局、按域分组;思维导图中心主题、最多 4–6 主分支、放射布局、按主题配色、子主题挂到分支。
Excalidraw 默认值:roughness 0、fillStyle solid、strokeWidth 2、fontFamily 5、fontSize 20(标题 28、描述 16)、roundness type 3、背景 #ffffff。
输出约定:用描述性文件名保存或内联 Mermaid;一句话说明图表范围与元素数;提供查看说明(excalidraw.com 拖放、VS Code Excalidraw 扩展、Obsidian Excalidraw 插件);复杂时提议拆分。
质量门:元素 ID 唯一、无重叠、文本最小 14px 且适配容器、颜色遵循语义调色板、不明显关系加箭头标签、流向一致、元素数在预算内(≤20 或提议拆分)、3 类以上编码时提供图例。
限制:资料未提供具体安装命令、收费或平台信息;该技能依赖 Mermaid 与 Excalidraw 生态,Excalidraw 需手动编辑时须借助相应工具打开。