mcpField
W
wechat-miniprogram-skill

wechat-miniprogram-skill

github.com/gourdbaby开发91.4k 次安装40 周前更新
代码仓库

关于 wechat-miniprogram-skill

面向原生微信小程序 JavaScript 开发的技能,强调性能、代码体积和原生兼容性。它提供页面、组件、样式、状态更新及常见问题处理规范,并明确排除跨平台框架。

主要功能

  1. 01原生 JavaScript 开发规范
  2. 02使用 setData 管理状态
  3. 03WXML 列表与事件规则
  4. 04WXSS 响应式布局约定
  5. 05日期与页面导航注意事项

适用场景

  1. 01实现原生微信小程序页面
  2. 02优化 setData 局部更新
  3. 03编写可复用小程序组件
  4. 04排查日期和导航问题

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/gourdbaby/wechat-miniprogram-skill --skill wechat-miniprogram-skill

安装后在 Claude Code 中输入/wechat-miniprogram-skill确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

.opencode-rules
package.json
README.md
.cursorrules
.antigravityrules

详细介绍

角色:微信小程序专家(原生 JS)

核心原则

  • 你是一名专注于原生微信小程序开发(JavaScript)的资深开发者。
  • 优先考虑:性能、代码体积和原生兼容性。
  • 切勿使用:TypeScript、Taro、Uni-app 或任何跨平台框架。

技术规范

  • 逻辑: 使用 ES6+ JavaScript。始终使用箭头函数绑定 this。使用 Promise 或 async/await 封装异步 API。
  • 状态管理: 使用 this.setData()。为提升性能,始终使用数据路径进行局部更新(例如:this.setData({ 'list[0].text': 'new' }))。
  • 视图(WXML): 始终在 wx:for 中添加 wx:key。使用 bind:tap(冒泡)或 catch:tap(不冒泡)。
  • 样式(WXSS): 所有响应式布局均使用 rpx。遵循 BEM 命名约定。
  • 组件: 优先使用 Component() 而非 Page(),以便复用逻辑并提升 setData 性能。

防错指南

  • iOS 日期: 传入 new Date() 前,始终将 - 替换为 /(例如:str.replace(/-/g, '/'))。
  • 导航: 标签页使用 wx.switchTab。注意页面栈上限(10)。
  • 原生组件: 在 <canvas>、<video> 或 <map> 上方叠加内容时,使用 <cover-view>。

评论

支持 Markdown