VisActor/skills

VisActor / skills – 面向 AI 智能体的插件式“技能”

它是什么 – 一套包含三个智能体技能的集合，让支持语言模型的智能体（例如 Codex、Claude Code 或任何兼容的工具启用型智能体）能够将原始数据文件转换为可视化制品：

技能	功能	典型输出
vchart-skill	生成 VChart 图表，诊断配置问题，复制图表图像，并提供即用型 React 组件。	在浏览器中渲染交互式图表的 JavaScript/HTML。
vtable-skill	构建可排序表格、透视表和透视表图表，添加交互行为，并能发现配置错误。	用于可搜索、可排序表格或透视表的 HTML/JS。
data-storytelling	执行数据分析，设计叙事，创建滚动叙事页面和“Web-PPT”演示文稿。	自包含的 HTML 故事或基于浏览器的演示文稿（无 `.pptx` 文件）。

所有三个技能都是纯本地运行的 – 它们包含了必要的模板、脚本和参考文件。无需单独的 VisActor 服务器、API 密钥或托管服务；宿主智能体提供 LLM 模型以及运行 shell/FS 命令的能力。

如何将技能添加到你的项目中

# 选择你需要的技能
npx skills add VisActor/skills --skill vchart-skill
npx skills add VisActor/skills --skill vtable-skill
npx skills add VisActor/skills --skill data-storytelling

安装程序会询问你使用的是 Codex 还是 Claude Code，并将技能目录（包括其 SKILL.md、模板和 Python/JS 辅助脚本）复制到你智能体的技能文件夹中。

先决条件

Node ≥ 14 和 npm（用于 npx skills CLI）。
一个支持文件系统且能调用模型的智能体。
用于 VChart/VTable 的 Python 3.9+；用于 data-storytelling 的 Python 3.10+ 以及 Node.js（Python 部分仅使用标准库）。
一个可访问互联网的现代浏览器 – 生成的页面从公共 unpkg CDN 拉取 VChart/VTable、React、Monaco、VSeed、GSAP 等资源。

使用技能

安装后，只需让你的智能体使用你的数据运行该技能，例如：

“使用 VChart 比较此 CSV 中各地区和季度的销售额。给我可编辑的源码和 HTML。”

“使用 VTable 利用此文件中的每一行构建一个可排序的详细表格。”

“使用 data-storytelling 向我们的增长负责人解释此 CSV 中的留存率变化，并生成一个可共享的 HTML 故事。”

智能体将：

加载 CSV（或其他支持的文件）。
调用相应的技能脚本，创建图表/表格/故事。
返回生成的源代码（HTML/JS），并在可能的情况下提供渲染预览。

输出是可执行的 JavaScript/HTML，你可以在本地打开。仓库指出，评估浏览器不是不受信任代码的沙箱 – 在运行生成的制品之前，你应该进行审查。

开发与测试（面向贡献者）

主要开发分支是 develop。
从检出代码进行本地安装使用 npx skills add ./skills/<skill>。

测试在 Python 3.12+ 上使用 uv（一种快速包管理器）运行：

uv sync --locked
uv run pytest tests -q
uv run ruff check skills tests evals/scripts

一组浏览器冒烟测试位于 evals/smoke/ 下；它们验证每个技能是否产生了预期的视觉输出。
如需更深入的调试，你可以使用可选的 model-API harness（兼容 OpenAI 的聊天补全）来运行固定案例，而无需 Codex/Claude。这仅供维护者使用，非最终用户，且可能会产生 API 费用。

发布模型

所有三个技能共享一个仓库版本。Git 标签标记正式发布，其中包含技能说明、参考文件、模板和脚本。各个库（例如 VTable 1.26.8）版本独立，并在技能元数据中引用。

许可证

MIT – 你可以自由使用、修改和重新分发这些技能。

总结

VisActor/skills 是一个真实的、可安装的工具包，它赋予 LLM 驱动的智能体将数据文件转换为交互式图表、表格和叙事性 HTML 故事的能力，且无需任何专有后端。它旨在帮助开发人员构建需要内置数据可视化和叙事能力的 AI 智能体。