game-qa

GitHub

用于网页游戏证据化质量验证。检查构建、渲染、核心循环、本地化及首次上手体验,确保核心幻想被真实演绎。不依赖主观趣味评分,通过客观证据判定PASS/FAIL,生成QA报告与试玩协议。

skills/game-qa/SKILL.md worldwonderer/novel-to-game

触发场景

测试生成的网页游戏 验证游戏是否可完整游玩 检查游戏构建完整性

安装

npx skills add worldwonderer/novel-to-game --skill game-qa -g -y
更多选项

不安装直接使用

npx skills use worldwonderer/novel-to-game@game-qa

指定 Agent (Claude Code)

npx skills add worldwonderer/novel-to-game --skill game-qa -a claude-code -g -y

安装 repo 全部 skill

npx skills add worldwonderer/novel-to-game --all -g -y

预览 repo 内 skill

npx skills add worldwonderer/novel-to-game --list

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 锁定;未锁定时跟随对话语言,不默认产出中文。

执行

  1. 从项目脚本和 BUILD_BRIEF.md 发现运行方式,使用现有浏览器测试能力。提取不变量以 BUILD_BRIEF.md 回写后的「# 范围」与「最终范围对照」为依据;发现 brief 范围与代码 不一致(如 brief 三战、代码六战)先记 major 要求回写再验。
  2. 启动真实页面,记录构建失败、页面异常、控制台错误和关键资源失败。
  3. 证明画面非空且会变化;画布元素存在本身不算渲染成功。
  4. GAME_DESIGN.md 提取会改变结果的关键不变量:把每个数值门槛、结局条件、破裂/冷却 条件,以及「三段弧」每期的结束标记与新增动词 / 可达空间、BUILD_BRIEF 的「同玩法动词 清单」,抄成期望表落盘 qa/evidence/design-invariants.md,逐项对照引擎常量或运行态 取值,记录一致或漂移及证据。后两项要跑实测取证,核对文档写没写不算数。
  5. 使用真实输入走核心动作、进程变化、设计要求的结果和重开;确定性系统至少复现一次 相同状态与输入得到相同结果。
  6. 在目标视口检查遮挡、溢出、文字和控件可操作性;逐一切换策划要求的界面语言, 检查缺字、截断、阅读顺序、术语一致性和关键玩法信息。 视口、界面语言、控制方式与内容尺度按 PRODUCT_BRIEF.md 的目标平台与分级核对: 竖屏/横屏、单局结构、交互约束是否兑现,内容是否落在批准的分级内(未逾越,也未被下游 悄悄收回到更保守)。
  7. 对文化关键名称、符号和提示抽查原作语义,避免翻译或本地化改变规则与角色关系。
  8. 走一遍首次上手:先跑前提传达门——起一名不给任何策划 / 构建文档的干净上下文子代理 (两分钟理解度沿用同一名),只喂常速冷启动第一分钟按序截取的画面,四问一并作答(我是 什么 / 我要什么 / 什么会终结这一局 / 这是哪一类游戏——我主要在反复做什么、像我玩过的 哪款游戏),判据见 qa-contract 的「前提传达门」,逐字落盘 qa/evidence/premise-gate.md; 未跑或记 NOT_RUN 时首次上手不得判 PASS。再在正常速度下实测首个有意义动作与冷启动 节拍;两分钟理解度("我是谁/要什么/往哪使劲")须由未接触任何策划/构建文档的干净上下文 子代理基于顺序真实画面裁决, 无该能力时理解度记 NOT_RUN,首次上手不得判 PASS。再逐条对照 CONCEPT.md/GAME_DESIGN.md 的体验支柱与其"可观察试玩证据",确认承诺的卖点在真实游玩里被演成了场面而非只剩数字, 并检查设计写明的失败现象有没有发生。判据与协议见 qa-contract.md
  9. 每条 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

同 Skill 集合

skills/game-concept/SKILL.md
skills/game-world-design/SKILL.md
skills/novel-game-analyze/SKILL.md
skills/novel-to-game/SKILL.md
skills/game-art-direction/SKILL.md
skills/game-build/SKILL.md

元信息

文件数
0
版本
470e35d
Hash
46c69112
收录时间
2026-07-30 20:19

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-01 00:35
浙ICP备14020137号-1 $访客地图$