SuperAPI AI 工具集

technical-svg-diagrams

设计与创作

查看项目

更新于 10-16 00:20

技能介绍

用途:生成简洁、极简的技术 SVG 图表,风格统一,适合架构图、流程图和组件图。

主要能力:提供固定设计系统,包括配色(背景 #fafafa、网格 #e5e5e5、主文字 #333、次要文字 #666、边框/箭头 #ccc、成功 #27ae60、错误 #e74c3c、主强调 #3498db、警告/沙箱 #f39c12、流程步骤 #9b59b6)、等宽字体、标题 14px 粗体、副标题 12px 带方括号标签、标签 10-11px。内置网格背景、箭头标记、节点、容器、虚线容器、标签框等常用元素模板。支持三类图:架构图(横向 800x350-400)、流程图(纵向 600x700+)、组件图(尺寸随内容)。

使用方式:先确定图表类型,阅读 references/svg-patterns.md 获取模板与配色,按模式生成 SVG,保存为描述性文件名(如 diagram-flow.svg),仅在需要时导出。导出 PNG 可用浏览器自动化:先运行 bun run "$SVG_SKILL_DIR/scripts/create-html.ts" --svg diagram.svg --output "$SVG_CAPTURE_DIR/diagram.html" --width 1600,再用 agent-browser 打开并截图;无浏览器时用 cairosvg:uvx --from cairosvg cairosvg diagram.svg -o diagram.png --output-width 1600,再转 WebP。也可用 ImageMagick 或 librsvg+cwebp。

适用场景:需要统一视觉风格的技术架构、流程、组件说明图。

限制:SVG 需自包含,包装器使用图片模式,脚本不执行、外部资源不可用;背景检测仅处理根样式和全画布矩形,复杂图形需显式指定背景;导出依赖已安装的运行时或工具,缺失时按资料建议改用 cairosvg。