1. 基本信息
项目自述名称:所在仓库自述为「Chart Visualization Skills」(AntV 官方出品的可视化技能合集,slogan“Turning data into a visual language for better thinking”);本技能自身 SKILL.md 标题为「G6 v5 图可视化代码生成技能」。
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | antv-g6-graph-antvis-chart-visualization-skills | — |
| 作者/维护者 | AntV Visualization Team(Ant Group 官方团队,联系邮箱 pub_antv@antgroup.com;具名贡献者 lxfu1) | GitHub API(commits)+ LICENSE 文件 |
| 来源链接 | https://github.com/antvis/chart-visualization-skills/tree/master/skills/antv-g6-graph | — |
| 许可证 | MIT(Copyright (c) 2025 AntV Visualization Team) | GitHub API + LICENSE 文件 |
| GitHub Stars / Forks | 所属仓库 449★ / 36 forks(该数字属整个 chart-visualization-skills 合集,不代表本技能个体热度;本技能子目录自身自 2026-04 起有独立提交记录) | GitHub API |
| 最新版本 | npm 包 @antv/chart-visualization-skills v0.1.3(无独立 Release/Tag) |
package.json |
| 安装方式 | Claude Code 插件市场,或 npx skills add 跨 Agent 安装(见第 10 章) |
仓库 README + marketplace.json |
2. 功能介绍与亮点
antv-g6-graph 是 AntV(蚂蚁集团自 2017 年起开源的数据可视化技术体系,图形语法理论驱动 G2/G6/S2/X6 等多条产品线)官方为 AI 编程助手打造的 G6 v5 图可视化代码生成技能,教会 agent 按 G6 v5 的新版 API 直接写出可运行的网络图、树形图、流程图代码,而非沿用已废弃的 v4 写法。
核心亮点:
- 覆盖关系型数据可视化全场景:内置网络图/关系图、层次流程图、树形图、环形图、网格图、辐射布局等图类型选择指南,配套 16 种布局算法(力导向、Dagre 分层、环形、辐射等)、10 种内置节点形状、7 种边类型、15 种交互行为与 17 种插件(小地图、图例、时间轴、鱼眼、边捆绑等)。
- 强约束防幻觉:SKILL.md 开篇即列出 v5 与 v4 的关键差异(如移除 Mode 概念、
nodeStrength必须非负、extend已废弃改用register),并针对“自定义节点渲染白屏”“autoFit配合异步布局导致包围盒为零”等具体运行时错误给出图文并茂的错误示范与修法。 - 参考文档体系完整:除主 SKILL.md 外另有 11 个分主题参考子目录(核心概念、布局、元素、状态、主题、转换、插件、交互行为等),总计 51 个 Markdown 文件、约 331KB,逐一覆盖细分配置项。
- 维护有迹可循:该子目录自 2026 年 4 月至 5 月末有 3 次独立提交(新增技能、补充描述、更新内容),仓库整体最近一次推送为 2026-07-29;仓库声明“仅合并 AI 生成的代码”,贡献流程为提交 issue 后指派给 Copilot 生成、再由具名维护者审核合并,并接入 CI 检查(skills-check)。
3. 适用场景
固定分类:数据分析与可视化。
面向需要用 AntV G6 v5 库做关系型/图结构数据可视化开发、但不想在 v4→v5 API 迁移与图算法细节上反复试错的场景:社交网络与知识图谱展示、组织架构与工作流图、文件树与思维导图、数据血缘分析、以及任何要求“图代码规范可运行、布局算法选型准确”的产品前端工作。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持,README 给出
/plugin marketplace add antvis/chart-visualization-skills与逐个技能安装的命令,且该技能已在仓库marketplace.json的 plugins 清单中正式登记。 - Codex:⚠️ 需适配/理论兼容——README 另提供
npx skills add声称可“为你的多个 agent”安装,但未点名 Codex;SKILL.md 本身是纯 Markdown 指令,不含 Claude 专属语法,理论上可手动放入对应技能目录使用。 - OpenClaw:❓ 未验证,已抓取材料未提及。
- Hermes Agent:❓ 未验证,已抓取材料未提及。
(结论均基于已抓取的 README、marketplace.json 与 SKILL.md,未为兼容性单独发起搜索。)
5. 推荐理由
由 AntV 官方团队维护,把 G6 v5 从图类型选型到布局算法、节点/边样式、交互、插件的全部细节固化成强约束 + 51 篇参考文档,尤其针对“白屏”“ReferenceError”等常见运行时故障给出具体成因与修法,能显著降低大模型生成图可视化代码时踩 v4→v5 迁移坑的概率。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 所属仓库为合集仓库,其 449★ 不计入本技能个体热度;本技能子目录自身有独立提交记录,且背靠 Ant Group 官方账号,但尚未检索到独立第三方平台的具名讨论 |
| 可用性 | 9 | 一条命令即可通过插件市场或 npx skills add 安装(已在 marketplace.json 正式登记);SKILL.md 正文详尽 + 11 个分主题参考子目录共 51 个文件,覆盖图类型/布局/节点/边/状态/主题/交互/插件全部细节;近 3 个月内子目录本身有独立提交;无需任何付费依赖 |
| 安全性 | 9 | 全部 51 个文件均为纯 Markdown 指令与参考文档,人工核对未发现任何 shell 命令、网络请求、凭据要求或可疑指令;License 明确为 MIT,作者为具名官方团队 |
安全检查清单:
- ① 是否执行 shell 命令及权限范围:否,技能仅输出代码文本,不执行任何命令
- ② 运行时是否联网外发数据:否,纯本地文本生成,无网络调用
- ③ 是否要求 API key/凭据:否
- ④ SKILL.md 与附带文档中有无可疑指令:未发现任何 prompt injection 迹象或混淆内容
- ⑤ 作者/组织信誉:Ant Group 官方团队(AntV Visualization Team),具名维护者可查
- ⑥ License 是否明确:明确,MIT
- ⑦ 最近维护时间:仓库整体 2026-07-29 有推送,本技能子目录 2026-05-22 有独立提交,均在近 3 个月内
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 antv-g6-graph 的差异 |
|---|---|---|
| antv-x6-editor(同仓库姊妹技能) | X6 图编辑引擎代码生成,面向流程图/DAG/ER图/血缘图的可交互编辑场景 | X6 侧重“可编辑画布”——拖拽、框选、撤销重做、导出 PNG/SVG 等编辑器级交互;antv-g6-graph 侧重“算法驱动的关系型数据布局”——力导向、Dagre 分层、辐射等自动布局算法,产出偏展示型而非可编辑画布,适合数据量较大、需要算法自动排布而非手工摆放的图 |
| antv-g2-chart(同仓库姊妹技能) | G2 v5 统计图表代码生成,覆盖柱状/折线/散点等 30+ 图表类型 | G2 面向分类/数值型统计数据(“有几个类别、各类别数值多少”),产出是坐标系图表;antv-g6-graph 面向关系型/图结构数据(“节点之间如何连接”),产出是网络图/树图,两者数据形态与图表语汇完全不同 |
| Agents365-ai/drawio-skill | 通过自然语言生成 draw.io 格式图表,覆盖 UML、网络拓扑等 11 种预设模板,可导出 PNG/SVG/PDF | 产出是可在 draw.io 工具中打开的静态图表文件,面向文档与演示场景;antv-g6-graph 产出的是要接入前端项目、可交互(拖拽/缩放/悬停高亮)的 JavaScript 源代码,面向需要把图可视化嵌入实际 Web 应用的开发者 |
8. 用户评价
该技能目前在第三方平台尚无独立具名用户评价;已发现的第三方技能市场收录条目为自动生成的镜像列表,不包含真实用户评论内容。
9. 其他补充
仓库贡献流程较为特殊:维护团队声明“仅合并 AI 生成的代码”,具体做法是先提交 issue 描述需求,再指派给 GitHub Copilot 生成代码,最终由具名维护者审核合并,并接入 CI 检查(skills-check)作为质量门禁。仓库同名 npm 包 @antv/chart-visualization-skills 另提供一个可选的 antv CLI 工具,用于按关键词检索/列出技能内容,供需要程序化调用的场景使用。
10. 安装使用方式
方式一:Claude Code 插件市场
/plugin marketplace add antvis/chart-visualization-skills
/plugin install antv-g6-graph@visualization-skills
方式二:跨 Agent 通用安装
npx skills add antvis/chart-visualization-skills
安装后无需重启,在对话中提出图可视化需求(如“帮我用 G6 画一个知识图谱网络图”)即可自动触发该技能。
11. 注意事项
- 该技能仅生成 G6 v5 版本代码,且明确禁止 v4 遗留写法(如
new G6.Graph()、Mode 概念、extend注册自定义节点),若项目仍停留在 v4 需先自行升级依赖。 - 生成的是源代码而非成品图片,使用者仍需具备将
@antv/g6包接入前端项目的基础能力。 - 力导向等异步布局配合
autoFit使用时有已知的时序陷阱(详见第 2 章),需按 SKILL.md 给出的事件监听写法处理。 - 仓库声明“仅合并 AI 生成的代码”这一贡献模式尚属少见,长期代码质量需持续观察实际 issue 处理情况。