Agent Skills
返回列表
微信小程序 AI 自动化测试

微信小程序 AI 自动化测试

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_d6c5fee7/miniprogram-auto-test。

技能介绍

要解决的痛点

微信小程序 UI 自动化长期依赖官方 miniprogram-automator,但在当前开发者工具版本上,page.$()、page.setData() 等 Page./Element. 协议整族会超时;文档里的 page.$('.btn').tap() 往往跑不通。与此同时,Windows 上 Node ≥18.20 调用官方 launch() 还可能因 spawn EINVAL 误判成路径问题。团队若仍按旧文档手写脚本,会在「选不到元素」和「起不来工具」之间反复踩坑。

技能如何工作

本技能面向 AI 辅助生成脚本,不是实时看屏点按钮的 GUI agent。典型流程是:你给出页面目录(如 pages/home/)和一句话测试目标;助手读取 index.wxml 与 index.js/ts,从 WXML 静态解析 bindtap/bindinput 的 handler 名(运行时拿不到绑定关系),再结合页面逻辑生成可执行的 *.test.js。生成侧会主动处理两类关键细节:元素被 wx:if 隐藏时先用 page.setData() 摆状态,再 waitForSelector;点击用 page.tap(sel, 'handlerName') 直接调页面方法。底层建议使用项目提供的 miniprogram-automator-next:在 evaluate 上重建 tap/query/setData,并修复 Windows 下的 launch 问题。

适用边界与注意点

  • 环境:强依赖本机已启动过的微信开发者工具,并开启服务端口、CLI/HTTP、默认信任项目;仅 Win/Mac 本机,不能 Linux/CI/云端。
  • 能力边界:createSelectorQuery 只支持有限选择器;页面级查询不跨自定义组件;真实登录/下单类 handler 可能触发真实请求,需 mock 或只做「被调起」断言。
  • 协作约束:不修改 project.config.json;测试数据用占位;生成文件避免覆盖已有同名脚本。

使用场景

  • 新页面登录拦截逻辑复杂,需要从 WXML 抄 handler 名生成 tap 流程脚本
  • 首页列表被 wx:if 控制展示,想用 setData 摆状态后断言元素数量
  • 改版后怀疑官方 page.$ 已失效,需要按 evaluate 路线重写一段可跑通回归
  • 本地 Windows Node 24 上 launch 报 EINVAL,要用修复版启动并跑 node xxx.test.js

适合人员

  • 负责小程序交付的前端,想在发版前用本机 DevTools 跑页面级回归而不是纯手工点测
  • 维护 miniprogram-automator 脚本的工程师,被 Page.* 全超时困住需要迁移到 automator-next API
  • 带实习生的技术负责人,希望把「读 wxml + 写测试」收成可复用的 AI 工作流
  • Windows 环境下写 Node 测试的同学,launch 被误判为 cliPath 需要对照 SKILL 排查