DBX Studio 数据可视化技能 Skill 技能

技能简介

DBX Studio 数据可视化（Data Visualization for DBX Studio）是一款与 DBX Studio 深度配合的 Agent 技能，目标是让团队"从数据库问题直接生成清晰图表"，免去手动搭图的繁琐。它负责把用户意图映射为合适的图表，给出 SQL 查询模式，并配置 generate_chart 工具的调用参数，形成从取数到出图的闭环。

核心能力

• 意图到图表映射：将用户需求对应到柱状图、折线图、饼图、散点图、面积图或直方图。
• generate_chart 参数配置：提供图表类型、标题、坐标轴、数据查询、分组等配置字段说明。
• SQL 模式库：覆盖 Top 类别、时间序列、占比拆解等常用查询写法。
• 标签规范引导：鼓励使用描述性标题与人类可读的坐标轴名称，避免暴露原始字段名。
• 大数据量聚合建议：对结果集过大时推荐先聚合，并将饼图切片限制在 7 个以内。
• 查询与图表一体化：把 SQL 取数与图表配置串联，减少手工切换环节。

安装配置

• 通过 Skillstore 安装：npx skillstore add dbxstudio/data-visualization
• 支持的宿主工具：Claude、Codex、Claude Code。
• 前提依赖：需已部署 DBX Studio 及其 generate_chart 工具，否则无法生成最终图表。
• 需要用户或项目提供准确的数据库 schema 名称。
• 来源仓库为 github.com/Dbxstudio/dbx-studio，采用 MIT 许可证。

使用步骤

1. 提出数据问题：说明要分析的业务问题，例如"按状态统计订单量"。
2. 选择图表类型：让技能推荐最合适的图形，并给出 SQL 查询模式。
3. 配置图表参数：根据 generate_chart 字段，确定 chart_type、title、x_axis、y_axis、grouping 等。
4. 执行并出图：在 DBX Studio 中运行查询并生成图表。
5. 检查与优化：核对标题、坐标轴可读性，确认大数据量已聚合、饼图切片不超过 7 个。

适用场景

• 收入类别分析：用柱状图对比各产品类别的收入，基于分组后的 SQL 结果。
• 产品趋势追踪：从时间维度的订单数据，构建展示每日或每月变化的折线图。
• 运营状态复盘：借助饼图或直方图，汇总状态计数、分布或工作量模式。
• 数据库问答可视化：在 DBX Studio 中直接由自然语言问题走向可交付图表。

适用人群

使用 DBX Studio 的数据分析师、数据库工程师、需要快速出图的业务人员，以及在数据库环境中做数据探索的开发者。

工作原理

该技能在智能体上下文中注入图表选择规则、SQL 查询范例与 generate_chart 配置说明。智能体据此把自然语言问题解析为"查询 + 图表配置"的组合，交由 DBX Studio 执行，从而实现从提问到出图的自动化。技能本身不做权限校验、不验证数据库凭证，也不提供超出基础图表选择的高级统计分析。

官方链接

• 技能主页：https://skillstore.io/skills/dbxstudio-data-visualization
• 来源仓库：https://github.com/Dbxstudio/dbx-studio