SuperAPI AI 工具集

cloudbase

编程与开发

查看项目

更新于 10-16 10:44

技能介绍

CloudBase Development Guidelines 是一份面向腾讯云开发(CloudBase)项目的技能入口文档,用于在开发、设计、构建、部署、调试、迁移或排查 CloudBase 项目时提供分场景的参考与路由。资料显示,技能包内含主入口 SKILL.md 和 references/ 目录下的多份参考文档,如 auth-web-cloudbase、auth-wechat-miniprogram、cloudbase-document-database-web-sdk、ui-design 等。

用途与适用场景 资料列出该技能可用于 Web、微信小程序、uni-app、原生 App(Flutter / React Native)、CloudBase PostgreSQL / MySQL、云函数、CloudRun 后端、AI Agent(智能体开发)、AI 模型调用、UI 生成、规范工作流与资源健康巡检等场景。路由表按场景给出“先读什么”“再读什么”“不要先路由到哪些技能”以及行动前必须检查的事项。

站点区分(国内站与国际站) CloudBase 有国内站(cloud.tencent.com)与国际站(tencentcloud.com)两套独立账号体系,环境、控制台、API key 与登录状态不互通。文档给出两者的远端 MCP 地址、本地 stdio MCP 配置、tcb CLI 开关、项目记录文件(.cloudbase/project.json)、控制台域名与默认地域的差异,并指出国际站不提供 NoSQL / 文档数据库工具。文档建议在安装 MCP、登录或绑定环境前先确定站点,并根据控制台域名、envId 或已有报错推断,否则询问用户一次,不要猜测。

工作流 文档定义了三阶段流程:1. 探索阶段需在写代码前完整阅读匹配的技能,用 searchKnowledgeBase(mode="skill") 搜索后读取完整 SKILL.md;2. 实施阶段分为资源准备(优先 MCP,若本会话缺少 MCP 工具则配置 MCP 供下次使用,同时先用 tcb CLI)与前端实现(写代码、装依赖、启动服务、测试);3. 收尾阶段执行 cloudbase-code-review、修复错误并声明完成。文档强调阶段 2a 必须先于前端代码,阶段 3 为强制。

关键约束与工程守则 文档要求写前端代码前先准备后端资源;禁止用 any 绕过类型错误,优先 unknown 加类型守卫或精确接口;声明完成前需自验证(静态检查如 tsc / lint / build / tests,运行时用 agent-browser 验证用户可见流程);不得掩盖失败,禁止空 try/catch 或删除失败测试来变绿。此外,文档要求在环境标识为别名或简称时先解析为完整 EnvId,明确指定 EnvId,不要依赖 CLI 隐式环境状态;首次前端部署必须使用 manageApps(action="deployApp", ...),没有 createApp / updateApp。

工具与安装 文档建议优先使用 CloudBase MCP,并给出安装命令:npx plugins add TencentCloudBase/cloudbase-plugin -y --scope user,支持的 target ID 包括 claude-code、cursor、codex、grok、kimi、github-copilot、vscode。可用 npx mcporter list | grep cloudbase 或 IDE MCP 面板验证。若缺少 npm / npx,参考 tooling-fallback.md。若 MCP 暂不可见,仍继续安装配置并告知用户重启后可用,同时先用 tcb CLI。文档还提到优先使用 MCP auth 的设备码登录,否则用 tcb login,不要硬编码密钥。

路由与常见失败原因 文档以表格形式列出各场景的路由与检查点,并指出常见失败原因:Web 认证失败通常是漏配 provider;原生 App 失败常因误用 Web SDK 路径;小程序失败常因把 wx.cloud 当 Web 认证 / SDK 处理;CloudBase PG 失败常因回退到 MySQL / NoSQL、跳过用户名密码准备或猜测原始 HTTP;AI 模型失败常因缺少 Token Credits / 成长计划,需先执行 DescribeEnvPostpayPackage / DescribeActivityInfo。

按需参考文件 文档列出仅在需要时加载的参考文件,包括 tooling-fallback.md、site-onboarding.md、deployment-workflow.md、console-links.md、scenarios.md、mcp-setup.md、activation-map.yaml 等,并给出参考索引。

限制与未提供信息 资料未说明该技能包的收费方式、价格、具体的环境创建步骤、各参考文档的完整内容,也未提供官方功能介绍页的独立文本;这些均暂未提供。