老鬼看这类 Agent Skill，第一眼一般不看宣传词，先翻它到底有没有解决实际脏活。
AI 写技术文档现在已经挺快了，架构图反而常常卡在最后一公里。Claude Code、Cursor 这类 Agent 能生成 SVG，但你真拿去放 README 或技术方案里，熟悉的几个问题就冒出来了：字挤出框、线穿过节点、暗色主题下根本看不清。
svg-diagram 的思路很直接：让 Agent 画 SVG 之前，先立一套"画图纪律"。
比如框高不拍脑袋定，而是按字号算；中文标签按字符宽度估算，避免塞进去之后才发现溢出。连线也不许乱拐，统一走曲线，箭头距目标框固定留 11 像素。
这些细节看着小，但真正写过文档的人都知道，坑基本就埋在这里。
老鬼以前看 开源项目，更关注 README 示例和报错处理，不太会被一句"智能生成架构图"打动。真正影响体验的是：第二天改了一段文字，图会不会炸？换个主题颜色还能不能看？导出的 SVG 有没有奇怪的字体问题？
svg-diagram 比较实用的一点是，它不单是给规则。
仓库还配了一个零依赖检查器，直接读取最终 SVG 文件，做 12 项检查。发现问题也不给模糊提示，而是直接指出哪里错，比如"边距 11，应为 20 到 25"。
这就有点意思了。
很多 Agent 工具的毛病是：生成阶段很聪明，验收阶段没人管。最后还得开发者自己打开 SVG，肉眼找哪条线画歪了。
啧，这种地方才真有工程味。
它还固定了字体栈，内置 Noto Sans CJK SC，准备了五组语义配色，每张图自带白色背景块，GitHub 暗色模式这种真实环境也考虑到了。
目前覆盖的图类型也比较明确：架构图、流程图、时序图、数据流、状态机。仓库里放了 10 张示例图。
不过先别急着吹。规则越细，Agent 生成自由度可能越低；复杂系统图如果需求来回变，能不能保持灵活，还得真跑几个项目再看。
但对于经常写 技术文档、维护开源 README、做方案 PPT 的开发者，这类 Skill 确实值得一试。
老鬼更想看它在真实项目里的表现——不是头一回生成得漂不漂亮，而是改到第三版、第五版之后，SVG 还能不能扛住。
安装据说就是一条命令，直接接入 Claude Code、Codex、Cursor、Gemini CLI 等 Agent 环境。
它解决的其实不是"会不会画图"，而是让 Agent 少制造一点返工。这个方向，比单纯堆生成能力更实在。
GitHub 仓库：bybit-exchange/svg-diagram | 
发表于 前天 23:04
|
查看: 18|
回复: 0
