用途:该技能用于产出可手工编辑的 SVG 技术信息图,覆盖架构栈、从左到右流程、并排对比、层级树四类原型,输出为单个静态图片,不含动画、脚本或外部资源。定位上是对 mermaid 管线的补充而非替代:若图表嵌在 markdown 中、变化频繁、属标准类型或需多语言同步,继续用 mermaid;只有在需要图片文件、自由形态架构图、像素级控制或 CJK 标签精确换行时才选此技能。同一图表只保留一处来源,不与 mermaid 双份维护。
主要能力与流程:分六步,前三步在写任何 SVG 元素前完成——确定信息与四个输出参数(format、size、detail、audience,各有默认值)、选原型、做数值布局计算并逐行通过包含与文本预算检查;然后依据坐标表编写 SVG、用脚本静态检查、渲染并校验 PNG。文本预算以 CJK 优先字体栈为前提,CJK 每行容量约为同宽 Latin 的 60%,禁止事后截断或只对某语言缩小字号;可访问性契约要求根节点带 role="img"、aria-labelledby、首个子元素 title 和 desc,并有唯一 ID 前缀。
使用方式:可用以下命令检查与渲染: node ${CLAUDE_SKILL_DIR}/scripts/check-svg.mjs diagram.svg(加 --json 输出机器可读结果,--strict 让警告也失败) node ${CLAUDE_SKILL_DIR}/scripts/render.mjs diagram.svg --out diagram.png(默认 2 倍,可用 --scale 调整) 脚本仅依赖 Node 18 标准库,无需安装依赖,也不捆绑浏览器。
限制:安装、发现与编写可编辑 SVG 始终可用;静态检查与渲染需要 Node 18+ 与无头 Chromium 系浏览器,缺少浏览器时只交付 SVG 并明确说明未生成 PNG,不得编造尺寸、浏览器版本或检查结论。渲染以 viewBox 乘缩放倍数为目标并读取 PNG 头部校验,尺寸不符即失败。