关于 game-playtest
用于按玩家体验测试浏览器游戏的技能，检查启动、输入、场景变化、HUD 可读性和视觉状态。面向游戏开发者，可借助浏览器自动化、截图或结构化手动测试发现可复现问题。
主要功能
- 01测试启动和核心输入
- 02审查截图与视觉状态
- 03分别检查 HUD 和渲染层
- 04检查 2D、3D 与响应式表现
- 05附复现步骤报告问题
适用场景
- 01发现玩法和界面回归
- 02排查渲染或性能问题
- 03检查移动端和桌面视口表现
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/game-playtest确认已加载。
附带文件agents/openai.yaml
详细介绍
游戏试玩测试
概述
使用此技能从玩家的体验角度测试浏览器游戏：从启动、输入、场景切换、HUD 可读性到视觉状态变化。若项目支持，优先使用浏览器自动化和截图审查。
首选工作流
- 启动游戏，并确认第一个可操作的界面。
- 测试主要操作。
- 截取具有代表性的状态。
- 独立检查 UI 层和渲染层。
- 按严重程度排序报告发现，并提供复现步骤。
工具指南
- 优先使用仓库中已有的 Playwright 或同类浏览器自动化工具。
- 如果游戏大量使用 Canvas 或 WebGL，必须截图，因为仅断言 DOM 会漏掉视觉回归。
- 使用截图评估游戏区域遮挡和 HUD 占比，而不只是文本或布局是否正确。
- 如果无法进行确定性自动化，则进行结构化的手动测试并留存证据。
- 对于 3D 渲染错误或无法解释的帧耗时，不要仅凭代码猜测；应使用 SpectorJS 和浏览器性能工具。
常见检查项
2D 检查
- 精灵对齐和基线一致性
- 受击或受伤动画的可读性
- HUD 与游戏区域重叠
- 命令菜单状态变化
- 瓦片或平台的可读性
- 输入状态反馈和回合状态的清晰度
3D 检查
- 首次加载时的可玩性，以及界面是否显得像仪表板
- 常驻叠加层对游戏区域可见性的影响
- 摄像机控制和重置行为
- 打开菜单和叠加层时，指针锁定或拖动视角的状态切换
- 深度可读性和轮廓清晰度
- 正常游戏期间，次要面板是否已折叠或可关闭
- 窗口尺寸调整行为
- WebGL 上下文丢失或渲染器回退行为
- 材质或光照回归
- GLB 或纹理流式加载卡顿
- 碰撞代理与物理效果不匹配
- 与后期处理或资源加载相关的性能骤降
响应式与浏览器检查
- 桌面和移动视口是否正常
- 适用时检查安全区域和刘海屏问题
- UI 过渡的减少动态效果行为
- 键盘、指针和暂停状态处理
- 项目使用 React Three Fiber 时，React 状态与场景状态的同步
报告标准
先列出发现。每项发现都应具体说明：
- 用户看到的情况
- 复现方法
- 影响
- 可能归属的子系统
参考资料
- 共享架构：
../web-game-foundations/SKILL.md - 前端审查要点：
../game-ui-frontend/SKILL.md - 3D 调试说明：
../../references/webgl-debugging-and-performance.md - 完整检查清单：
../../references/playtest-checklist.md
评论
支持 Markdown