微信小程序设计与工程交付
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c25e780d/build-wechat-miniprogram。
技能介绍
解决的问题
微信小程序的工程交付往往在环境配置、渲染器差异和云端状态管理之间反复踩坑。开发者常将开发者工具编译通过与真机业务成功混为一谈,或在 wx.cloud.init()、微信登录态与业务用户资料之间产生身份混淆。此外,内容审核的 pending 状态管理、Skyline 与 WebView 的样式差异,以及 npm workspace 组件缺失,都是导致线上故障的常见根源。
核心能力与工作流
该技能采用任务路由机制,根据当前需求动态加载 core-guidelines、project-engineering 或 platform-cloudbase 等参考文档。其核心工作流强调沿实际调用链取证:从页面事件到请求封装,再到云函数与数据库,逐层定位失败点而非盲目修改代码。
- 工程初始化:规范目录结构、npm workspace 及
miniprogram_npm构建映射。 - 内容审核闭环:严格追踪
draft→platform audit→callback→approved状态,仅在明确pass时自动发布。 - 分层验证阶梯:从静态 lint、开发者工具构建,到云资源环境核对与真机/体验版抽查,确保各层证据独立且可信。
适用边界与硬性约束
使用该技能时需严格遵守工程边界。首先,绝不在客户端或日志中写入 AppSecret 等敏感凭证,且授权与角色必须在服务端校验并默认拒绝异常状态。其次,不要假设 WebView 的 DOM 行为在 Skyline 中完全等价,涉及 Skyline 时需在目标渲染器中单独验证长文案与字体放大。最后,禁止信任客户端传入的 UID 或审核结论,敏感结果必须由可信服务端生成和校验,也不得以统计或恢复登录为由强制初始化认证 SDK。
使用场景
- 在初始化小程序项目时配置npm workspace,并修复组件找不到的构建报错。
- 排查CloudBase云函数本地测试通过但线上小程序报错的环境与权限不一致问题。
- 追踪头像上传后一直处于审核中的状态,核对审核任务、回调传输及线上日志。
- 解决Skyline渲染器中长文案被截断或固定高度样式不生效的问题。
适合人员
- 负责微信小程序从代码编写到真机验收的开发工程师,需要确保分层验证证据完整。
- 处理微信生态内用户生成内容的客户端开发者,需要严格管理内容审核状态与权限校验。
- 负责小程序视觉与交互还原的前端工程师,需要在渲染差异下保证长文本准确呈现。