微信小程序开发规范
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tencentcloudbase-skills-miniprogram-development。
技能介绍
要解决什么问题
助手在处理微信小程序时,容易把 Web 前端的登录与 SDK 假设搬进 wx.cloud 项目,或在未确认是否接入 CloudBase 前就套用云开发约束;预览、上传时忽略 project.config.json 里的 miniprogramRoot 与 appid,也会导致编译失败或工具链对不上。
本技能把「默认按小程序工程做事、CloudBase 仅在项目明确使用时才启用」写成可执行约定,并要求在改代码或发布前走同级 Change Safety Protocol 与 Deployment Gate(相对路径引用,不远程拉取技能正文)。
技能如何工作
- 范围判定:页面结构、组件、
app.json/ 页面.json、资源路径、调试与发布流程以小程序规范为先;仅在用户或代码库表明使用 CloudBase 时,再读 CloudBase 集成相关指引。 - 工程约定:校验
project.config.json;页面文件保持完整;tabBar在用户未明确要求图标时,默认tabBar.custom = true的纯文本自定义底栏,避免凭空引用不存在的图标资源。 - 工具路径:优先 Nightly 微信开发者工具 +
wechatide(传-c、绝对--project、有效appid、按需云环境);不可用时退回miniprogram-ci与 CloudBase MCP,并提示安装 Nightly。 - 场景分流:CloudBase 鉴权/文档库/支付集成、UI 生成、小程序 SEO 等,按 SKILL 指引转至同级 sibling 技能,而非在本技能里硬写 Web 或公众号 OAuth 流程。
适用边界
- 不适用:纯 Web 鉴权与 Web SDK 前端、微信支付回调/退款/公众号 OAuth 细节(应使用
cloudbase-wechat-integration等专项技能)。 - 常见坑:Stable 版工具未必带 Nightly Skills;勿臆造
wechatide参数,应查--help/tools.yaml;未走变更安全与发布门禁前不要做上传发布。 - 本地依赖:同级 CloudBase 技能需用
../auth-wechat-miniprogram/SKILL.md等相对路径;缺失时应请用户安装完整插件,禁止 HTTP 拉远程技能正文。
使用场景
- 新页面要放进现有仓库,需按 project.config.json 的 miniprogramRoot 补齐 wxml/js/json 并通过预览验证
- 模拟器或真机预览报错,要在 Nightly 下用 wechatide 带 appid 与绝对项目路径做编译与网络排查
- 代码里已出现 wx.cloud,要在不改 Web 登录范式的前提下接云开发数据库或 OPENID 相关逻辑
- 要做 tabBar 改版且未提供图标素材,希望用自定义组件实现纯文本底栏并避免多余留白
适合人员
- 负责企业小程序版本迭代的前端工程师,需要在每次上传前核对 project.config.json 与发布门禁清单
- 从 H5 或管理后台页面迁到小程序的开发者,要避免把 Web 式登录流程写进 pages 目录
- 已启用腾讯云开发的小程序维护者,要区分日常调试用 wechatide 与仅必要时才走 CloudBase MCP
- 需要协调页面收录与搜索展示的运营协作开发,要在开发侧按 SEO 专项技能分流而非混写后台逻辑