前言¶
在 Cursor、Claude Code 等環境裏做運維或建站時，常見做法是自己在終端拼 tccli 命令，或把控制台截圖交給模型猜下一步。騰訊雲產品多、接口分散，Lighthouse、CVM、COS、VPC、DNSPod 等往往要切換不同子命令。下面介紹 SkillHub 上的 Tencent Cloud Infra（@tencent-adm/tencentcloud-infra）：把基於 tccli 的雲資源操作收斂成 Agent 可調用的 Skill，用自然語言描述場景，由 Skill 引導完成查看、管理與巡檢類任務。
這是什麼¶
Tencent Cloud Infra 是騰訊雲側發佈的全產品統一管理 Skill，座標 @tencent-adm/tencentcloud-infra，當前版本 v1.0.12，來源標註爲 enterprise，發佈者爲 Tencent Cloud Infra（SkillHub 頁面顯示已認證作者）。SkillHub 分類爲 it-ops-security（IT 運維與安全）。
官方簡介：基於 tccli 覆蓋 Lighthouse、CVM、CBS、COS、VPC、DNSPod、SSL、CAM、Monitor、TAT、Domain、CloudAudit 等 12+ 產品；支持資源查看與管理、安全巡檢、應用部署、建站、證書檢查、賬號切換等場景。頁面標籤還包含監控告警、服務器運維、配置生成等方向。Skill 元數據標記 requires_api_key=true，使用前需配置騰訊雲 API 憑證。
核心功能¶
以下能力均來自官方簡介與 SkillHub 頁面描述，底層依賴 tccli 對接各產品線 API。
- 資源查看與管理：跨 Lighthouse、CVM、CBS、COS、VPC 等統一入口，減少在控制台與多條 CLI 子命令之間切換。
- 安全與合規相關：安全巡檢；CAM、CloudAudit 等產品在覆蓋範圍內，適合賬號權限與審計類查詢（具體子能力以 Skill 內 SKILL.md 爲準）。
- 應用與站點：應用部署、建站；DNSPod、Domain、SSL 等可用於域名、證書相關檢查與配置協助。
- 運維與監控：Monitor、TAT（自動化助手）等產品納入同一 Skill，便於告警、實例運維類對話式操作。
- 賬號切換：支持多賬號或憑證切換場景（需按 Skill 要求正確配置密鑰）。
SkillHub 頁面顯示科恩實驗室、雲鼎實驗室對該 Skill 的安全評估爲「安全，無風險」，並附有查看報告入口；這不替代你在生產環境前的權限最小化與變更審批流程。
安裝與啓用¶
通過 SkillHub CLI 安裝¶
先確認本機是否已有 skillhub（完整步驟見 SkillHub 安裝文檔）：
command -v skillhub && skillhub --version
未安裝時可執行官方一鍵腳本（完整安裝含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill 時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被識別：
skillhub install @tencent-adm/tencentcloud-infra --dir <你的 Agent skills 目錄>
常用目錄示例（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後按你所用客戶端要求重啓或刷新 Agent，使 Skill 被加載。
通過提示詞讓 AI 安裝¶
SkillHub 頁面提供的標準提示爲：讓 AI 根據安裝文檔安裝本 Skill。可將下面一句發給 Agent：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@tencent-adm/tencentcloud-infra`。
頁面還支持下載 Zip 包安裝、安裝到本地 Agent、WorkBuddy 等入口；若你使用非 CLI 路徑，以 SkillHub 當前頁面選項爲準。
API Key 與 tccli¶
Skill 標記 需配置 API Key。實際調用鏈依賴 tccli 與騰訊雲 API 密鑰（SecretId、SecretKey 等），請按 Skill 包內說明與騰訊雲 CAM 最佳實踐配置，勿把密鑰寫入倉庫或對話日誌。賬號切換類能力同樣建立在正確、受控的憑證配置之上。
典型用法¶
官方未在公開摘要中給出逐條 shell 示例；典型用法是按場景用自然語言驅動 Agent，由 Skill 組織 tccli 或等價調用。可與簡介中的場景對應，例如：
- 查資源：說明要查看的產品（如某地域 CVM、COS 桶、VPC），讓 Agent 通過 Skill 拉取列表或詳情。
- 安全巡檢 / 證書檢查：描述巡檢範圍或域名、證書到期關注點，由 Skill 引導查詢 SSL、CAM、Monitor 等相關接口。
- 建站與部署：說明 Lighthouse 或 CVM 上的部署目標，結合 DNSPod、Domain、SSL 完成域名與證書相關步驟（變更前建議人工確認）。
- 賬號切換：在已配置多套憑證的前提下，明確要操作的賬號或環境，再發起資源類指令。
復現路徑：安裝 Skill → 配置 API 憑證 → 在支持 Skills 的客戶端中選中或自動加載 @tencent-adm/tencentcloud-infra → 用上述場景描述發起對話。更細的命令模板與參數約束以安裝包內的 SKILL.md 爲準。
適用場景與注意¶
適合誰：需要在 AI 編程/運維助手內操作騰訊雲、又不想每次手寫 tccli 的開發者與運維；SkillHub 分類爲 IT 運維與安全，與監控、服務器運維、配置生成等標籤一致。
使用注意：
- 必須配置 API Key；權限過大時，Agent 誤操作風險與人工在終端執行相當，建議 CAM 策略按最小權限授予。
- 覆蓋 12+ 產品不等於每個控制台功能都有封裝，邊界以 Skill 版本 v1.0.12 內文檔爲準。
- SkillHub 統計（以 API 元數據爲準）：評分 100000，下載 7030，安裝 42；頁面展示約 7.0 千次下載，與元數據量級一致。安裝量較小時，可參考頁面版本歷史與評論後再上生產。
結尾¶
Tencent Cloud Infra 把騰訊雲多產品線操作收攏到 Agent Skill，核心依賴 tccli，適合資源管理、巡檢、建站與證書檢查等對話式運維。安裝與目錄配置遵循 SkillHub 安裝文檔，包座標 @tencent-adm/tencentcloud-infra。
- SkillHub 頁面：https://www.skillhub.cn/skills/tencent-adm/tencentcloud-infra
- API 元數據：https://api.skillhub.cn/tencent-adm/tencentcloud-infra
