关于 wechat-miniprogram-skill
面向原生微信小程序 JavaScript 开发的技能,强调性能、代码体积和原生兼容性。它提供页面、组件、样式、状态更新及常见问题处理规范,并明确排除跨平台框架。
主要功能
- 01原生 JavaScript 开发规范
- 02使用 setData 管理状态
- 03WXML 列表与事件规则
- 04WXSS 响应式布局约定
- 05日期与页面导航注意事项
适用场景
- 01实现原生微信小程序页面
- 02优化 setData 局部更新
- 03编写可复用小程序组件
- 04排查日期和导航问题
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ gourdbaby/ wechat-miniprogram-skill --skill wechat-miniprogram-skill安装后在 Claude Code 中输入/wechat-miniprogram-skill确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
.opencode-rulespackage.jsonREADME.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