Agent Skills
返回列表
💻

微信小程序开发规范

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 专项技能分流而非混写后台逻辑