Agent Skills
返回列表
💻

CloudBase 开发指南

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tencentcloudbase-skills-cloudbase。

技能介绍

要解决什么问题

在腾讯云 CloudBase 上做 Web、小程序、原生 App 或云函数时,能力分散在几十个子技能里(鉴权、NoSQL、PostgreSQL、HTTP API、部署等)。若一开始就写前端或乱调 tcb/MCP,常见结果是:环境别名当 EnvId 用、Web 鉴权没开 Provider、PostgreSQL 路径误走 MySQL/NoSQL、首屏前端用 manageHosting 而不是 manageApps,或 MCP 未就绪时原地卡住。

本技能是 CloudBase 技能包的工程入口:先识别场景,再按稳定技能 id 路由到对应子技能,并统一约束执行顺序与回退路径。

技能如何工作

工作流约束: 规范要求 Stage 2a 必须先于前端代码,且 Stage 3 为必做;UI 任务需先读 ui-design 并输出设计说明;鉴权任务需先读 auth-tool-cloudbase 并完成 Provider 配置,再写前端。

路由契约: 管理、源码与安装物使用同一套技能 id(如 auth-web-cloudbase、http-api-cloudbase、postgresql-development-cloudbase)。技能内提供 高优先级路由表:例如 Web 登录走 auth-tool-cloudbase → auth-web;CloudBase PG 走 postgresql-development-cloudbase,且 不得 用 NoSQL 或 manageMysqlDatabase 顶替。

运行时与工具链: 当前会话有 MCP/mcporter 时优先用于管理与部署;没有则按 references/tooling-fallback.md 用 cloudbase-cli 域技能完成登录与管理(不推荐 tcb deploy 作为管理主线)。EnvId 必须显式指定;别名须用 envQuery(action=list, alias=..., aliasExact=true) 解析为完整环境 ID 后再用于 auth.set_env、SDK 初始化或控制台链接。

工程宪章(全局覆盖): 先准备后端资源再写前端;禁用 any 绕过类型;完成前做静态与可见流程自证;首次前端部署必须用 manageApps(action="createApp", ...),manageHosting 仅用于原 hosting 工程的增量更新;AI 调用侧区分 GroupName 与模型 id,大模型路径需先做资格检查(DescribeActivityInfo / DescribeEnvPostpayPackage)。

适用边界与注意点

  • 细节实现(SQL 写法、具体 SDK API、单场景排错)在子技能中,本文件不展开。
  • 工作区只暴露单个已发布技能时:优先本地 references/ 与同包兄弟技能目录,不要从远端 raw URL 拉兄弟技能正文;缺包时提示安装完整 tencentcloudbase/cloudbase-skills 或 IDE 插件后再继续。
  • 同一链路连续失败 2~3 次应停线改路由(平台、运行时、鉴权域、权限模型或 SDK 边界)。
  • Web 鉴权失败多为 Provider 未配置;原生 App 多为误用 Web SDK;小程序勿把 wx.cloud 当 Web 鉴权;PG 场景勿猜 HTTP,应走 app.rdb() 与文档化 OpenAPI。

使用场景

  • 新项目要先定 CloudBase 场景(Web BaaS、小程序或 HTTP API),再按路由表选定子技能,避免一上来写错 SDK 或鉴权域
  • Web 登录/注册页开发前,需要先确认 Provider 与 publishable key,再按 auth-tool → auth-web 顺序实现
  • 首次把前端工程部署到 CloudBase 时,需要区分 manageApps 建应用与 manageHosting 增量更新,避免首 deploy 走错接口
  • 大模型文本/流式对话接入前,要先查 Token Credits 与小程序成长计划资格,再进入 ai-model 相关技能改代码

适合人员

  • 负责 CloudBase Web/小程序全栈交付、需要统一 MCP 与会话内 CLI 回退策略的前端或全栈工程师
  • 维护多环境别名与 EnvId 的后端或平台同学,要求每次 SDK/控制台调用都使用解析后的完整环境 ID
  • 做 CloudBase PostgreSQL 或 RLS 权限模型的开发者,需要避免误走 MySQL/NoSQL 管理路径
  • 集成 CloudBase AI 能力的产品工程师,需要在改调用代码前完成资源包与活动资格自查