CloudBase 技能是面向腾讯云开发（CloudBase / TCB / 微信云开发）项目的开发指南，适用于 Web、微信小程序、uni-app、原生 App 等场景下的开发、设计、构建、部署、调试、迁移与排错。
用途与首要步骤 使用前必须先确认站点：CloudBase 分国内站（cloud.tencent.com）与国际站（tencentcloud.com），两套账号体系的环境、控制台、API 密钥与登录状态互不相通，站点选错常表现为“已登录但看不到环境”。可依据控制台域名、envId 或已有报错推断，无法推断时向用户确认一次，不应猜测。远程 MCP 默认首选：国内站为 https://tcb-api.cloud.tencent.com/mcp/v1，国际站为 https://tcb-api.tencentcloud.com/mcp/v1；本地 stdio MCP 需设置 TCB_SITE=intl 与 TCB_REGION=ap-singapore（国际站），CLI 则使用 TCB_IS_INTL=true 或 tcb config set isIntl true。项目级记录写入 .cloudbase/project.json，便于重启后 MCP 读取。
主要能力与工作流 工作流分三步：探索阶段先通过 searchKnowledgeBase(mode="skill") 检索并完整阅读匹配技能再写代码；实现阶段先准备后端资源（优先 MCP，若当前会话缺少工具则配置 MCP 供下次使用并先用 tcb CLI 完成），再写前端代码、安装依赖、启动服务并测试；收尾阶段运行 cloudbase-code-review、修复错误并声明完成。技能覆盖高优先级路由场景，包括最小 Web BaaS 演示、Web 登录注册、微信小程序、原生 App/Flutter/React Native（走 HTTP API）、NoSQL 数据库、CloudBase PostgreSQL、存量 MySQL、云函数、CloudRun 后端、AI 智能体、AI 模型调用与 UI 生成等。
约束与护栏 后端资源须先于前端代码准备；不用 any 绕过类型错误；完成前需做静态（tsc/lint/build/test）与运行时自检；不得用空 try/catch 或删除失败测试掩盖问题。同一路径失败 2–3 次后应停止并改换路由。始终显式指定 EnvId，不依赖 CLI 隐式环境；别名需先用 queryEnv 解析为完整 EnvId。首次前端部署必须用 manageApps(action="deployApp")，manageHosting 仅用于原本通过 hosting 部署的项目增量更新。新关系型数据库使用 PostgreSQL，MySQL 技能仅适用于已有 MySQL 实例的环境。AI 模型调用前需先做资格检查（DescribeActivityInfo、DescribeEnvPostpayPackage）。UI 任务先读 ui-design 并输出设计规范；认证任务先读 auth-tool-cloudbase 并启用提供方。
安装与使用方式 首选安装命令：npx plugins add TencentCloudBase/cloudbase-plugin -y --scope user，支持目标 claude-code、cursor、codex、grok、kimi、github-copilot、vscode。可用 npx mcporter list | grep cloudbase 或 IDE MCP 面板验证。若缺少 MCP 工具，仍应完成安装配置并告知用户重启后可用，同时通过 cloudbase-cli 域技能使用 tcb CLI。登录优先使用 MCP 设备码登录，否则 tcb login，不硬编码密钥。也可通过 npx skills add tencentcloudbase/cloudbase-skills 安装完整技能包。
适用场景与限制 适合在 CloudBase 上构建和运维 Web、小程序、App 后端、云函数、CloudRun、数据库与 AI 能力的项目。限制包括：国际站不提供 NoSQL/文档数据库工具；远程 MCP 绑定单一站点；本地 stdio 仅在特定需求下使用；资料未说明收费标准、价格与具体效果，相关细节暂未提供。