前言¶

在對話式開發環境裏查雲資源、看架構圖、做成本或合規分析時，常見做法是切到控制台、文檔或單獨運維工具，再把結論貼回 IDE。上下文容易斷，問答也難以覆蓋智能顧問、巡檢、容量與混沌演練等一整套 CloudOps 動作。下面介紹 SkillHub 上的 CloudQ（@tencent-adm/cloudq）：由 Tencent CloudQ Team 發佈，把上述能力以 Agent Skill 形式掛到 Cursor、Claude Code 等客戶端，在自然語言對話中觸發。

這是什麼¶

CloudQ 是面向 騰訊雲、AWS、阿里雲等多雲 的運維與架構類 Skill，分類爲 it-ops-security，來源標註爲 enterprise，當前版本 1.9.0。它解決的是：在 Agent 會話裏完成智能顧問相關操作、AIOps 類巡檢與診斷，以及資源查詢、成本與安全合規等 ChatOps/CloudOps 訴求，而不必爲每一類問題單獨寫腳本或記控制台路徑。

SkillHub 頁面：https://www.skillhub.cn/skills/tencent-adm/cloudq
技能元數據地址：https://api.skillhub.cn/tencent-adm/cloudq

核心功能¶

以下能力均來自官方簡介，按主題歸納，不超出已公開描述。

智能顧問與架構

• 查看智能顧問架構圖、架構目錄、架構詳情、架構評估結果
• 繪製架構圖、開通智能顧問
• 架構健康度評估

AI 運維與可靠性

• AI 智能巡檢
• AI 容量監測
• AI 混沌演練
• AI 雲診斷
• 主動預警

日常運維與治理

• 雲運維問答
• 雲資源查詢
• 雲成本優化
• 安全合規
• 雲資源盤點
• 閒置資源檢查
• 雲產品最佳實踐

標籤 requires_api_key=true 表示啓用前需要配置 API 密鑰；具體字段名與獲取方式以安裝後包內 SKILL.md 及騰訊雲 CloudQ 產品文檔爲準，此處不臆造配置項。

安裝與啓用¶

1、安裝 SkillHub CLI（若尚未安裝）¶

先確認本機是否已有 skillhub：

command -v skillhub && skillhub --version

未安裝時可按 SkillHub 官方安裝說明執行（完整安裝或僅 CLI）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安裝指引全文：https://skillhub.cn/install/skillhub.md

2、安裝 CloudQ 到當前 Agent 的 skills 目錄¶

安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被 Agent 加載。

skillhub install @tencent-adm/cloudq --dir <skills 目錄>

常用路徑（摘自 SkillHub 安裝文檔）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

也可在對話中讓 AI 按官方提示安裝：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@tencent-adm/cloudq`。

3、API 密鑰與重啓¶

Skill 標記需要 API Key。安裝完成後閱讀技能包內 SKILL.md，按說明配置密鑰並重啓或重新加載 Agent，使 Skill 生效。

典型用法¶

官方頁面未提供獨立 REST 示例；典型用法是在已啓用 CloudQ 的 Agent 裏用自然語言描述運維意圖，由 Skill 路由到對應 CloudQ 能力。下列表述與官方簡介中的場景一致，可作爲對話起點（具體能否執行取決於賬號權限與密鑰配置）：

列出當前賬號下某區域的雲服務器實例，並標出可能閒置的資源。

查看智能顧問裏某業務的架構目錄和架構評估結果，並說明架構健康度方面的主要風險。

針對騰訊雲 / AWS / 阿里雲中的指定環境，做一次成本優化與安全合規相關的檢查建議。

我想開通智能顧問並繪製一張包含負載均衡與數據庫的參考架構圖，請按最佳實踐給出步驟。

經過上面的步驟，Agent 應結合 Skill 內工具說明調用後端能力；若返回權限或密鑰錯誤，優先覈對 API Key 與雲賬號授權。

適用場景與注意¶

適合誰

• 需要在 IDE 或 CLI Agent 裏做多雲資源查詢、架構審視、成本與合規討論的 SRE、平臺工程師、雲架構師
• 希望把智能顧問、巡檢、容量、混沌演練、雲診斷等 AIOps 動作收斂到同一對話入口的團隊

限制與注意

• enterprise 來源技能，使用前確認組織是否允許安裝及外連 CloudQ 服務。
• 必須配置 API Key（requires_api_key=true），未配置時相關能力不可用。
• SkillHub 統計（以抓取資料爲準）：評分 100000，下載 4973，安裝 122；安裝量與評分僅作選型參考，不代表與你環境一致的效果。
• 多雲能力以官方簡介爲準；實際覆蓋的產品與區域以 CloudQ 服務側爲準。
• 安裝目錄錯誤是常見坑：務必 skillhub install ... --dir 指向當前 Agent 的 skills 路徑。

結尾¶

CloudQ 把智能顧問、架構評估與一系列 AIOps/ChatOps 能力封裝成 @tencent-adm/cloudq，適合在 Coding Agent 裏用對話完成雲運維與治理類任務。選型與安裝請以 SkillHub 頁面與元數據爲準：

• https://www.skillhub.cn/skills/tencent-adm/cloudq
• https://api.skillhub.cn/tencent-adm/cloudq