Agent Skills
返回列表
微信小程序全栈开发工具包

微信小程序全栈开发工具包

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_64e5b706/wechat-miniprogram-toolkit。

技能介绍

解决什么问题

微信小程序项目里,工程化问题常常比单点 API 更容易卡住:app.json 分包结构不清晰、主包逼近 2MB、云函数 env 不一致、openid 从前端传来传去、废弃的 wx.getUserInfo 仍被误用、Worklet 动画缺少 'worklet' 声明,以及支付、分享、埋点等模块缺少统一检查路径。这个技能把常见问题拆成可执行的参考文档,而不是只给概念说明。

技能如何工作

它按“先读对应 reference,再写代码”的方式组织。核心能力包括:

  • 项目初始化:生成目录结构、project.config.json、app.json 等基础配置。
  • 云开发:覆盖数据库 CRUD、聚合查询、事务、权限规则,以及 cloud.DYNAMIC_CURRENT_ENV 的使用边界。
  • 登录与支付:使用头像昵称按钮方案、云函数鉴权、JSAPI 下单、支付通知和退款排查。
  • 分包与性能:提供 analyze_subpackages.py 做分包分析,处理 2MB 限制、跨包 require、setData 精准更新和 WXS 优化。
  • 高级场景:包括 Skyline Worklet 动画、直播/音视频、云托管、内容安全、小程序互跳、硬件能力和可选 CI/CD 流水线。

关键步骤是先确认任务类型,再加载对应文档:例如云开发读 cloud-dev.md,支付读 payment.md,Skyline 读 advanced-render.md。遇到报错时,它优先匹配常见错误表,定位 env、权限、签名、Worklet 声明、分包路径等根因。

适用边界

它适合微信小程序,尤其是云开发、分包、Skyline、WXS 和 CI/CD 场景;不适合抖音/支付宝小程序、Web 端微信登录或需要商户后台直连的服务端 SDK。账号注册、AppID、商户号、云开发环境开通仍需人工完成;技能主要负责代码结构、配置生成、排错和工程化检查。

使用场景

  • 上线前检查主包体积与分包路径,用 analyze_subpackages.py 生成 app.json 配置。
  • 处理云函数 500、数据库权限拒绝或 env 不一致,定位 cloud.init 与权限规则。
  • 重构登录与头像昵称采集,替换废弃的 wx.getUserInfo 为按钮和云函数鉴权。
  • 调试 Skyline Worklet 动画无效或 SharedValue 不更新,补 'worklet' 声明并走 JS 线程。

适合人员

  • 负责微信小程序上线检查的前端工程师,需要排查 2MB 包体积、分包路径和 setData 卡顿。
  • 维护云开发后台的全栈工程师,需要配置云函数 env、数据库权限、聚合查询与事务。
  • 交付小程序支付与登录功能的全栈工程师,需要核对 JSAPI 签名、订单回调和退款状态。
  • 负责活动页与动效的客户端工程师,需要实现 Skyline Worklet 动画并避免主线程阻塞。