SVG 图示制作规范(svgbuilder)
本 skill 让 Claude 产出“经得起像素级检查”的 SVG 图示,并能按同一套规范评审/修复已有图。完整规则(第一~八章、35 条规则、复核清单、案例协议)在 references/规范全文.md,是所有数值决策的唯一依据。
何时使用
满足任意一条即启用:
- 绘制 / 生成 SVG 流程图、架构图、闭环(循环 / PDCA)图、维恩图、对照表/参数表
- 修复或评审已有 SVG 的对齐、对称、连线走向、箭头、配色一致性或文字排版问题
- 要求“按规范检查 / 体检这张图”
工作流(按序执行,不要跳步)
动笔前先完整读一遍 references/规范全文.md——规则会在生成和自检全程反复用到,凭记忆容易漏掉高频项。然后:
- 生成前规划(规范第一章)
- 先问用户偏好深色还是浅色主题,从 1.1 主题表取对应色值。
- 确认图示类型,按 1.2 对应约定建立坐标系:先定 viewBox、主元素中心坐标、间距。
- 维恩图特别注意“先算标签宽再定圆心距”;表格图先定列宽与行高。
- 生成 SVG(规范第二~六章,共 35 条规则)
- 结构与空间(二):不重叠、对称、均匀分布、画布中心线对齐、文本框留白最小化。
- 视觉表达(三):颜色链一致、分割线可见、文字居中、标题层级递减、短句尽量单行。
- 连接线与箭头(四):直角折线、最简弯折、平行线间距、决策分支共源 T 型、连线容纳文字、label 沿线居中且偏置到线一侧不压线、箭头不缺失/出发点对称、箭头尖端紧贴目标框边(终点取框边坐标,间隙 1~3 px;切勿为留箭头长度把到达端往回缩)。
- 代码(五):开放路径 fill="none"、同类框 stroke-width 统一、带头部色块的面板描边最后绘制。
- 表格(六):网格清晰、列等宽、单元格居中、表头/角单元格(如"对比维度")字号高于数据单元格。
- 生成后三轮复核(规范第七章)
- 严格逐项过三轮清单;标 ⚠️ 的高频漏报项必须动手算坐标验证(多行行距、Venn 标签宽与区域标签居中、出发点对称、中心线对齐、连线容纳文字、箭头紧贴目标框、label 不压线、表头字号层级)。
- 任一项不过就回到对应规则修正,全部通过方可交付。
- 评审场景:直接用三轮清单逐条核对用户给的 SVG,列出违规项与对应 Rule 编号及修正建议。
- 案例积累与规则进化(规范第八章)
- 当用户纠正了视觉问题、要求重来、或自检中捕获并修正了违规时,按案例协议在 references/规范全文.md 第八章 CASE_LOG 区追加案例条目。
- 同一根因出现 ≥ 2 次且现有规则未覆盖时,按写回步骤提炼为新规则(用「章-序号」编号),追加到对应章节并在复核清单加一条。
输出约定
- 默认输出可直接渲染的完整 代码;除非用户另有要求,写成单文件、内联样式。
- 颜色、字号、间距等基准值一律取自规范第一章,不凭空另设;如需偏离,须全局一致并说明理由。
- 交付前在回复里简述自检结论(哪几轮、重点核算了哪些高频项)。
规则索引(速查,细节见 references/规范全文.md)
| 章 | 范围 | 规则号 |
|---|
| --- | --- | --- |
| 二 结构与空间 | 不重叠/对称/分布/中心线/留白 | 2-1 ~ 2-7 |
| 三 视觉表达 | 颜色系统 + 文字排版 | 3.1-1 ~ 3.2-6 |
| 四 连接线与箭头 | 走线 + 箭头 | 4.1-1 ~ 4.2-7 |
| 五 SVG 代码规范 | fill/线宽/描边层序 | 5-1 ~ 5-3 |
| 六 表格图示 | 网格/列宽/居中 | 6-1 |
| 七 复核清单 | 三轮自检 | — |
| 八 案例协议 | 自动积累 + 规则进化 | — |