观远 CLI 套件

根据观远数据任务选择对应的正式 CLI Skill，并按目标 Skill 的最新说明完成查询、修改和验证。

执行流程

判断用户是在了解能力、请求安装，还是要执行具体任务。
按“能力路由”选择最贴近主任务的组件；跨域任务再按依赖顺序组合多个组件。
检查目标组件是否已安装。已安装时使用对应 Skill；未安装时进入“安装套件”流程。
遵守目标 Skill 的查询、预览、确认、保存、发布和验证规则。

能力路由

| 用户意图 | 使用 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 guancli

Windows 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。