Cloudbase Miniprogram
Use when building a WeChat Mini Program (微信小程序 / 小程序) with a real backend on 腾讯云开发...
Install
npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase-miniprogram -g -a claude-code -y- Repository
- TencentCloudBase/CloudBase-AI-Toolkit1.2k
- Category
- Design
- Updated
- 3d ago
- License
- MIT
- Context cost
- Lightabout 919 tokens
- Runs scripts
- No, instructions only
What it does
Use when building a WeChat Mini Program (微信小程序 / 小程序) with a real backend on 腾讯云开发 CloudBase, from an idea to a published release. Triggers on: 小程序, 微信小程序, wx.cloud, 云开发, 云函数, 数据库, 集合, 云存储, 上传图片, 登录, openid, 订阅消息, 支付, 体验版, 预览, 上传代码, 提交审核, 发布, 合法域名, 真机调试, 分包. Covers project scaffolding, project.config.json / appid / miniprogramRoot, the wx.cloud data path, cloud functions, storage, auth, subscription messages, and the preview → upload → review → release chain. Do NOT use for Web/H5 frontends (use a web skill), pure backend services, or mini programs that do not use CloudBase.
CloudBase 全栈小程序开发
一个小程序要真正跑起来，缺的从来不是页面，是后端那一半：数据存哪、登录怎么做、图片传到哪、消息怎么发、审核怎么过。这个技能按「从想法到上架」的顺序组织，每一步告诉你调哪个工具、去哪取细节。
配方正文不打包，用 CloudBase MCP 的知识库按需检索（见文末）。这样内容永远跟线上最新版一致。
第 0 步：先问清三件事，别急着写代码
| 要确认 | 为什么 |
|---|---|
| 小程序 appid 与主体类型 | 个人 / 个体工商户 / 企业主体决定能用哪些能力（支付、部分类目）。测试号不支持云开发 |
| 后端是否用 云开发（CloudBase） | 不用云开发就走另一条路，本技能不适用 |
| 云开发环境是国内站还是国际站 | 两套账号体系互不相通，选错的表现是「登录了但环境列表空」 |
还有一个高频坑：DevTools 里「云开发」入口是灰的，或者看不到环境, , 先诊断，不要当成工具 bug。常见原因就是上表第三条（主体不支持 / 绑定账号不一致 / 站点错）。诊断路径：searchKnowledgeBase({ mode: "skill", skillName: "miniprogram-development" }) 的 Common Pitfalls 一节。
第 1 步：接上 CloudBase MCP
技能包不能携带 MCP 配置，这一步必须显式做。三条路径按客户端能力选：
# A. 能跑命令的客户端
claude mcp add --transport http cloudbase https://tcb-api.cloud.tencent.com/mcp/v1
# B. 本地 stdio（需要 API Key，或要用远程缺的工具）
claude mcp add cloudbase -- npx -y @cloudbase/cloudbase-mcp@latest
# C. 客户端不支持 MCP 但有终端（走 mcporter 桥）
npx -y mcporter@0.16.1 call --stdio "npx -y @cloudbase/cloudbase-mcp@latest" auth action=status
图形客户端（Cursor、Qoder）只能让用户手动加：类型 HTTP / Streamable HTTP，地址填 /mcp/v1。
验证：调 auth action=status，返回 auth_status: READY 且带 current_env_id 就通了。
第 2 步：先跑通一个最小闭环，再谈功能
顺序固定，不要跳：
- 建环境并绑定：
manageEnv（查/建）→auth(action="set_env", envId=...)绑定。 - 建一个集合：
writeNoSqlDatabaseStructure。 - 写一条数据：
writeNoSqlDatabaseContent。 - 写一个云函数并部署：
manageFunctions，创建后在 DevTools 里「上传并部署：云端安装依赖」；用 MCP 的queryFunctions/queryLogs验证调用与日志。 - 小程序端读这条数据：
wx.cloud.init({ env })→wx.cloud.database().collection(...).get()。
这五步通了，说明环境、权限、网络都对了；后面加页面只是重复。
