game-qa
GitHub用于网页游戏证据化质量验证。检查构建、渲染、核心循环、本地化及首次上手体验,确保核心幻想被真实演绎。不依赖主观趣味评分,通过客观证据判定PASS/FAIL,生成QA报告与试玩协议。
触发场景
安装
npx skills add worldwonderer/novel-to-game --skill game-qa -g -y
SKILL.md
Frontmatter
{
"name": "game-qa",
"description": "Verify a web game with evidence. Launch the game and check the build, console, real rendering, input and state changes, the core loop, designed outcomes, restart, target viewport, interface language, first-time onboarding, and whether the core fantasy is actually performed — without dressing subjective fun up as a certain verdict. Use for test this web game, QA a generated game, check whether the game is fully playable, verify the build. 网页游戏证据化质量验证。启动生成游戏,检查构建、控制台、真实画面、输入与状态变化、核心循环、设计要求的结果、重开、目标视口、界面语言、首次上手与核心幻想是否被演出来,不把主观趣味包装成确定性结论。用于测试生成游戏、检查游戏能否完整游玩等需求。"
}
游戏质量验证
验证游戏能否可靠运行和完成,不给“好玩”伪造客观分数。
读取 qa-contract.md 定判据,读 test-design-method.md 定怎么设计这些检查。
产物语言由 PRODUCT_BRIEF.md 锁定;未锁定时跟随对话语言,不默认产出中文。
执行
- 从项目脚本和
BUILD_BRIEF.md发现运行方式,使用现有浏览器测试能力。提取不变量以BUILD_BRIEF.md回写后的「# 范围」与「最终范围对照」为依据;发现 brief 范围与代码 不一致(如 brief 三战、代码六战)先记major要求回写再验。 - 启动真实页面,记录构建失败、页面异常、控制台错误和关键资源失败。
- 证明画面非空且会变化;画布元素存在本身不算渲染成功。
- 从
GAME_DESIGN.md提取会改变结果的关键不变量:把每个数值门槛、结局条件、破裂/冷却 条件,以及「三段弧」每期的结束标记与新增动词 / 可达空间、BUILD_BRIEF 的「同玩法动词 清单」,抄成期望表落盘qa/evidence/design-invariants.md,逐项对照引擎常量或运行态 取值,记录一致或漂移及证据。后两项要跑实测取证,核对文档写没写不算数。 - 使用真实输入走核心动作、进程变化、设计要求的结果和重开;确定性系统至少复现一次 相同状态与输入得到相同结果。
- 在目标视口检查遮挡、溢出、文字和控件可操作性;逐一切换策划要求的界面语言,
检查缺字、截断、阅读顺序、术语一致性和关键玩法信息。
视口、界面语言、控制方式与内容尺度按
PRODUCT_BRIEF.md的目标平台与分级核对: 竖屏/横屏、单局结构、交互约束是否兑现,内容是否落在批准的分级内(未逾越,也未被下游 悄悄收回到更保守)。 - 对文化关键名称、符号和提示抽查原作语义,避免翻译或本地化改变规则与角色关系。
- 走一遍首次上手:先跑前提传达门——起一名不给任何策划 / 构建文档的干净上下文子代理
(两分钟理解度沿用同一名),只喂常速冷启动第一分钟按序截取的画面,四问一并作答(我是
什么 / 我要什么 / 什么会终结这一局 / 这是哪一类游戏——我主要在反复做什么、像我玩过的
哪款游戏),判据见 qa-contract 的「前提传达门」,逐字落盘
qa/evidence/premise-gate.md; 未跑或记NOT_RUN时首次上手不得判PASS。再在正常速度下实测首个有意义动作与冷启动 节拍;两分钟理解度("我是谁/要什么/往哪使劲")须由未接触任何策划/构建文档的干净上下文 子代理基于顺序真实画面裁决, 无该能力时理解度记NOT_RUN,首次上手不得判PASS。再逐条对照CONCEPT.md/GAME_DESIGN.md的体验支柱与其"可观察试玩证据",确认承诺的卖点在真实游玩里被演成了场面而非只剩数字, 并检查设计写明的失败现象有没有发生。判据与协议见 qa-contract.md。 - 每条
blocker/major按 qa-contract 的归属定义标注build/design/product并写入 发现与回流表;标design的本轮不得PASS;回流路由由总入口执行。
BUILD_BRIEF 含动态媒体台账(视频 / 关键帧驱动演出 / 实时 3D)时,强制启用生成媒体 检查:逐镜对照参考图做漂移证伪(首 / 中 / 尾帧)、相邻镜头边界接续检查、API 证据链 核对,以及 3D 后端降级与资源释放证据核对——判据见 qa-contract.md 的生成媒体节,无台账则该节不适用。
优先使用游戏已有可观察状态;只有无法判断结果时才增加最小测试钩子。不要为了 QA 重构游戏或强制一种调试接口。
输出
生成 qa/QA_REPORT.md(阻断交付物:无它不得报完成),记录环境、命令、通过/失败项、
证据路径、未测试范围,必填「独立验证」与「发现与回流表」、附「模型试玩手记」,以及三项
主观-但-可观察裁决:首次上手 / 核心幻想演出 / 招牌帧符合(各节最小内容见 qa-contract.md)。
只有零 blocker、零 major,且加载、核心动作、主要结果和重开都有证据时才标记 PASS;
把 PASS/FAIL 裁决与一句原因文本交回总入口,gate:qa 行由总入口核对后写入
_progress.md,本阶段不自记过门。趣味、长期平衡、留存
和商业完成度留给人工试玩,但试玩工具由本阶段交付:同时落盘 qa/PLAYTEST_PROTOCOL.md。
版本历史
-
470e35d
当前 2026-07-31 13:49
修复了合并合同带来的八个缺陷:统一了前提传达门的提问措辞以匹配合约判据;修正了先例组计数逻辑避免死锁;修复了动词清单缺失、标准不一致、时间窗口混淆等配置错误。
- 827fb80 2026-07-30 20:19


