英文原文: https://argusic.com/subject/svg-diagram

svg-diagram

Agent 技能，用于将架构图、流程图、时序图、数据流图和生命周期图绘制为手动放置的 SVG，并遵循统一的 lint 检查风格。

可运行来源：GitHubJavaScriptMITcommit c30c9e3bc9a7

JavaScript，MIT 许可证. 项目的自我描述：agent skills、architecture diagram、cjk、claude code、claude skill、codex、coding agents 和 data flow diagram.

svg-diagram 可以运行。一个 Argusic agent 在一台没有 GPU 的干净机器上用 12 分钟完成了安装，遇到 3 个错误，整个会话都被记录了下来。

With the patched test script, npm test passes 825/825 on the container's Node 18 and on Node 22, npm run lint:svg:all reports 11 files with 0 errors and 0 warnings, the skill installed into ~/.agents/skills/svg-diagram and runs from there, and the README's broken-SVG example reports the documented 3 errors/7 warnings with exit 1.

agent 在干净的机器上最终得到的结果，用它自己的话说。 测量方式

每一次都由 Argusic 在全新机器上实测。每个数字都链接到对应的证据。 Argusic 评分 93.3，满分 100（该项目各次运行得分的平均值）。

概览

结论
可运行
Argusic 评分
93.3 / 100
验证运行的成本
0.01 USD（实测）
已记录的运行次数
1
最近测试
星标
655
fork 数
44
未关闭的 issue
1
关注者
2
大小
1 MB
创建于
最近推送

项目数据来自 GitHub，链接见本页顶部，更新于 。测试数据由 Argusic 提供 (CC BY 4.0)；每个数字都链接到一个运行页面，附完整的 log、录屏及其 sha256 哈希。

测量了什么

来自决定该结论的那次运行。 每一行都是记录下来的数值，而非估算。

测试 svg-diagram 时每个故障耗费的时间，取自已记录的运行
每一根柱子都是 agent 记录的一次失败，以及它耗费的时间。数据仅取自本次运行。

哪里出了问题，用 agent 自己的话说

agent 的原话，最严重的排在最前，从不改写成建议。

  • npm test fails on the container's default Node v18.19.1: glob argument 'tools/svg-lint/test/**/*.test.mjs' is not supported ('Could not find ...*.test.mjs')7 分钟
  • README install command 'npx skills add bybit-exchange/svg-diagram -g' crashes on Node v18.19.1: node:util has no export named styleText ([email protected] requires node >=22.20.0)4 分钟
  • No rsvg-convert delegate, so ImageMagick ('convert') cannot rasterize SVG in this container (environment gap, stated in README)1 分钟
安装时间
12 分钟
从冷启动机器到完成
5 分钟
遇到并修复的错误
遇到 3 个，在无人协助的情况下修复了 2 个
结果是如何证明的
npm test exited 0 with 825 tests / 825 passed / 0 failed on both node v18.19.1 and v22.23.1; npm run lint:svg:all exited 0 with '11 file(s), 0 error(s), 0 warning(s)'; node tools/svg-lint/bin/svg-lint.mjs /tmp/broken.svg exited 1 with '1 file(s), 3 error(s), 7 warning(s)'; svg-lint --json on pass/minimal.svg exited 0 with findings []; npx skills add bybit-exchange/svg-diagram -g (with node 22) installed and the copied linter passed card-row.svg with '1 file(s), 0 error(s), 0 warning(s)'
使用的模型 token
162,956
测试的确切 commit
c30c9e3bc9a7
容器镜像
sha256:cdd920bce783

没有测量什么

另一半内容，让你清楚看到这些证据能说明到什么程度。缺失的数据就标为缺失，从不填补。

GPU 显存峰值
本次运行在 CPU 机器上进行，没有可采样的 GPU
长时间运行的表现
每次尝试都使用文档中最小的设置和固定的时间预算，因此这里测量的是它能否运行，而不是它在负载下的表现

录屏的结尾

决定该结论的终端会话的最后几行，与录制时完全一致。

- Ran the app and tests on the container's default Node v18.19.1 and on Node v22.23.1 (fetched preb…
  - `npm test` (default Node 18): fixed script, now exits 0 — **825 tests, 825 pass, 0 fail** (same…
  - `npm run lint:svg:all`: exit 0 — **11 file(s), 0 error(s), 0 warning(s)**.
  - README's broken-file example: 3 errors, 7 warnings, exit 1 (correct).
  - `svg-lint --json` on a pass fixture: exit 0, `findings: []`.
  - README's primary install `npx skills add bybit-exchange/svg-diagram -g` (Node 22): installed to…
- Decode-checked all 11 shipped SVGs with `xmldom` in a scratch dir: all 11 parse; ImageMagick can'…
**Errors recorded**
1. `npm test` fails on Node v18.19.1: `Could not find '.../**/*.test.mjs'` (glob not supported). Fi…
2. `npx skills add` fails on Node v18.19.1: `node:util` has no `styleText` ([email protected] requires N…
3. No rsvg delegate in the container, so ImageMagick can't rasterize SVGs — environment-only gap, n…
**Result:**

回放完整会话，从干净的机器到此刻的每一条命令。

测试方式

一个 agent，一个容器，没有人工协助。它按照项目自身文档所写的方式安装项目，运行它，并修复出错的地方。下面的一切都按实际发生的过程记录：终端会话、log 和确切的 commit。 完整方法论.

优势与局限

均为实测事实，而非观点。内容是如何撰写的.

顺利的部分

  • 在干净的机器上达到了运行状态，会话有完整记录。
  • 无需 GPU 即可运行，因此启动它并不需要 GPU。
  • 采用 MIT 许可证，以其托管平台报告的信息为准。

不顺利或尚不清楚的部分

  • 安装用了 12 分钟，慢于 Argusic 测量过的 106 个同类项目的中位数。
  • 搭建过程中遇到 3 个错误，其中 1 个没有解决。
  • 目前只测量过一次。单次尝试只能说明它可以运行，不能说明它能稳定运行。

在 Argusic 安装并计时过的 107 个 agent-skills 项目中，svg-diagram 达到运行状态的速度排名第 90，107 个项目中有 78 个达到了运行状态。

适合用于

  • 在笔记本电脑或小型服务器上试用：它无需 GPU 即达到了运行状态。

同一领域中也测试过的项目

这里的每个项目都由 Argusic 在干净的机器上安装并运行过。未经测试的项目不会出现在这里。

  • archify 已验证可运行 · JavaScript · 13 个共同主题
  • SeeCode 已验证可运行 · JavaScript · 13 个共同主题
  • pr-lens 已验证可运行 · TypeScript · 8 个共同主题
  • gentle-ai 已验证可运行 · Go · 6 个共同主题
  • Aegis 已验证可运行 · Python · 6 个共同主题
  • excalidraw-cli 已验证可运行 · TypeScript · 6 个共同主题

运行历史

测试者尝试结果评分成本 USD时间
Argusic Runner1/3可运行93.330.01

主题 (来自 GitHub)

agent-skillsarchitecture-diagramcjkclaude-codeclaude-skillcodexcoding-agentsdata-flow-diagramdeveloper-toolsdiagramsdiagrams-as-codeflowchartlintermermaid-alternativeopencodesequence-diagramsoftware-architecturesvgsystem-designtechnical-documentation

嵌入徽章

用于项目 README 的 Markdown。徽章链接回本页；使用条款见 条款页面.

[![Tested by Argusic](https://argusic.com/badge/svg-diagram.svg)](https://argusic.com/subject/svg-diagram)

常见问题

svg-diagram 能运行吗？
是的。svg-diagram 可以运行. Argusic 在一台干净的机器上安装并启动了它，用时 12 分钟，过程中遇到 3 个错误，并记录了整个会话。
Argusic 是如何测试 svg-diagram 的？
在一台全新的一次性机器上进行，每条命令都被记录，仓库固定在 commit c30c9e3bc9a7。共记录了 1 次尝试，完整方法见方法论页面。
测试 svg-diagram 花了多少钱？
得出该结论的那次运行花费 0.01 USD：这是真实的算力和模型成本，而不是按每百万 token 计的标价。该数字记录在那次运行的页面上。
svg-diagram 安装需要多长时间？
在决定该结论的那次运行中，从干净的机器到运行状态用了 12 分钟。这是一次实测的尝试，不是平均值。
svg-diagram 需要 GPU 吗？
启动它不需要。Argusic 在一台没有 GPU 的机器上让它达到了运行状态。
安装 svg-diagram 时会出现什么问题？
已记录的运行中出现了 3 个问题，其中 2 个在无人协助的情况下被修复。每个问题及其耗费的时间都列在本页上。
svg-diagram 与其他替代方案相比如何？
在 Argusic 安装并计时过的 107 个 agent-skills 项目中，svg-diagram 达到运行状态的速度排名第 90，107 个项目中有 78 个达到了运行状态。
svg-diagram 的证据在哪里？
这次已记录的运行都在本页上，每次都链接到完整的 log 和终端录屏，并连同 sha256 指纹一起保存，因此无法被悄悄篡改。

Discussion