前言¶
在 Agent 里操作观远 BI，常见做法是零散记住多个 CLI 或 Skill 名称：查数据集、改 ETL、做仪表板、编排工作流，往往对应不同工具。任务一多，容易装错组件或让模型选错入口。下面介绍观远数据在 SkillHub 发布的「观远 CLI 官方套件」——作为统一入口，按任务类型把请求路由到正式 CLI Skills；本地缺组件时，再引导通过 @guandata/guanskill 安装。
这是什么¶
观远 CLI 官方套件（坐标 @org-v7o6v577/guandata-cli-suite，当前版本 1.0.3）由 观远数据 维护，来源标注为 enterprise，基于通用 SKILL.md 格式发布在 SkillHub。
它本身不替代底层 CLI，而是解决「该用哪一个观远 CLI Skill」的问题：用户用自然语言描述观远相关任务时，由该 Skill 识别意图并指向 guancli、guands、guanetl、guanvis、guanmetric 或 guanwf 等正式组件。
SkillHub 页面：https://www.skillhub.cn/skills/org-v7o6v577/guandata-cli-suite
API 入口：https://api.skillhub.cn/user_d7c66672/guandata-cli-suite
核心功能¶
以下能力均来自官方简介，按任务域归纳如下。
- 查询与分析：ETL、数据集、页面、卡片、指标及血缘。
- 表单与填报：读写表单填报数据。
- 应用与资产：创建 SuperApp 模板；管理数据源或数据集。
- 开发与可视化：创建或修改 ETL；构建图表或仪表板；创建、编辑指标。
- 编排：查询与编排工作流、数据流。
路由规则：根据上述任务类型，选择对应的正式 CLI Skill（guancli、guands、guanetl、guanvis、guanmetric、guanwf）。若对应组件尚未安装，Skill 会引导通过 @guandata/guanskill 安装正式套件。
标签 requires_api_key=false 表示该 Skill 在 SkillHub 元数据中未声明必须配置 API Key（具体观远环境鉴权仍以各 CLI 组件与平台要求为准）。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
先检查本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需要 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
更完整的说明见：https://skillhub.cn/install/skillhub.md
2、安装观远 CLI 官方套件¶
安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法识别。
skillhub install @org-v7o6v577/guandata-cli-suite --dir <skills 目录>
也可将下面提示交给支持 Skill 的 AI，让其按官方安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@org-v7o6v577/guandata-cli-suite`。
3、各客户端 skills 目录（节选）¶
SkillHub 文档中给出的常见路径如下，请按你实际使用的客户端替换 <skills 目录>：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装后若 Agent 未立即加载新 Skill，按所用客户端说明重启或刷新技能列表。
典型用法¶
官方资料未提供单条可复制执行的底层 CLI 命令示例，典型交互流程如下，可在 Agent 对话中复现。
- 描述观远任务：例如「查询某数据集血缘」「修改一条 ETL」「创建仪表板上的卡片」等，范围需落在套件简介所列能力内。
- 由套件识别并路由：Agent 读取本 Skill 后，应把任务映射到
guancli、guands、guanetl、guanvis、guanmetric或guanwf之一。 - 缺组件时安装正式套件：若本地未安装目标 CLI Skill，按 Skill 指引通过
@guandata/guanskill安装观远正式 CLI 套件，再执行具体操作。
经过上面的步骤，你无需在对话里手动维护「任务 → 工具名」对照表，由统一入口完成分流。
适用场景与注意¶
适合谁
- 已在观远数据平台做 ETL、数据集、可视化、指标或工作流相关开发/运维，并希望在 Cursor、Claude Code、Codex 等 Agent 里用自然语言驱动观远 CLI 能力的开发者与数据工程师。
使用注意
- 本套件是路由与安装引导层；实际 API 调用、环境地址与凭证配置由各子 Skill（
guancli等）及@guandata/guanskill负责，使用前需保证观远环境与对应 CLI 已正确部署。 - SkillHub 分类为 data-analysis；页面展示的下载量、评分会随时间变化，以 SkillHub 当前页面为准（撰写时页面版本为 v1.0.3）。
- 勿与用户线索中未在官方页面核实的旧统计数据混用；安装与坐标以
@org-v7o6v577/guandata-cli-suite为准。
结尾¶
观远 CLI 官方套件把观远侧多种 CLI 能力收拢到一个 Skill 入口：先识别任务，再路由到正式组件，缺包时指向 @guandata/guanskill。若你经常在 Agent 里操作观远 BI，可先按上文安装到对应 skills 目录，再从 SkillHub 页面查看更新说明。
官方地址：https://api.skillhub.cn/user_d7c66672/guandata-cli-suite
