前言¶
在雲上改配置、查資源、做批量運維時，常見路徑是翻文檔、拼請求參數，或在控制台裏點選。若希望對話式 Agent 能按你的意圖直接走騰訊雲 Open API，需要一套被 Agent 識別的技能說明，而不是零散的 API 備忘。下面介紹 SkillHub 上的 tcapi（@tencent-adm/tcapi）：由 Tencent CloudQ Team 發佈，面向通過 Cloud API 做雲自動化與資源管理的場景。
這是什麼¶
tcapi 是一則基於通用 SKILL.md 格式的 Agent Skill，座標爲 @tencent-adm/tcapi，當前版本 1.0.0，來源標註爲 enterprise，在 SkillHub 分類爲 it-ops-security。
官方簡介爲：Skill to call Cloud API for Tencent Cloud（騰訊雲），用於 cloud automation or resource management（雲自動化或資源管理）。也就是說，它的定位是讓支持 Skills 的 AI 客戶端在對話中按技能指引調用騰訊雲 API，而不是替代騰訊雲控制台或 SDK 本身。
- 發佈者：Tencent CloudQ Team
- SkillHub 頁面：https://www.skillhub.cn/skills/tencent-adm/tcapi
- 技能 API 地址：https://api.skillhub.cn/tencent-adm/tcapi
核心功能¶
結合 SkillHub 與官方簡介，目前可覈實的能力邊界如下：
- 對接騰訊雲 Cloud API：技能主題即「調用騰訊雲 API」，適用於自動化腳本化運維、資源查詢與變更等需要走 Open API 的工作流。
- 運維與安全類場景歸類：分類爲
it-ops-security，與賬號、資源、安全相關運維任務在同一貨架，便於在 SkillHub 中檢索。 - 商店元數據：頁面標籤包含
requires_api_key=false（指 SkillHub 側對該技能的安裝/元數據要求；實際調用騰訊雲 API 仍須遵守騰訊雲賬號、密鑰與權限規範，具體字段以技能包內 SKILL.md 及騰訊雲文檔爲準）。
未在公開頁面單獨列出各產品接口清單或封裝命令時，不宜臆造「已支持 CVM/CDB/…」的細項；安裝後應以技能包內說明爲準。
安裝與啓用¶
SkillHub 推薦通過 skillhub CLI 安裝，並必須把技能裝到當前 Agent 的 skills 目錄，否則默認目錄可能不會被客戶端加載。
1、安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可執行完整安裝（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
2、安裝 tcapi¶
官方頁面給出的安裝提示爲：根據 https://skillhub.cn/install/skillhub.md，安裝 @tencent-adm/tcapi。
在 CLI 已就緒的前提下，按 SkillHub 文檔使用 --dir 指向當前環境的 skills 目錄，例如：
skillhub search tcapi
skillhub install @tencent-adm/tcapi --dir <skills 目錄>
常用客戶端 skills 路徑（摘自 SkillHub 安裝文檔，以你本機實際配置爲準）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝完成後，一般需要重啓或重新加載對應 AI 客戶端，使新技能被索引。Cursor、Codex CLI、Claude Code 的差異主要體現在 skills 目錄路徑 上，安裝命令本身均爲 skillhub install @tencent-adm/tcapi --dir …；未在官方資料中單獨說明的差異此處不展開。
也可在對話中讓 Agent 按上述 install 文檔自行完成安裝（SkillHub 頁面提供的提示詞即爲此用途）。
典型用法¶
公開 SkillHub 頁面未附帶可複製的端到端 API 調用示例；可復現的流程如下。
- 按上一節將
@tencent-adm/tcapi安裝到當前 Agent 的 skills 目錄。 - 在支持 Skills 的客戶端中啓用該技能後，用自然語言描述雲自動化或資源管理目標（例如查詢某類資源、按規範變更配置等）。
- Agent 讀取技能包中的 SKILL.md 指引，在合規前提下組織對騰訊雲 Cloud API 的調用；具體接口名、參數與鑑權方式以技能內文檔及 騰訊雲 API 文檔 爲準。
若你需要覈對技能元數據或版本，可打開 SkillHub 技能頁查看 v1.0.0 與簡介是否更新。
適用場景與注意¶
適合誰
- 已在騰訊雲上運行資源，希望把「查資源、改配置、自動化運維」交給 Agent 編排，而不是每次手寫 curl/SDK 的開發者或運維。
- 使用 Cursor、Claude Code、Codex 等已支持 SkillHub 安裝路徑的客戶端的團隊。
限制與注意
- 技能描述範圍是「調用騰訊雲 API」，不保證覆蓋全部雲產品；新產品或新接口需以技能包更新與官方 API 文檔爲準。
- SkillHub 統計（頁面展示，隨時間變化）：評分 100000，下載約 1079，安裝約 2；選用前可自行在 SkillHub 查看最新數據。
requires_api_key=false僅反映 SkillHub 標籤語義，不能理解爲調用騰訊雲無需鑑權；生產環境務必使用最小權限密鑰並避免把密鑰寫入倉庫。- 未覈實到的客戶端專屬配置項、環境變量名不在本文列出；安裝後請直接閱讀技能目錄下的 SKILL.md。
結尾¶
tcapi 把「在 Agent 裏調用騰訊雲 Cloud API」收斂爲一個可安裝、可版本化的 Skill（@tencent-adm/tcapi），適合雲自動化與資源管理類對話任務。安裝與優先源說明見 https://skillhub.cn/install/skillhub.md ，技能主頁見 https://www.skillhub.cn/skills/tencent-adm/tcapi ，API 入口見 https://api.skillhub.cn/tencent-adm/tcapi 。
