安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install game-qa
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 game-qa。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

游戏 QA 是一种基于证据的 Openclaw Skills 工作流，用于检查候选游戏构建能否在选定的运行时中正常运行。它会验证一次真实运行所需的六个部分：启动、渲染、输入、核心循环、至少一种设计好的结果，以及重启。结果是一份以执行证据为依据的结构化记录，而非基于假设或仅凭代码检查得出的结论。
此技能将技术验证与关于趣味性、平衡性、完善度或是否适合发布的主观判断区分开来。它遵循项目的产品和构建简报，只检查已获批准的设计承诺，并将差距报告为明确的限制，而不是编造通过状态。

应用场景

在分享给测试人员之前，验证生成的游戏或候选构建。
检查游戏能否在指定的目标运行时完成最低限度的可玩循环。
确认真实输入会改变游戏玩法，并且能够达成一种设计好的结果。
验证玩家在达成结果后能否重启游戏。
使用获批准的模型、事件日志、补丁或签名命令调查运行时故障。
生成有证据支撑的 QA 记录，同时清楚记录未经验证的区域和限制。

工作原理

阅读 QA 合约和测试设计方法，然后确定目标运行时、受测运行时以及权威验证流程。
将运行时详情与 PRODUCT_BRIEF 和 BUILD_BRIEF 进行比较；报告冲突，而不是猜测。
在受测运行时中，从干净启动开始，依次执行核心操作、达成一种设计好的结果并重启，完成权威验证。
记录命令、退出代码、环境、全部六项必要检查的结果、最低限度的支持证据以及观察到的故障。
将行为与获批准的 GAME_DESIGN 不变量和结果标记进行比较，重点关注可能改变结果的承诺，而非穷尽测试每条代码路径。
如果候选构建提供受支持的模型、事件日志、补丁或签名命令，则在适当情况下使用测试设计方法进行诊断并重新运行；最终六项检查的证据必须基于一次完整运行。
将 QA 事实保存到 qa/verification.json，并将缺失的覆盖范围和问题责任方记录为结构化限制。

配置指南

准备好此技能的参考文档：references/qa-contract.md 和 references/test-design-method.md。
准备候选构建及其项目背景资料，包括适用时的 PRODUCT_BRIEF.md、BUILD_BRIEF 和 GAME_DESIGN。
确定声明的 targetRuntime、可用作 testedRuntime 的环境以及权威验证命令。在运行 QA 之前解决简报中的冲突。
在受测运行时中从干净启动开始运行权威验证。优先使用项目现有的可观测性；只有在无法以其他方式判定结果时，才添加最少量的测试钩子。
将证据和任何限制写入 qa/verification.json。

运行项目指定的权威验证命令。

将此占位符替换为实际命令；此技能不规定通用测试运行器。

数据架构

qa/verification.json 是此技能生成的 QA 事实的唯一来源。其详细字段和证据要求定义在 references/qa-contract.md 中；此技能不会强加未记录的架构。
验证记录必须包含命令和退出代码、执行环境、每项必要检查的结果及最低限度的证据，以及实际故障。覆盖范围必须包括：
检查项 证据目标
launch 候选构建能在受测运行时中启动。
render 正在运行的游戏能够可视化渲染。
input 能够接收真实输入。
coreLoop 核心游戏玩法循环正常运行。
outcome 至少一种设计好的结果已达成或得到验证。
restart 达成结果后游戏能够重启。
记录限制，并按产品、设计、美术或构建责任方对问题分类。缺少覆盖范围属于结构化限制，不得捏造 PASS_WITH_GAPS 状态。未运行或失败的必要检查不能作为总体 PASS 的依据。

高级特性

使用权威运行时验证流程，覆盖从干净启动到重启的完整生命周期。
在测试设计合约涵盖且候选构建提供相应功能时，支持使用可执行模型、事件日志、补丁或
signature_command
进行定向诊断和重新运行。
即使调查过程中使用了诊断运行，全部六项检查的最终证据也必须来自同一次完整运行。
检查获批准的设计不变量和结果标记，而不要求穷尽覆盖所有代码路径。
优先使用现有可观测状态；仅在判定结果确有需要时添加最少量的测试钩子。
不强制使用特定框架、测试库或调试接口，并将限制与关于趣味性、平衡性或发布质量的主张明确区分。

name: game-qa description: "Verify a game with evidence on its selected target runtime. Launch the actual build and prove real rendering, input, the core loop, at least one designed outcome, restart, and explicit limitations without dressing subjective fun up as a certain verdict. Use for test a generated game, QA a game build, check whether the game is fully playable, or verify the build. 游戏证据化质量验证。在选定的目标运行环境中启动实际构建，证明真实渲染、输入、核心循环、至少一个设计结果、重开和明确限制，不把主观趣味包装成确定性结论。用于测试生成游戏、检查游戏能否完整游玩或验证构建。"

游戏质量验证

验证当前候选能否完成最小可玩闭环，不把自动化结果包装成趣味、平衡、权利或发布质量结论。

读取 qa-contract.md 定判据，按 test-design-method.md 设计最少但有区分力的检查。

产物语言由 PRODUCT_BRIEF.md 锁定；未锁定时跟随对话语言，不默认产出中文。

唯一必需合同

每个候选都必须用真实运行证据覆盖：launch、render、input、coreLoop、outcome、restart。 targetFinish 描述成色，不改变这组六项，也不得生成第七道门。

执行
读取 targetRuntime、testedRuntime 和权威 verify；与 PRODUCT_BRIEF/BUILD_BRIEF 冲突时先报错， 不由 QA 猜值。
运行权威 verify：它在 testedRuntime 从 clean start → 核心动作 → 设计结果 → restart 完成整条路径，并记录 command、exit code、环境、六项结果、最小证据和实际失败。
对照 GAME_DESIGN 中会改变结果的不变量和结束标记；只验证批准的设计承诺，不遍历所有 代码路径。
若候选有可执行模型、事件日志、patch 或 signature_command，按 test-design-method 的对应合同把 项目回归嵌入权威 verify；允许定向诊断、修复和复跑，最终六项证据必须来自同一次完整运行。 失败映射到已有 checks 或 limitation，不新增通用门禁。
记录 limitation 和问题的 product/design/art/build 归属。

优先使用已有可观察状态；只有无法判断结果时才增加最小测试钩子。不要为了 QA 重构游戏或强制某种 框架、测试库或调试接口。

输出
qa/verification.json：唯一 QA 事实源；字段与证据要求见 qa-contract.md。

缺口写结构化 limitation，不发明 PASS_WITH_GAPS；未运行或失败的必需项不能满足整体 PASS。

小说游戏分析
游戏构建执行