Agent Skills
返回列表
微信小程序开发助手

微信小程序开发助手

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_36c7efa2/wechat-miniapp-zh。

技能介绍

需要解决的问题

微信小程序开发与标准 Web 开发存在显著差异:它没有 DOM、windowlocalStorage(取而代之的是 wx.setStorage),路由系统基于 wx.navigateTo 而非 React Router 或 Vue Router,大部分第三方 npm 包无法使用,登录、支付等核心功能依赖微信专属 API。此外,审核流程常因不明确条款被驳回,开发者难以定位具体问题。

核心能力与关键步骤

该技能提供针对性的开发指导,核心能力包括:

  • 选型决策:对比原生开发、Taro(React 风格)和 uni-app(Vue 风格)的优劣,根据团队技术栈和多端需求推荐方案。例如,纯微信应用可选原生以优化性能,跨端项目则考虑 Taro 或 uni-app。
  • 关键 API 速查:快速查阅登录(如 wx.getUserProfile)、支付(注意证书申请和幂等回调)、订阅消息等 API 的用法和常见陷阱,避免过时或错误调用。
  • 审核避坑:总结五大驳回原因,如未提供测试账号、虚拟支付限制、诱导分享等,并给出具体修复策略,例如 iOS 端必须关闭支付入口或使用苹果 IAP。
  • 架构设计:指导云开发与自建后端的选择。云开发适合 MVP 或轻量应用,免服务器但成本较高;自建后端适用于长期产品,需处理备案和运维。

技能的工作流程是:先摸清场景(如业务类型、团队技术栈),再输出方案(如选型表、代码示例),最后通过自检清单确保覆盖版本兼容性、合规性等要点。

适用边界与注意点

该技能不替代完整业务代码编写,因场景过多无法一概而论;不涉及 UI 设计或支付证书申请等纯账号操作。开发者需注意:

  • 合规性:隐私协议必须配置(如 app.json__usePrivacyCheck__: true),用户数据收集需最小化,第三方 SDK 需在协议中列出。
  • 成本考量:云开发在 DAU 上升时费用激增,自建后端需提前处理域名备案(至少 1 个月)。
  • 内容安全:用户输入必须通过 security.msgSecCheck API 进行安全检查。

通过聚焦这些方面,该技能帮助开发者高效导航微信小程序开发的复杂性,但需结合具体业务需求灵活应用。

使用场景

  • 当团队需要从零开始开发微信小程序,评估原生、Taro 或 uni-app 的优缺点时,使用技能进行选型决策。
  • 在集成微信支付功能时,遇到证书申请复杂、回调处理不确定的问题,查阅 API 速查指南获取解决方案。
  • 小程序提交审核后收到“违反条款”驳回,但原因不明,使用技能分析五大驳回原因并实施修复。
  • 选择后端架构时,根据 MVP 阶段预算和长期维护需求,决定使用云开发还是自建服务器。

适合人员

  • 负责微信小程序新项目的技术经理,需在 React 和 Vue 团队间做出技术选型决策。
  • 独立开发者,计划用云开发快速推出 MVP,但担心成本控制和后期迁移问题。
  • 前端工程师,刚接手微信小程序项目,对支付 API 集成和审核流程不熟悉,需要快速上手。
  • 创业团队的产品负责人,必须确保小程序符合隐私协议和内容安全法规,避免审核驳回。