下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-v7o6v577--guandata-cli-suite.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-v7o6v577/guandata-cli-suite。观远 CLI 官方套件的统一入口。用户要查询或分析 ETL、数据集、页面、卡片、指标和血缘,读写表单填报数据,创建 SuperApp 模板,管理数据源或数据集,创建修改 ETL,构建图表或仪表板,创建编辑指标,或查询和编排工作流、数据流时使用。根据任务选择 guancli、guands、guanetl、guanvis、guanmetric 或 guanwf;若组件尚未安装,则引导通过 @guandata/guanskill 安装正式套件。
阅读全文 (展开查看完整说明)
概述
根据观远数据任务选择对应的正式 CLI Skill,并按目标 Skill 的最新说明完成查询、修改和验证。
执行流程
- 判断用户是在了解能力、请求安装,还是要执行具体任务。
- 按“能力路由”选择最贴近主任务的组件;跨域任务再按依赖顺序组合多个组件。
- 检查目标组件是否已安装。已安装时使用对应 Skill;未安装时进入“安装套件”流程。
- 遵守目标 Skill 的查询、预览、确认、保存、发布和验证规则。
套件级红线:编辑 ≠ 删除重建
用户要求编辑/重命名/修改已有 BI 资源(数据账号、数据集、表单、ETL、页面、卡片、指标、工作流等)时,只能使用对应组件的原地更新能力;组件没有对应能力时,直接告知用户 CLI 暂不支持。严禁用"删除旧资源 + 新建同名资源"来模拟编辑:BI 资源的 ID 被下游广泛引用,且携带权限配置、调度、历史数据等 CLI 无法迁移的服务端状态,删除重建会静默丢失且无法恢复。只有用户明确指示"先新建替代、再删除旧的"时才允许,且执行前必须列出会断链和丢失的内容并获得确认。
能力路由
| 用户意图 | 使用 Skill | 边界 |
|---|---|---|
| 查询、分析 ETL、数据集、字段、页面、卡片、血缘、节点 SQL、指标数据,读写表单填报数据,或创建 SuperApp 模板 | guancli | 负责查询分析、表单数据 CRUD 和通用入口;不负责修改 ETL、数据集或仪表板 |
| 管理连接器、账号、数据源、数据集、目录、导入数据、增量更新、刷新调度、计算字段,或创建/编辑 SurveyEngine 填报表单 | guands | 数据源和数据集写操作,以及表单结构创建与原地编辑 |
| 新建、修改、调试、保存、运行、取消或调度 ETL | guanetl | 查基础元信息时可先配合 guancli |
| 新建、修改、组装卡片、筛选器、指标卡片或仪表板,或做页面截图验证 | guanvis | 只查询现有页面或卡片内容时使用 guancli |
| 创建、编辑、删除指标,管理指标主题、目录、公共维度或标准化指标 Excel | guanmetric | 指标查询仍使用 guancli |
| 查询、创建、编辑、保存、运行工作流或数据流,编排 Python、子工作流和多节点 DAG | guanwf | 工作流引擎能力;普通 ETL 使用 guanetl |
典型跨域顺序:先用 guands 准备数据层,再按需用 guanetl 做复杂转换,最后用 guanvis 构建可视化。查询线上资源 ID 或结构时使用 guancli。
安装套件
先检查 guanskill 和目标组件命令是否可用。macOS/Linux 使用:
command -v guanskill
command -v guancliWindows PowerShell 使用:
Get-Command guanskill
Get-Command guancli若未安装,说明将安装六个正式组件;获得用户同意后执行:
npm install -g @guandata/guanskill
guanskill install-skill安装要求和认证说明以官方文档为准:
https://www.guandata.com/guandata-cli-installation-guide.md
安装完成后重新加载目标组件 Skill,再继续原始任务。
需要连接观远环境时检查认证状态:
guancli auth status尚未认证时引导用户执行 guancli auth login。