给 AI 一段 JSON,还你一张出版级架构图!这个 Skill 让我告别了 Visio

还在用 Visio 或者在线绘图工具画系统架构图?每次改一个节点的名字都要拖半天,导出 SVG 还要付费?最近我在 GitHub 上发现了一个让我眼前一亮的小工具——figure-spec,一个把「JSON 结构化描述」变成「出版级 SVG 矢量图」的 Skill

一句话定位

AI 一段 JSON,它给你一张可以无限编辑的矢量架构图——而且完全本地运行,不需要任何 API Key。

它解决什么问题

画系统架构图最烦的不是画,而是改。节点一多,手动对齐累死人;导出 PNG 清晰度又不够;和别人协作还要传文件、装软件。
figure-spec 的思路很直接:用 JSON 描述图的结构,Python 渲染器负责把它变成 SVG

输出的 SVG 是纯文本,你可以直接用代码编辑器改文字、换颜色、调位置,完全不需要设计师软件。而且——同一份 JSON,永远输出同一张图,适合放进 Git 做版本管理,diff 也能看出改动点。

使用方式

安装只需要一行:

npx skills add https://github.com/wanshuiyin/Auto-claude-code-research-in-sleep --skill figure-spec

然后用 Claude Code 描述你想要什么图,比如「一个三层架构,包含 API Gateway、三个微服务和数据库」,AI 会自动生成 FigureSpec JSON,再用渲染器输出 SVG。

核心命令:

python3 tools/figure_renderer.py render --output output.svg
python3 tools/figure_renderer.py validate  # 检查 JSON 是否合法

支持哪些图类型

  • 分层架构图(Layered Architecture)
  • 中心辐射式拓扑图(Hub-and-Spoke)
  • 多平面架构(Multi-plane)
  • Pipeline / 工作流图
  • 审计级联图(Audit Cascade)
  • 系统拓扑图

为什么值得试试

三个点很戳我:

全本地,不需要网络——公司内网也能用,不用担心数据外传
确定性输出——写进 CI/CD,每次构建自动生成最新架构图,文档和代码永远同步
支持中文标签——多语言项目友好,CJK 字符宽度估计算法是专门调过的

GitHub 信息

⭐ 13k+ Stars | MIT License | Python
Repo: wanshuiyin/Auto-claude-code-research-in-sleep
Skill 路径: skills/figure-spec/


GitHub: https://github.com/wanshuiyin/Auto-claude-code-research-in-sleep

评论区

0 条评论

登录后可评论。

赵一凡 14 阅读