SkillsScout
DATA-ANALYSIS / 数据分析与可视化

reladraw

收录日期 2026-09-28·来源仓库 ↗
受欢迎程度
6
可用程度与相关性
8
安全性
8
7.3SCOUT SCORE

1. 基本信息

项目 内容
名称 reladraw(项目自述名称同为 reladraw)
作者/维护者 reladraw 组织(作者署名 Joe Walsh,个人项目)
来源链接 https://github.com/reladraw/reladraw
许可证 Apache-2.0(NOTICE 声明许可不含 “reladraw” 名称与标志的商标权)
GitHub Stars 784(GitHub API)
Forks 14(GitHub API)
最新版本 v0.9.0(2026-09-27 发布,npm 同步发布;语法尚未稳定)
安装方式 npx skills add reladraw/reladraw -g;配套渲染命令 npm install -g reladraw(或直接 npx reladraw),需 Node ≥ 18

数据来源:仓库指标、发布信息、Issue 来自 GitHub API;npm 下载量来自 npm 公开接口(近 7 天 471 次);社区讨论来自 Hacker News 公开接口。

2. 功能介绍与亮点

这个 skill 教会 agent 用 reladraw 文本图语言画节点连线图(架构图、数据流、部署图、目录结构、PR 改动示意),输出独立 SVG。核心思路是把“东西放哪”写成人话:right of api、between web and worker、level with queue,由工具只计算间距。

3. 适用场景

所属分类:数据分析与可视化(示意图/架构图生成)。

4. 跨 Agent 兼容性

Agent 结论 依据
Claude Code 原生支持 技能目录为 .claude/skills/reladraw/,npx skills add 支持 claude-code 目标
Codex 需适配 README 称同一命令可装入 Codex;安装器的 Codex 目标为 .agents/skills/,自动发现行为未实测
OpenClaw 未验证 安装器列有 OpenClaw 目标目录(~/.openclaw/skills/),SKILL.md 为标准格式,未实测
Hermes Agent 未验证 安装器列有 .hermes/skills/ 目标目录,未实测

所有平台都要求本机可运行 Node(≥ 18)来执行 reladraw 渲染命令。

5. 推荐理由

6. 评分

维度 分数 说明
受欢迎程度 6 建仓约三周即达 784 stars;Show HN 帖获 387 分、113 条评论;npm 周下载 471;项目仍在早期
可用性 8 两条命令即可用,SKILL.md 与语法参考完整,含示例与常见错误清单,发布节奏密集;扣分点是语法未稳定(v0.9.0)且已知缺陷在参考文档中列明
安全性 8 纯本地渲染、无网络外联、无密钥;代码可审计、零运行时依赖;License 明确;作者为新建组织的个人开发者

综合 = 三项均值 7.33。

安全检查清单:

  1. shell 命令与权限:技能仅让 agent 运行 reladraw 命令(可用 npx 临时执行),读取 .reladraw 文件并写出 SVG;无其他 shell 权限要求。
  2. 联网外发:已检查发布包,渲染代码中无网络请求与子进程调用;运行时不外联。
  3. 凭据:不需要任何 API key 或凭据。
  4. 可疑指令:SKILL.md 与语法文档通读,未发现夹带推广、越权或注入迹象。
  5. 作者/组织信誉:组织与仓库均为近三周新建,作者公开署名并在 HN 帖中持续答复用户、及时修复反馈的缺陷;fork 账号多为长期活跃老账号。
  6. License:Apache-2.0。
  7. 维护:最近一次推送在 2026-09-27,近一天内连续发布多个版本。

7. 跟同类 Skills 相比的优势

工具 定位 与 reladraw 的差异
Mermaid 声明节点与连接,由引擎自动布局 复杂流程图时落点不可控;reladraw 由作者用相对位置决定排布
Graphviz / D2 同为自动布局的图语言 同上,布局是输出而非输入
draw.io / Excalidraw 图形界面绝对定位,表达力强 人手拖拽费时,agent 改冗长 XML 易出错;reladraw 用简短文本表达同类排布
Pikchr 类“海龟绘图”,光标依次画形状 靠绘制顺序推位置;reladraw 直接声明元素之间的相对关系,容器加子元素无需调整
TikZ(LaTeX) 相对定位库,功能强大 需要 LaTeX 环境,边的处理较繁琐;reladraw 专注框、分组、箭头,无需 LaTeX

核心差异:在“自动布局”与“绝对坐标”之间取中间路线——保留文本语言的简洁,同时让排布完全由作者掌控。代价是需要学一套新语法,且暂不做绕障自动布线。

8. 用户评价

9. 其他补充

10. 安装使用方式

# 安装 skill(所有已检测到的 agent;去掉 -g 则仅装到当前项目)
npx skills add reladraw/reladraw -g
# 只装给某个 agent
npx skills add reladraw/reladraw -g -a claude-code
# 渲染命令(二选一)
npm install -g reladraw
npx reladraw diagram.reladraw -o diagram.svg

安装后无需重启,对 agent 说“画一张架构图”或提及 reladraw 即可触发。

11. 注意事项