技能介绍

它解决什么问题

在 CloudBase 项目里，常见问题往往不是“缺一段前端代码”，而是场景路由错了：Web 登录误用小程序 SDK，原生 App 误走 Web auth，AI 调用失败却只盯着模型参数，管理操作失败却没有先确认 MCP 是否可用。这份技能把 CloudBase 开发拆成可判断的路由规则：先识别平台、鉴权域、资源类型和调用边界，再进入对应能力文档。

技能如何工作

先识别场景，再读参考技能：使用稳定标识如 auth-tool、auth-web、http-api、cloud-functions、cloudrun-development、ai-model-web，避免依赖仓库路径或生成物。
MCP / mcporter 前置：环境查询、部署、数据库与函数管理前，必须先确认 CloudBase MCP 可用，并在执行前检查工具 schema。
显式 EnvId：代码、配置和命令示例都应明确 EnvId；遇到别名或短名时，先解析为规范完整环境 ID，不能直接传入。
区分平台边界：Web 登录读 auth-tool / auth-web，微信小程序读 miniprogram-development，原生 App 读 http-api，NoSQL 与 MySQL 分别走对应 SDK 或 OpenAPI。
AI 调用有资格检查：createModel(...) 参数是 GroupName，具体模型 ID 放在 generateText / streamText 的 model 字段；调用前先检查资源包与成长计划状态。
工程验收要留证据：禁止用 any 掩盖类型问题，要求静态检查与构建通过；涉及路由、表单、鉴权或异步 UI 时，应补充运行时验证。

适用边界与注意点

适用于 CloudBase Web、小程序、原生 App、云函数、CloudRun、AI Agent 和 AI 模型接入的开发与排障。它不替代官方 SDK 文档，也不适合在平台不明、环境不唯一或 MCP 不可用时继续硬写代码。同一实现路径失败 2～3 次后，应停下来重新检查路由、鉴权域、权限模型和 SDK 边界，而不是继续叠加补丁。

截图预览

使用场景

在 Web 登录页项目中，按 auth-tool 与 auth-web 配置短信、邮箱登录和发布密钥。
在微信小程序接入 CloudBase 时，区分 wx.cloud 与 Web SDK，完成登录态与数据库权限。
在 Node.js 后端调用大模型前，检查 Token Credits 资源包，并把模型 ID 写入 model 字段。
在 CloudRun 部署后端时，先读 cloudrun-development，检查 Dockerfile、CORS 和容器边界。

适合人员

负责 Web 登录与鉴权的前端工程师，需要避免把小程序或原生 App 鉴权路径混用。
维护 CloudBase 云函数和 CloudRun 后端的平台工程师，需要在部署前确认 MCP、EnvId 与运行边界。
接入大模型的 Node.js 或 Web 工程师，需要排查 Token Credits、模型 GroupName 与流式调用配置。
为小程序做云开发的工程师，需要区分 wx.cloud、NoSQL Web SDK 和关系型数据库管理路径。

CloudBase 开发指南