1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | kibana-vega | 仓库文件 |
| 作者/维护者 | Elastic（elastic/agent-skills 官方仓库） |
GitHub API |
| 来源链接 | https://github.com/elastic/agent-skills/tree/main/skills/kibana/kibana-vega | — |
| 许可证 | Apache License 2.0（仓库整体） | GitHub API |
| GitHub Stars / Forks | 所属仓库 545★ / 44 forks（注：该数字属整个技能合集，不代表本技能个体热度，仅供了解所属仓库规模） | GitHub API |
| 最新版本 | SKILL.md 标注 v0.1.0 | 仓库文件 |
| 安装方式 | npx skills add elastic/agent-skills --skill kibana-vega，或 Claude Code / GitHub Copilot 插件市场安装 kibana 技能组 |
仓库文档 |
2. 功能介绍与亮点
kibana-vega 让 agent 用 Vega / Vega-Lite 声明式语法，直接调用 Kibana 的 Dashboards / Visualizations API 生成超出标准 Lens 图表能力的自定义可视化，数据源固定为 ES|QL：
- CLI 全流程覆盖：
node scripts/kibana-vega.js提供 dashboards/visualizations 的增删改查、add-panel面板定位、apply-layout一次性应用整套布局，支持从 stdin 直接传入 JSON 规格，无需落地中间文件 - ES|QL 专属数据源写法：文档给出
%type%: "esql"、%context%（继承仪表盘过滤器）、%timefield%（启用时间范围）等属性的完整对照表 - 48 列网格与“首屏优先”布局准则：给出不同分辨率下的可视高度预算与操作型仪表盘的排布模板，帮助 agent 生成的仪表盘避免大片留白或信息挤压
- 9 类常见故障速查表：HJSON 三引号解析报错、字段带点导致 Vega 识别为嵌套路径、暗色主题下白边框、排序冲突等高频问题逐条给出修复写法
- 前置连接测试：要求先执行
node scripts/kibana-vega.js test校验 Kibana 连接，失败即停止而非继续试错
技能标注为 Technical Preview，严格要求 ES|QL 数据源与 Kibana 9.4+（SNAPSHOT）或 Serverless 环境，不兼容旧版本 Lucene/KQL 数据源定义。
3. 适用场景
固定分类：数据分析与可视化
- 已部署 Kibana 9.4+ 技术预览版或 Elastic Serverless、需要用 ES|QL 数据构建标准 Lens 图表覆盖不到的自定义可视化（如复杂多层图、程序化面板布局）的工程师与数据分析师
- 希望把 Vega 图表定义与仪表盘布局纳入 Git 版本控制、走代码评审流程发布的团队
- 已经用 ES|QL 做数据探索、希望直接把查询结果渲染成自定义样式图表、不想手工编写 Vega JSON 的用户
4. 跨 Agent 兼容性
- Claude Code：原生支持——官方插件市场
claude plugin install kibana@elastic-agent-skills，也可用npx skills add elastic/agent-skills --skill kibana-vega -a claude-code安装到.claude/skills - Codex：支持——仓库 README「Supported agents」表明确列出 codex，安装目录为
.agents/skills - OpenClaw：未验证——官方支持列表未提及
- Hermes Agent：未验证——官方支持列表未提及
5. 推荐理由
Kibana 的标准 Lens 图表能覆盖大多数常规场景，但一旦需要多层叠加、非标编码或程序化批量布局，就得靠 Vega 语法手写规格——这类规格的语法细节繁琐、报错信息也不直观。这个技能把 ES|QL 专属的数据源写法、48 列网格布局准则和 9 类高频报错的修复方法都写成了 agent 可直接照做的规范，还提供前置连接测试兜底，能明显降低“agent 写出语法正确但渲染失败的 Vega 规格”的概率。对已用 Elastic Stack 且需要突破标准图表限制的团队，这是比手工调试 Vega JSON 更快的路径。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Elastic 为搜索与可观测性领域一线上市公司（NYSE: ESTC）官方出品，elastic/agent-skills 是其官方技能库；但截至目前未见官方专文报道 kibana-vega 本身（不同于同仓库 kibana-dashboards 有专门博客介绍），第三方独立评价也暂未发现 |
| 可用性 | 7 | 文档详尽（数据源属性对照表、布局设计准则、9 类故障速查表齐全），提供前置连接测试；但要求 Kibana 9.4+ 技术预览（SNAPSHOT）或 Serverless 环境，仅支持 ES |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 7.67 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行 | 有——运行配套 Node 脚本执行仪表盘/可视化的 CRUD 操作，范围限定在调用用户自己配置的 Kibana REST API；脚本仅引入一个第三方库 hjson（JSON 超集解析器），未见 eval 或动态代码执行 |
| ② 运行时联网外发 | 仅向环境变量指定的 KIBANA_URL/Cloud 端点发起请求，未见向未声明第三方外发数据 |
| ③ API key/凭据 | 通过环境变量（KIBANA_API_KEY/KIBANA_CLOUD_ID/用户名密码）读取，脚本内不落盘存储凭据 |
| ④ 可疑指令 | 通读 SKILL.md 与配套脚本源码，未见 prompt injection 或越权指令 |
| ⑤ 作者/组织信誉 | Elastic 官方（elastic.co，纽交所上市公司 ESTC）；仓库 README 专辟「Security considerations」章节，主动提示凭据最小权限、非生产环境先行验证等风险提醒 |
| ⑥ License | 仓库整体 Apache License 2.0，GitHub API 确认，口径清晰（该子技能自身 package.json 的 license 字段写占位符“tbd”，以仓库根 LICENSE 为准） |
| ⑦ 维护时间 | 该子技能自身最近一次提交 2026-04-03（约 4 个月前），所属仓库整体最近一次提交 2026-07-22，持续维护中 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 差异点 |
|---|---|---|
| kibana-vega（本推荐） | Elastic 官方：用 Vega/Vega-Lite 语法在 Kibana 中构建超出标准图表能力的自定义可视化 | 唯一同时给出 ES |
| kibana-dashboards（elastic/agent-skills 同仓库） | 用声明式 JSON 封装 Kibana 标准 Dashboards/Visualizations API（metric、xy、heatmap 等 8 类内置图表） | 覆盖日常仪表盘搭建场景更广、零第三方依赖，但不支持 Vega 语法能实现的非标图表与复杂多层编码 |
| excalidraw-diagram-generator（github/awesome-copilot） | 用自然语言生成可编辑 .excalidraw 流程图/架构图/ER 图等结构化图表 JSON |
面向通用绘图场景、零外部依赖，不对接任何运维数据平台或实时数据源，与 kibana-vega 面向“数据驱动图表”的定位互补而非重叠 |
| markdown-viewer/skills | 在 Markdown 文档中直接嵌入图表与可视化的技能合集 | 定位是文档场景下的静态图表生成，不具备 kibana-vega 面向 Kibana 仪表盘的发布、版本控制部署等操作型工作流能力 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
elastic/agent-skills 合集共 30 余个技能，覆盖 Cloud、Elasticsearch、Kibana、Observability、Security 五大类；官方 README 建议按需安装、避免一次装太多技能增加路由上下文负担。仓库整体最近一次提交为 2026-07-22，处于持续迭代中。
10. 安装使用方式
- 方式一（推荐，精确安装单个技能）：
npx skills add elastic/agent-skills --skill kibana-vega - 方式二（Claude Code 插件市场，安装整组 Kibana 技能）：先执行
claude plugin marketplace add https://github.com/elastic/agent-skills，再执行claude plugin install kibana@elastic-agent-skills - 方式三（GitHub Copilot CLI）：
copilot plugin marketplace add elastic/agent-skills，再copilot plugin install kibana@elastic-agent-skills - 方式四（手动）：clone 仓库后把
skills/kibana/kibana-vega子目录复制到自己项目的技能目录 - 安装后需配置 Kibana 连接信息（
KIBANA_CLOUD_ID+KIBANA_API_KEY，或KIBANA_URL+API Key/用户名密码），先运行node scripts/kibana-vega.js test验证连接再开始使用 - 安装后建议重启 Claude Code 会话（官方 README 提示插件热重载可能不会立即生效）
11. 注意事项
- 要求 Kibana 9.4+（技术预览/SNAPSHOT 版本）或 Elastic Serverless，无法在当前稳定版 Kibana 上使用
- 仅支持 ES|QL 数据源，不兼容基于 Lucene/KQL 的旧版数据源定义
- 需要使用者具备 Vega/Vega-Lite 语法基础，学习门槛高于同仓库的 kibana-dashboards
- 技能标注为 Technical Preview，Elastic 官方声明后续可能随评估结果调整
- 与 OpenClaw、Hermes Agent 的兼容性未经官方验证，建议自行测试
- 技能本身不提供 Kibana 环境搭建指引，需要用户已具备可访问的部署及相应凭据