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

微信小程序开发

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-miniprogram-development。

技能介绍

解决什么问题

微信小程序项目经常卡在工程约定和工具链细节:页面缺少 index.json、project.config.json 里的 miniprogramRoot 或 appid 没确认、tabBar 图标路径缺失导致编译失败,或者把 Web SDK 登录流程误用到 wx.cloud 项目里。这个技能把这些检查点整理成给编码 Agent 使用的开发规范,减少在错误场景下生成代码。

技能如何工作

它先按微信小程序通用范围处理任务,不默认假设项目使用 CloudBase,并把通用小程序流程、CloudBase 子场景和调试发布路径分开处理。核心能力包括:

  • 维护 app.js、pages/index/index.js、index.wxml、index.json 等最小骨架。
  • 在预览、上传或打开 IDE 前检查 project.config.json、appid 与路径配置。
  • 处理本地资源引用,尤其默认建议使用 tabBar.custom = true 的纯文字自定义 tabBar,避免未下载的图标资产。
  • 将调试、预览、发布路由到微信开发者工具或 miniprogram-ci 回退路径。
  • 当出现 wx.cloud、CloudBase、云开发、数据库、存储、身份等关键词时,再进入 CloudBase 子场景并读取对应集成规范。

适用边界

它面向微信小程序开发,不适用于纯 Web 前端、纯后端云函数、仅 UI 设计,以及微信支付回调、退款、公众号 OAuth 等支付/认证细节。涉及 CloudBase 时,不应把平台约束套到非 CloudBase 项目;改代码或上传前还应遵守变更安全与部署检查流程。

使用场景

  • 在微信小程序新增页面时,补齐 index.js、WXML、JSON 并检查 project.config.json。
  • 用微信开发者工具调试预览前,确认 appid、miniprogramRoot 与 tabBar 资源路径。
  • 项目接入 wx.cloud 时,区分 CloudBase 身份、文档数据库与普通小程序流程。
  • 在没有微信开发者工具时,用 miniprogram-ci 完成预览、上传和 npm build。

适合人员

  • 负责微信小程序页面重构的前端工程师,需要快速确认页面文件、配置和 tabBar 规则。
  • 维护 wx.cloud 项目的工程师,需要区分 CloudBase 集成约束和普通小程序开发流程。
  • 使用微信开发者工具交付小程序的开发者,需要在预览和上传前检查 appid 与路径。
  • 缺少 DevTools 环境的 CI 工程师,需要用 miniprogram-ci 完成预览、上传和构建。