SuperAPI AI 工具集

qa-game

测试与质量

查看项目

更新于 10-15 15:49

技能介绍

该技能用于给已有游戏项目添加 Playwright 自动化 QA 测试,相当于为游戏建立安全网。它会先分析游戏:读取 package.json 判断引擎与端口、读取 vite.config.js、src/main.js、GameState.js、EventBus.js、Constants.js 及各场景文件,并参考 design-brief.md 中记录的机制与胜负可达性。

主要能力分四类:功能测试 game.spec.js 覆盖启动、场景切换、输入处理、计分、游戏结束与重启;视觉回归 visual.spec.js 对稳定场景截图比对,需跳过含运动物体的游玩画面;性能测试 perf.spec.js 检查加载时间预算、FPS 与画布尺寸;设计意图测试检查胜负条件是否成立、AI 压力是否产生实质状态变化,并审计实体交互的不对称性并以注释标记。

使用方式:执行 /qa-game 并传入游戏路径(如 /qa-game examples/flappy-bird),无路径则用当前目录。流程包括安装依赖 npm install -D @playwright/test @axe-core/playwright && npx playwright install chromium,创建 playwright.config.js,暴露 window.GAME、window.GAME_STATE、window.EVENT_BUS、window.EVENTS,建立 tests/e2e、tests/fixtures、tests/helpers 结构,并生成测试。运行命令:npx playwright test、npx playwright test --update-snapshots,以及 npm test、npm run test:headed、npm run test:ui。

限制:视觉测试首次失败属预期,需先生成基准快照;交互不对称仅标记不强制失败;具体测试数量与结果取决于实际游戏内容,资料未提供固定数量保证。