↑

微信小程序开发规范v1.0.0

cloudbase-references-miniprogram-development5 KB

覆盖微信小程序页面构建、组件开发、项目配置、调试预览及发布上线全流程,当用户提及 CloudBase、wx.cloud、云开发或需要真机预览、miniprogram-ci 自动化时触发。帮助代理正确区分小程序与 Web 开发范式,避免将 Web SDK 假设混入 wx.cloud 项目。

0 0 0 0 更新于 2026-10-28 18:24

免责声明:本站部分 Skill 来源于公开渠道,使用前请注意识别相关风险,内容版权归原作者所有,如 Skill 涉及版权问题,请在线反馈,核实后予以下架处理。

概述

本 Skill 面向微信小程序工程化开发场景,帮助代理规范处理页面与组件搭建、项目结构梳理、project.config.json 配置校验、微信开发者工具工作流、真机预览与发布等任务。当项目明确使用 CloudBase(wx.cloud / 云开发)时,提供小程序侧的鉴权、数据库、云函数集成约束,避免将 Web 登录流或 Web SDK 假设错误套用到小程序环境。产出包括符合小程序目录规范的代码结构、可编译通过的页面配置、以及适配 DevTools 或 miniprogram-ci 的调试/上传/发布指令。

技能包含

  • SKILL.md(本文件):技能主说明,涵盖触发条件、小程序通用规范、CloudBase 子场景判定、调试与发布路径选择
  • references/cloudbase-integration.md:CloudBase 小程序集成参考,含 wx.cloud API 使用、环境配置、鉴权与数据库约束

核心能力

  • 页面与组件规范搭建:按小程序目录约定生成完整页面(含 .js .wxml .wxss .json),确保配置文件不缺失、本地资源路径有效
  • 项目配置校验:检查 project.config.json 中的 appid、miniprogramRoot 等关键字段,避免预览或上传失败
  • 调试与发布路径推荐:优先使用微信开发者工具完成模拟器调试、面板审查、真机预览;工具不可用时降级到 miniprogram-ci 实现预览、上传与 npm 构建自动化
  • CloudBase 场景识别:仅在用户或代码库明确使用 CloudBase / wx.cloud / 云开发时,启用对应鉴权、数据库、存储、云函数规则,防止过度约束
  • 跨技能路由:自动关联 CloudBase 鉴权、NoSQL 数据库、UI 设计等相邻 Skill,避免重复造轮子

应用场景

用户怎么说本技能做什么
"帮我新建一个带 tabBar 的小程序页面"按小程序规范生成完整页面四件套,配置 app.json 或页面级 json,检查路径与资源引用
"预览时提示 appid 不对"核查 project.config.json 与代码中 appid 一致性,给出开发者工具或 miniprogram-ci 的修正步骤
"这个项目用了云开发,怎么拿 OPENID"读取 CloudBase 集成参考,提供 wx.cloud.callFunction 获取 OPENID 的代码范式,禁止生成 Web 式登录流
"没有 Mac 装不了开发者工具,怎么上传"切换至 miniprogram-ci 路径,给出预览、上传、npm 构建的命令行工作流与必要配置
"调试时云函数报错"区分小程序端调用与云函数本身问题,路由到对应 Skill(云函数开发或 CloudBase 数据库),避免在小程序层错误修复