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