还记得第一次用 miniprogram-automator 写自动化测试时的绝望吗?

• querySelector() 死活选不到自定义组件里的元素
• waitFor() 不知道该等什么,测试时好时坏
• wx.request Mock 不生效,每次测试都打真实接口
• 截图对比总是因为时间戳、动画而误报

还有 CI 发布时的噩梦:

• 上传到微信后台经常超时,CI 流水线红成一片
• pnpm 项目的 npm 包打不进去,shamefully-hoist 是什么鬼?
• GitHub Actions 里 secrets 配置错了,排查半天才发现是 IP 白名单问题

我决定不再让其他人重复踩这些坑。

📦 wechat-miniprogram-skills

这是我开源的微信小程序 AI 编程技能包,基于 Skills 规范,支持 40+ AI 编程工具(Claude Code、Cursor、Windsurf、Continue、Copilot 等)。

包含两个核心 Skill:

1️⃣ miniprogram-automation - 自动化测试不再是玄学

核心能力:

• ✅ 生成可复用的 Node.js 自动化脚本(不强制 Jest)
• ✅ 处理自定义组件边界问题(.shadow()、>>> 选择器)
• ✅ 智能 waitFor 策略(等待元素、网络、页面栈)
• ✅ wx.request Mock 方案(mockWxMethod / restoreWxMethod)
• ✅ 截图 + 回归验证(console / exception 监听)
• ✅ 基于官方 miniprogram-demo 实际验证

常见触发词: "小程序自动化"、"automator"、"E2E 测试"、"选不到元素"、"mock wx.request"

实际案例:

// 自动生成的脚本会处理这些细节:
const input = await page.$('.custom-input >>> input')
await input.input('测试内容')
await page.waitFor(500) // 智能等待策略

2️⃣ miniprogram-ci - 让 CI/CD 稳如老狗

核心能力:

• ✅ 生成 pack-npm / preview / upload 独立脚本
• ✅ 内置超时重试机制(3次重试,每次等待 5 秒)
• ✅ 完整 GitHub Actions 模板(npm / pnpm 双版本)
• ✅ pnpm 兼容性配置(shamefully-hoist / public-hoist-pattern)
• ✅ secrets 管理 + IP 白名单检查
• ✅ 自动创建 GitHub Release

常见触发词: "上传小程序"、"CI 部署"、"miniprogram-ci"、"预览二维码"、"自动化发布"

实际案例:

# 自动生成的 GitHub Actions 会帮你:
- name: Upload to WeChat
  run: node scripts/upload.js
  env:
    PRIVATE_KEY: ${{ secrets.WX_PRIVATE_KEY }}

🎯 为什么要做成 Skills?

1. AI 编程时代,让 AI 直接生成正确的代码

• 不用再翻文档、查 Stack Overflow
• AI 知道如何处理自定义组件、如何配置 CI

2. 知识可复用、可迭代

• 把经验固化成 Skill,团队共享
• 遇到新坑就更新 Skill,让 AI 帮后来者避坑

3. 支持 40+ AI 工具

• 不绑定特定 IDE 或 AI 助手
• Claude、Cursor、Copilot 都能用

📥 如何使用?

# 安装整个仓库
npx skills add whinc/wechat-miniprogram-skills

# 只安装自动化测试 Skill
npx skills add whinc/wechat-miniprogram-skills --skill miniprogram-automation

# 只安装 CI 发布 Skill
npx skills add whinc/wechat-miniprogram-skills --skill miniprogram-ci

安装后,直接在 AI 编程工具中说:

• "帮我生成小程序自动化测试脚本"
• "配置小程序 CI 自动上传"

AI 会基于这些 Skills 生成经过实战验证的代码。

🤝 欢迎贡献

如果你也在小程序开发中踩过坑、总结过经验,欢迎提交 PR 补充新的 Skill!

比如:

• 小程序性能监控
• 分包加载优化
• 云开发自动化部署
• ...

让我们一起让小程序开发不再痛苦 💪

🔗 链接

• GitHub: github.com/whinc/wecha…
• Skills 规范: skills.sh