VChart Skill 使用
VChart 和 VTable 作为 VisActor 数据可视化解决方案的核心组件,为了帮助开发者通过 AI 提升效率、降低使用门槛,VisActor 提供了开发者 skill。
与快速上手的关系
- 快速上手 介绍的是 VChart 基础安装与绘图流程。
- 本文聚焦
vchart-skill在 AI 编辑器中的使用方式,帮助你更快完成图表生成、样式调整和配置修复。 - 建议阅读顺序:先完成快速上手,再阅读本文。
简介
vchart-skill 面向支持 skills 的 AI 编辑器,核心目标是让模型 更准确理解 VChart 语义与实践路径,从而减少试错成本。支持生成可直接查看的 HTML,以及供宿主消费的完整 VChart spec。
安装与简单 Demo
1. Skill 安装
VChart 开发 skill 已发布在 GitHub:
- 仓库入口:
https://github.com/VisActor/VChart - skill 目录:
https://github.com/VisActor/VChart/tree/develop/skills/vchart-development-assistant
可使用以下任一命令安装:
npx skills add VisActor/VChart
npx skills add VisActor/VChart --skill vchart-development-assistant
安装过程示意:

2. 编辑器参考
- Trae 文档:
https://docs.trae.ai/ide/skills?_lang=zh - Cursor 文档:
https://cursor.com/cn/docs/context/skills
安装后,通常会落到项目内编辑器对应的 skills 目录(例如 .cursor/skills 或其他 .<editor>/skills 目录),请确认目录中能看到 vchart-development-assistant。
目录示意:

3. 示例一:生成简单图表
建议提示词:
使用 VChart 生成一个基础柱状图,包含 xField、yField,交付可直接打开查看的完整 HTML。
验收点:
- 能输出包含完整配置和实例创建的 HTML。
- 图表可正常渲染。
示例效果:

4. 示例二:调整图表样式
建议提示词:
在已有柱状图基础上,优化颜色、标签样式和图例可读性,保留原有数据结构。
验收点:
- 样式改动清晰可见。
- 不破坏原有图表结构与数据映射。
示例效果:

5. 示例三:修复配置问题
建议提示词:
检查当前 VChart spec 的配置错误并给出修复方案,解释每一处修复原因。
验收点:
- 明确指出错误位置。
- 给出可直接替换的修复配置。
示例效果:

HTML 与 spec 交付
| 需要什么 | 如何提出需求 | 得到什么 |
|---|---|---|
| 直接查看或页面演示 | “生成可打开的完整 HTML” | 完整页面,按需包含应用交互 |
| 宿主渲染或配置集成 | “只返回完整 spec / JSON” | 配置本身,不混入页面、实例代码或宿主外壳 |
| 两种都需要 | “给 spec 和使用它的 HTML 预览” | 同一份配置与对应页面 |
明确要求优先,其次沿用已知宿主/应用上下文;独立展示需求默认 HTML。已有 HTML 内的 spec 修改仍交付 HTML,独立 spec 修改仍交付 spec;组件和组合产物保留原目标。“加标签”默认返回修改后的完整产物,明确只要片段时才返回增量;明确“只返回 JSON”等要求时切换交付。
生成完整 JSON 的提示词:
周一 12、周二 25、周三 18、周四 32。 用合适的 VChart 图表比较这些数值,只返回完整 JSON spec,不要解释。
宿主上下文可以在前文提供:
宿主负责渲染,只接收 JSON VChart spec,支持 bar 和 line,不接受函数。 后续给数据时按这些约束生成配置。
后续只需说明表达目标与数据,不重复询问 JS/React。spec 不一定是 JSON;支持函数的环境可用 JS,纯 JSON 宿主采用声明式配置,不能通过序列化丢掉回调。tooltip/图例等声明式交互可以留在 spec 内,外部事件和业务代码单独处理。
配置会检查真实数据与字段,JSON 会检查可解析性;条件允许时实际渲染。未执行渲染或没有目标宿主环境时说明验证范围,不能把格式检查当作渲染验证。临时验收 HTML 不改变最终 spec 交付。
常见问题与注意事项
- 如果编辑器不支持 skills,需先确认当前版本是否提供该能力。
- 如果命令执行成功但效果不明显,优先检查 skill 目录是否正确写入。
- 若项目上下文不足,建议先补充图表目标、字段含义和预期输出。
- 外部链接或命令可能随版本变化,请以最新官方文档为准。