Trigger Scenarios

测试生成的游戏 QA 游戏构建版本检查游戏是否可完整通关验证构建版本可用性

Install

npx skills add zenstory-ai/novel-to-game --skill game-qa -g -y

More Options

Use without installing

npx skills use zenstory-ai/novel-to-game@game-qa

指定 Agent (Claude Code)

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

安装 repo 全部 skill

npx skills add zenstory-ai/novel-to-game --all -g -y

预览 repo 内 skill

npx skills add zenstory-ai/novel-to-game --list

SKILL.md

Frontmatter

{
    "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 只代表视觉与制作完成度，不增减这六项基础门禁。

执行

读取 BUILD_BRIEF.md 中的 targetRuntime、testedRuntime 和权威 verify 命令；若与 PRODUCT_BRIEF.md 或 BUILD_BRIEF.md 前后矛盾，立即报错退回，不由 QA 自行猜测填补。
在 testedRuntime 中运行权威 verify 命令：从纯净初始状态（clean start）出发，依次走完「核心动作 → 达成设计结局 → 重开回到初始状态」整条路径，如实记录执行的命令、退出码、运行环境、六项检查结果、实机观察记录和暴露的实际故障。
对照 GAME_DESIGN.md 中会改变结局走向的硬规则和通关标记，只验证已批准的设计承诺，不追求走遍每一行底层代码分支。
若项目包含可执行改编模型、事件日志、热修补丁或 signature_command，按 test-design-method.md 的对应要求把回归用例并入权威 verify 命令；排查期间允许做单点诊断、修复和重跑，但最终写入 qa/verification.json 的六项结果必须来自同一次完整运行。任何专项回归失败均需映射到上述六项检查或记入 limitations。
如实记录未覆盖的限制项（limitations），并将发现的问题按 product / design / art / build 职责归属指派回对应环节。

验证时优先读取游戏已有的可见状态与 DOM/画面输出；只有在外部完全无法观测关键结果时，才添加最小化的测试钩子。

输出

qa/verification.json：唯一的实机验收记录文件（字段要求与记录格式见 qa-contract.md）。

尚未覆盖的测试盲区统一写入结构化的 limitations 数组，绝不生造 PASS_WITH_GAPS 之类的折中状态；只要有任一必测项未运行（NOT_RUN）或失败（FAIL），顶层状态就不得标为 PASS。

Version History

48226e3 Current 2026-11-07 12:24
润色中文表述，清理生硬译腔与自造词，对齐跨仓库项目表格和章节引用。
84a2257 2026-11-02 11:10
清理重复规则，移除不存在的规则否定表述，精简技能文档。
d76cdca 2026-09-22 01:58
重构技能文档，移除重复的规则陈述和已失效的否定性约束，精简冗余内容。
b21d0cd 2026-09-08 20:14
简化指导说明并明确验证边界；移除防御性及重复代码，合并冗余逻辑，清理无用常量与死代码，优化提示词预算。
57b54fa 2026-08-27 10:07
新增可重放适配契约，包括风险匹配的白盒、确定性状态权威、身份特定命令交接及轻量级可执行模型契约。
2678f35 2026-08-19 12:24
简化QA流程并拆分过大模块；恢复可审计的QA证据链及兼容性支持；优化Plateau外观元数据紧凑性。
45f3083 2026-08-12 21:31
精简技能内容以控制行数预算，删除重复规则，修正结构语法规则归属，并引入行数字机制防止Prompt无限膨胀。
732b5b6 2026-08-12 09:34
重构简化 QA 流程，将判定逻辑统一为单一的证据支持路径，移除基于 assuranceProfile 的多档位分支判断。
19104bd 2026-08-08 08:19
新增互动文字小说作为一等公民支持，修正概念筛选中拒绝纯阅读/点击玩法的缺陷；引入经验档案追踪叙事断言（如分支可达、旗标消费）；重构判定公式，明确assuranceProfile与experienceProfile的职责分离。
db8bc29 2026-08-05 15:08
新增首次上手体验验证（前提传达门）；强化画面非空证明及碰撞检测细节；增加界面语言与文化语义审计步骤。
9d7f873 2026-08-02 21:56
新增受控且基于证据的TTS生产检查，将语音作为明确的艺术方向选择，包含权利证据、字幕映射、静音降级及强制人工试听等硬性否决项。
470e35d 2026-07-31 13:49
修复了合并合同带来的八个缺陷：统一了前提传达门的提问措辞以匹配合约判据；修正了先例组计数逻辑避免死锁；修复了动词清单缺失、标准不一致、时间窗口混淆等配置错误。
827fb80 2026-07-30 20:19