1. 基本信息
项目自述名称:所在仓库自述为「Chart Visualization Skills」(AntV 官方出品的可视化技能合集,slogan“Turning data into a visual language for better thinking”);本技能自身 SKILL.md 标题为「G2 v5 Chart Code Generator」。
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | antv-g2-chart-antvis-chart-visualization-skills | — |
| 作者/维护者 | AntV Visualization Team(Ant Group 官方团队,联系邮箱 pub_antv@antgroup.com;具名贡献者 lxfu1、hustcc、GaoFuhong) | GitHub API(contributors)+ LICENSE 文件 |
| 来源链接 | https://github.com/antvis/chart-visualization-skills/tree/master/skills/antv-g2-chart | — |
| 许可证 | MIT(Copyright (c) 2025 AntV Visualization Team) | GitHub API + LICENSE 文件 |
| GitHub Stars / Forks | 所属仓库 448★ / 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 |
2. 功能介绍与亮点
antv-g2-chart 是 AntV(蚂蚁集团自 2017 年起开源的数据可视化技术体系,以图形语法理论驱动 G2/G6/S2/X6 等多条产品线)官方为 AI 编程助手打造的 G2 v5 图表代码生成技能,教会 agent 按 G2 v5 Spec Mode 规范直接写出可运行的图表代码,而非依赖模型自行拼凑或调用外部渲染服务。
核心亮点:
- 覆盖面广:支持柱状、折线、面积、散点、矩形树图、桑基图、弦图、词云、仪表盘等 30+ 图表类型,以及分面、多视图组合、极坐标/螺旋/鱼眼等坐标系。
- 强约束防幻觉:SKILL.md 开篇即列出“必须遵守”的核心约束(如
container必填、只能用 Spec Mode、禁止 v4 链式 API、禁止引用 d3),并配 150+ 篇独立参考文档逐一覆盖标记、比例尺、变换、交互、主题、动画等细分主题。 - 有实测数据支撑:仓库 README 披露在 174 个图表生成测试用例上的评测结果,多款主流大模型配合该技能生成 G2 代码的通过率提升至 90%–98% 区间,高于对照组基线。
- 维护有迹可循:该子目录自 2026 年 4 月至 6 月末有多次独立提交,仓库整体最近一次推送为 2026-07-24;仓库声明“仅合并 AI 生成的代码”,贡献流程为提交 issue 后指派给 Copilot 生成、再由具名维护者审核合并,且接入了 CI 检查(skills-check)。
3. 适用场景
固定分类:数据分析与可视化。
面向需要用 AntV G2 v5 库做统计图表开发、但不想在 v4→v5 API 迁移与语法细节上反复试错的场景:数据看板与报表开发、BI 前端组件搭建、埋点分析可视化、以及任何要求“图表代码规范可运行、不臆造图表类型”的产品前端工作。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持,README 给出
/plugin marketplace add antvis/chart-visualization-skills与逐个技能安装的命令。 - Codex:⚠️ 需适配/理论兼容——README 另提供
npx skills add声称可“为你的多个 agent”安装,但未点名 Codex;SKILL.md 本身是纯 Markdown 指令,不含 Claude 专属语法,理论上可手动放入对应技能目录使用。 - OpenClaw:❓ 未验证,已抓取材料未提及。
- Hermes Agent:❓ 未验证,已抓取材料未提及。
(结论均基于已抓取的 README 与 SKILL.md,未为兼容性单独发起搜索。)
5. 推荐理由
由 AntV 官方团队维护,把 G2 v5 从图表选型到坐标系、交互、主题的全部细节固化成强约束 + 150 余篇参考文档,配合实测数据证明能显著降低大模型生成图表代码时的语法错误率,省去开发者反复查阅 v4→v5 迁移文档的过程。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 所属仓库为合集仓库,其 448★ 不计入本技能个体热度;本技能子目录自身有持续独立提交记录,且背靠 Ant Group 官方账号,但尚未检索到独立第三方平台的具名讨论 |
| 可用性 | 9 | 一条命令即可通过插件市场或 npx skills add 安装;SKILL.md 正文 1137 行 + 150+ 篇分主题参考文档,覆盖标记/比例尺/变换/交互/主题/动画全部细节;近 3 个月内子目录本身有多次提交;无需任何付费依赖 |
| 安全性 | 9 | 纯 Markdown 指令与参考文档,人工核对全文未发现任何 shell 命令、网络请求、凭据要求或可疑指令;License 明确为 MIT,作者为具名官方团队 |
安全检查清单:
- ① 是否执行 shell 命令及权限范围:否,技能仅输出代码文本,不执行任何命令
- ② 运行时是否联网外发数据:否,纯本地文本生成,无网络调用
- ③ 是否要求 API key/凭据:否
- ④ SKILL.md 与附带文档中有无可疑指令:未发现任何 prompt injection 迹象或混淆内容
- ⑤ 作者/组织信誉:Ant Group 官方团队(AntV Visualization Team),具名维护者可查
- ⑥ License 是否明确:明确,MIT
- ⑦ 最近维护时间:仓库整体 2026-07-24 有推送,本技能子目录 2026-06-26 有独立提交,均在近 3 个月内
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 antv-g2-chart 的差异 |
|---|---|---|
| chart-visualization(同仓库姊妹技能) | 通过 curl 调用 AntV 托管 API,直接生成图表图片,覆盖 26+ 图表类型 | 面向“要一张图”的场景,产出是图片而非源码;antv-g2-chart 产出可编辑、可集成进项目的 G2 v5 源代码,适合需要在自己应用里渲染交互式图表的开发者 |
| lieflat-charts | 模板驱动的单色编辑风格图表生成,目标用户是非程序员,产出为双击可用的单文件 HTML | 定位面向写作者/新媒体运营做长文配图与周报看板,强调“编辑质感”而非图表库能力;antv-g2-chart 面向前端/数据可视化开发者,产出的是要接入现有 G2 v5 项目的规范代码,两者受众与产出形态完全不同 |
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-g2-chart@visualization-skills
方式二:跨 Agent 通用安装
npx skills add antvis/chart-visualization-skills
安装后无需重启,在对话中提出图表生成需求(如“帮我用 G2 画一个柱状图”)即可自动触发该技能。
11. 注意事项
- 该技能仅生成 G2 v5 版本代码,且强制使用 Spec Mode(
chart.options()),不兼容 G2 v4 链式 API 写法,若项目仍停留在 v4 需先自行升级依赖。 - 生成的是源代码而非成品图片,使用者仍需具备将
@antv/g2包接入前端项目的基础能力。 - 仓库声明“仅合并 AI 生成的代码”这一贡献模式尚属少见,长期代码质量需持续观察实际issue处理情况。