weapp-devtools-e2e-best-practices
用途
统一 WeChat DevTools runtime e2e 的写法和验证顺序，避免重复启动 automator、脆弱导航和不稳定的 IDE 自动化。
何时使用
- 用户要新增或修改
e2e/ide/**。 - 用户要用
miniprogram-automator做真实运行时断言。 - 用户问
launchAutomator该怎么复用。 - 用户问是否该用
miniProgram.reLaunch(...)。 - 用户要把 e2e 和 screenshot / compare / logs 串成验收链路。
- 用户要通过 MCP 的
weapp_devtools_*/weapp_runtime_*工具检查真实运行时页面。
不适用场景
本 skill 聚焦 DevTools runtime e2e。
- CLI 设计和命令分发：使用
weapp-vite-best-practices。 - 构建配置：使用
weapp-vite-best-practices。 wevu运行时语义：使用wevu-best-practices。
核心流程
- 先确认环境前提：
- WeChat DevTools 已登录 - 服务端口已开启 - 目标 app 使用真实 AppID
- 同一个
e2e-app在同一 suite 只启动一次 automator，并在describe级别共享。 - 多场景优先用
miniProgram.reLaunch(route)切换，不要为了切页反复重启 DevTools。 - 断言优先页面级、结构级、可稳定复用的 runtime 收集器；截图验收放在路由稳定之后。
- MCP 场景下，先用 weapp_devtools_connect，再用 weapp_devtools_route / weapp_runtime_find_node / weapp_devtools_console。
- 新增页面时同步：
- project.private.config.json 的 condition.miniprogram.list - project.config.json 的真实 AppID
- 按顺序验证：
- node --import tsx scripts/check-e2e-ide-shared-launch.ts - 目标 IDE e2e 文件 - 需要视觉回归时再补 wv screenshot --json、wv compare --json、wv ide logs --open
约束
- 不要在同一
e2e-app重复启动 automator。 - 不要为切页面反复重启 DevTools。
- 不要在路由不稳定时先做截图对比。
- 不要把环境问题误判成业务回归。
输出
应用本 skill 时，输出必须包含：
- suite 结构。
- 页面切换方案。
e2e-app配置同步项。- 最小验证命令。
完成标记
- automator 启动已复用。
- 多场景通过
reLaunch串联。 - 条件页和 AppID 已同步。
- 已跑共享启动检查和目标 IDE e2e。
参考资料
references/runtime-e2e-checklist.md