观远 CLI 套件
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-v7o6v577/guandata-cli-suite。
技能介绍
要解决的问题
观远数据里的 guancli、guands、guanetl、guanvis、guanmetric、guanwf 各自覆盖不同对象,工程师常需要跨组件查询资源、修改 ETL、调整指标或验证页面。直接调用单个 CLI 容易选错入口,也可能把“编辑”做成“删除重建”。
如何工作
- 意图路由:根据用户要查、要改、要发布还是验证,选择最贴近的组件;跨域任务按依赖顺序组合。
- 执行约束:进入目标 Skill 后遵守查询、预览、确认、保存、发布与验证规则;未安装或认证时先走对应前置流程。
- 安全红线:已有 BI 资源只允许原地更新。资源 ID、权限、调度和历史状态不能通过删除同名资源迁移,因此禁止用“删除 + 新建”模拟编辑。
- 典型链路:先用
guands准备数据层,再用guanetl做复杂转换,最后用guanvis构建可视化;查询资源 ID 或结构时用guancli。
边界与注意点
guancli适合查询分析和表单数据读写,不负责修改 ETL、数据集或仪表板。guands处理连接器、数据集和表单结构;guanmetric管理指标;guanwf面向工作流引擎,普通 ETL 仍应使用guanetl。- 套件不绕过目标 CLI 的官方限制,也不承诺迁移服务端状态。
使用场景
- 重构仪表板前,查询页面、卡片、字段血缘和节点 SQL,确认改动影响范围。
- 调整数据源、目录、计算字段或刷新调度,并在保存后验证数据集可用性。
- 新建、调试、保存或调度 ETL 与数据流,编排 Python、子工作流和多节点 DAG。
- 创建或编辑指标主题、公共维度,并读写 SurveyEngine 表单后验证结构。
适合人员
- 维护观远 BI 项目的数据工程师:按对象路由到 guancli、guands 或 guanetl,修改数据层和 ETL。
- 负责指标口径与报表的业务分析师:创建或编辑指标、指标主题、公共维度,并核对页面卡片依赖。
- 搭建数据产品或工作流的分析师:编排子工作流、多节点 DAG,或创建 SurveyEngine 填报表单。
- 接手观远环境的新人:先查询资源 ID、结构、血缘和节点 SQL,再执行安全的原地更新。