mcpField
M
miniapp-devtools-gui-check

miniapp-devtools-gui-check

github.com/sun-sunshine06测试与质量2838 次安装6 天前更新
代码仓库

关于 miniapp-devtools-gui-check

当 CLI preview 无法提供足够信息时，用于通过 GUI 检查小程序运行情况的技能。它指导执行小范围冒烟测试，并依据证据区分应用、主机、会话和本地服务问题。

主要功能

  1. 01GUI 运行时冒烟检查
  2. 02按路由或流程限定测试
  3. 03检查报告与跟踪日志
  4. 04按阶段分类故障
  5. 05诊断主机与会话问题

适用场景

  1. 01在真实主机中检查小程序路由
  2. 02通过 trace.log 诊断报告缺失
  3. 03区分应用缺陷与 DevTools 问题
  4. 04收集运行时证据再报告结果

安装

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

$npx skills add https://github.com/sun-sunshine06/miniprogram-skills --skill miniapp-devtools-gui-check

安装后在 Claude Code 中输入/miniapp-devtools-gui-check确认已加载。

包含的文件

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

agents/
openai.yaml
references/
example-prompts.md
gui-check-playbook.md

详细介绍

小程序开发者工具 GUI 检查

概述

当 CLI preview 不够用、用户需要 GUI 侧运行时证据时，使用此技能。优先用于冒烟覆盖，而非完整视觉回归。

快速开始

  1. 阅读 references/gui-check-playbook.md。
  2. 确认运行将在真实宿主机上进行，而非受限沙箱内。
  3. 先从一条路由或一个用户流程开始，而非整个应用。
  4. 如果仓库提供了本地 GUI 检查器，运行它。
  5. 在声称成功或失败之前，检查生成的 report.json。
  6. 如果缺少 report.json，先检查同一运行目录下的 trace.log，再归咎于仓库代码。

核心规则

  • 将宿主环境视为被测系统的一部分。
  • 在会话稳定之前，优先进行窄范围的冒烟检查，而非"一次检查所有路由"。
  • 比起截图，更信任运行时异常、控制台事件、页面路径和选择器是否存在。
  • 将截图视为尽力而为的证据，而非主要信号。
  • 保持检查器由配置驱动，使路由规格、后端前置条件和输出位置都显式声明。
  • 如果运行目录包含 trace.log 但没有 report.json，先按阶段对失败分类：
    • 启动器或 websocket 阶段通常意味着 DevTools 会话或宿主设置问题
    • 页面阶段通常意味着路由级运行时或状态问题
  • 区分仓库 bug、DevTools 会话问题、本地服务阻塞和剩余的仅视觉问题。

输出格式

回答时，保持结果的可操作性：

  1. 检查了哪条路由或流程
  2. 自动化是否真正连接成功
  3. 收集了哪些运行时证据
  4. 问题是出在仓库代码、会话状态、本地服务依赖，还是仍需人工视觉确认
  5. 下一条命令或用户操作

资源

  • references/gui-check-playbook.md：宿主前置条件、失败分类和报告指南
  • ../../tools/wechat-gui-check/README.md：公共测试框架的当前提取目标
  • references/example-prompts.md：可复用的触发示例和评估说明

评论

支持 Markdown