前言¶
在 AI 輔助寫代碼時,常見情況是前端或業務邏輯已經能生成,但數據庫、對象存儲、登錄態、雲函數和部署仍要你自己查文檔、拼 SDK、對控制台。每換一類端(小程序、Web、管理後臺)又要重複對接一遍,上下文也容易在對話裏斷掉。
下面介紹 SkillHub 上的 騰訊雲 CloudBase · Tencent CloudBase(座標 @tencent-adm/cloudbase)。它把 CloudBase 作爲「面向 AI Coding 的後端一體化平臺」的能力寫進 Agent Skill,讓編碼助手在對話中按統一約定使用數據庫、存儲、身份認證、雲函數與雲託管等服務。
這是什麼¶
騰訊雲 CloudBase(本 Skill 所指對象)是騰訊雲提供的後端一體化平臺;本 Skill 由 騰訊雲 CloudBase 團隊 發佈,在 SkillHub 上歸類爲 dev-programming,來源爲 enterprise,當前版本 2.35.2。
Skill 簡介中的定位是:內置數據庫、存儲、身份認證、雲函數與雲託管等服務,支持快速構建小程序、Web、移動 App、管理後臺與 AI 應用。標籤標明 requires_api_key=false,即 Skill 元數據不要求單獨配置 API Key(具體雲資源仍須在騰訊雲 CloudBase 環境中開通與授權,以控制台與官方文檔爲準)。
SkillHub 頁面:https://www.skillhub.cn/skills/tencent-adm/cloudbase
Skill 元數據地址:https://api.skillhub.cn/tencent-adm/cloudbase
核心功能¶
以下能力均來自 Skill 簡介與 SkillHub 公開說明,對應 CloudBase 平臺側的一體化後端組件:
- 數據庫:結構化數據存儲與訪問(具體 API 與模型以 Skill 內
SKILL.md及 CloudBase 文檔爲準)。 - 存儲:文件/對象存儲能力,便於 Web、小程序與 App 共用資源。
- 身份認證:用戶登錄與鑑權相關能力,減少各端各自實現一套賬號體系。
- 雲函數:無服務器邏輯執行,適合接口、定時任務與輕量後端。
- 雲託管:容器化託管與運行環境,適合需要持續運行的服務。
Skill 的價值在於:上述能力被整理爲 Agent 可遵循的 Skill 說明,便於在 AI Coding 場景下生成與 CloudBase 一致的項目結構與調用方式,而不是在對話裏零散粘貼片段。
安裝與啓用¶
方式一:讓 AI 按 SkillHub 指引安裝¶
SkillHub 官方給出的提示詞爲:請根據 https://skillhub.cn/install/skillhub.md,安裝 @tencent-adm/cloudbase。
將上述句子發給支持 Skills 的 AI 客戶端後,Agent 會按安裝文檔檢查 CLI、選擇正確的 skills 目錄並完成安裝。
方式二:使用 SkillHub CLI¶
先確認是否已安裝 skillhub:
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
安裝本 Skill 時,必須用 --dir 指向當前 Agent 的 skills 目錄;否則默認裝到 ./skills/,客戶端可能無法識別。常用路徑示例(摘自 SkillHub 安裝文檔):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
在 Cursor 下的安裝命令示例:
skillhub install tencent-adm/cloudbase --dir ~/.cursor/skills/
也可先搜索再安裝:
skillhub search cloudbase
skillhub install tencent-adm/cloudbase --dir ~/.cursor/skills/
安裝後按各客戶端要求重啓或重新加載 Skills,使 @tencent-adm/cloudbase 生效。
典型用法¶
公開頁面未附帶獨立的長示例代碼;可復現的入口有兩類:
- 安裝後由 Agent 讀取 Skill 包內的
SKILL.md(通用 Skill 格式),在對話中說明目標端(小程序 / Web / App / 管理後臺 / AI 應用)與要用的 CloudBase 能力(庫、存儲、登錄、函數、託管),讓助手按 Skill 約束生成初始化與調用代碼。 - 在已有 CloudBase 環境的前提下,用自然語言描述「創建集合/上傳文件/配置雲函數/部署雲託管」等任務,由已啓用本 Skill 的 Agent 對齊 CloudBase 術語與推薦流程。
若需覈對平臺能力細節,應結合騰訊雲 CloudBase 官方文檔與控制台,Skill 負責的是 AI 側的一致指引,不替代賬號、計費與環境配置。
適用場景與注意¶
適合誰
- 已在用或計劃用 騰訊雲 CloudBase 做後端,並希望 Cursor、Claude Code、Codex 等工具在寫代碼時少跑偏。
- 需要同時覆蓋 小程序、Web、移動 App、管理後臺或 AI 應用 中某一類或多類交付物,且希望後端組件選型固定在一套平臺上。
注意
- SkillHub 元數據爲
requires_api_key=false,不代表無需騰訊雲賬號或環境;生產資源仍須在 CloudBase 中創建並遵守安全與合規要求。 - 安裝路徑錯誤是常見坑:務必使用
skillhub install ... --dir <當前 Agent 的 skills 目錄>。 - 版本以 SkillHub 爲準(當前 v2.35.2);升級可用 SkillHub 的 install/update 流程,具體以 CLI 幫助爲準。
結尾¶
騰訊雲 CloudBase · Tencent CloudBase(@tencent-adm/cloudbase)把數據庫、存儲、身份認證、雲函數與雲託管等後端能力封裝爲 Agent Skill,面向 AI Coding 場景減少「只會寫界面、不會接後端」的斷層。安裝與優先源配置見 https://skillhub.cn/install/skillhub.md;Skill 詳情見 https://www.skillhub.cn/skills/tencent-adm/cloudbase,元數據見 https://api.skillhub.cn/tencent-adm/cloudbase。