前言¶
在 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
