game-build
Build a risk-matched whitebox or the approved production game for its target runtime. Turn GAME_DESIGN, and ART_DIRECTION when production begins, into a minimal BUILD_BRIEF and a runnable candidate that can be iterated with replayable evidence. Use for prototype the riskiest design question, implement the approved game design, or turn this design into a running game. 游戏构建执行。先按最大风险做白盒,或在正式生产时把批准后的 GAME_DESIGN 与 ART_DIRECTION 压缩成最小 BUILD_BRIEF,在目标运行环境中实现可运行候选并用可回放证据迭代。用于验证高风险设计问题、构建游戏原型或实现批准方案。
git clone --depth 1 https://github.com/zenstory-ai/novel-to-game /tmp/game-build && cp -r /tmp/game-build/skills/game-build ~/.claude/skills/game-buildSKILL.md
# 游戏构建执行 保护已批准的体验边界;正式生产时再保护已批准的美术边界。驱动实现模型完成真实可玩的候选,不在 构建阶段重新做概念、关卡或美术方向。 读取 [build-brief-contract.md](references/build-brief-contract.md) 与 [playable-model-contract.md](references/playable-model-contract.md)。白盒阶段必须已有 `GAME_DESIGN.md`; 完整候选还必须已有 `ART_DIRECTION.md`。缺产品决定时回对应 owner,不在 BUILD_BRIEF 就地发明。 产物语言由 `PRODUCT_BRIEF.md` 锁定;未锁定时跟随对话语言,不默认产出中文。 ## 目标与自由 按 PRODUCT_BRIEF 锁定的平台、生产引擎、目标运行时、显示/输入、范围、分级和联网边界交付。 目标工具链不可用时不得自动改做网页;只有 brief 已批准替代运行时才可使用,并分开记录 `targetRuntime`、`testedRuntime` 与未覆盖项。 正式生产继承美术方向的明度边界。非低照度题材不得在实现阶段擅自用全局黑罩、暗角、降曝光或低对比 小字制造“电影感”;夜景也要保留人物、器物、行动与结果可读性。确需偏暗的界面只按已批准范围实现, 并保留方向中约定的亮度或高对比 fallback。 时代题材的高风险画风先接入一张实际目标图并在目标视口确认,再批量生产。目标图已批准后,后续资产 必须继承同一时代世界、表现媒介、人物成熟度、身份锚点、光色和文本留白;不得把“当代审美”擅自实现成 现代服装/棚拍,也不得把“古风”擅自实现成古画旧化。用户否决方向时停止扩批,替换运行引用并清理被 否决资产,不能让旧图、试验图和批准图混在同一发布包。 BUILD_BRIEF 只压缩产品边界、必须保真的体验事实、运行方式与完成证据,实现细节交给实现模型。 先声明 `buildStage: whitebox|production` 与 `buildPath: template|custom`。已有交互语法只有在能保留原作 独有动作、代价和世界回应时才采用;实时手感、空间、视线、物理或模板覆盖不了的核心动词走 custom。 白盒也必须选择能验证最大风险的形态,不能把所有项目降成文游。 当前会话能编码时直接实现;外部模型不可用时只交付构建说明,不声称游戏已生成。不要发送与原型 无关的完整受版权保护原文。 ## 按能力读取可选合同 - 语音策略不是 `none` 时读取 [tts-production-contract.md](references/tts-production-contract.md)。TTS 优先构建期生成成本地资产;运行时远程合成须在 brief 批准,密钥只留受信服务端。 - 实际采用动态媒体时读取 [generative-media-pipeline.md](references/generative-media-pipeline.md)。已有批准 参考图时以图约束;工具与模型按当前环境选择,不写成跨项目默认。 ## 共同构建循环 1. 先实现一个最小但完整的核心循环:启动、真实输入、状态变化、结果和重开。范围不足时修范围, 不先堆审计材料。 2. 先集中实现最小状态面与规则裁决器,再接表现层。模型可解释自由输入、提出候选动作或根据已提交结果 写对白;只有规则器能提交资源、位置、知识、承诺、物件归属、胜负与事件日志。 设计含 `signature_command` 时,先逐字继承 `id / label / intents / slots / validators / commit`,管线固定为 “表述 → 有版本的候选结构 → schema/前置/知识/承诺验证 → 执行阻力 → 确定性提交 → 叙述”;含混、冲突或越界候选返回澄清/拒绝且不提交,不能让关键词命中 或模型 `effects` 直接改状态。 3. 固定内容/规则/存档版本、初态、seed 与输入序列;事件日志记录 action、观察者和前后状态摘要。专属 命令还记录解析器版本、规范化候选、验证结果、执行轨迹和到期事项;回放消费已记录候选,不重新调用 在线模型。试玩反馈定位到节点,局部 patch 后重放失败路径和相邻反例,不让未选分支进入历史。 4. 回写实际工具链、install/build/start 命令和版本;未知值写 `NOT_AVAILABLE: 原因`,不猜。 `whitebox` 到此只运行最窄的模型/回放检查与启动 smoke,输出结构化观察并交回 design owner;不调用 `game-qa`,不写或覆盖 `qa/verification.json`,也不把白盒通过冒充生产候选完成。设计修订后重放受影响 路径,直到最大风险已被实际暴露或当前方向被否决。 `production` 继续: 5. 提供一条权威验证命令和最小可观察状态,使 `game-qa` 能一次走完 `clean start → 核心动作 → 设计结果 → restart`;构建阶段不预写 QA 结论或重复跑完整验收。 6. 运行最窄的开发检查与启动 smoke,修复构建失败、阻断日志、资源失败和崩溃;替代运行时未覆盖的 目标平台输入、性能、打包或设备项写入 limitation。 7. 达到 brief 的 `targetFinish`;更高完成度只处理已批准的焦点资产和招牌时刻,不制造与可玩闭环 无关的发布审计。 8. 交给 `game-qa` 只运行一次权威命令并写最终事实。时间、预算或生成调用用尽只会留下 FAIL/NOT_RUN,不会生成 PASS。 连续 3D、语音、生成媒体、多语言与无障碍仅在实际采用时增加项目自己的回归检查。必需异步资产 加载或解码失败不得静默换灰盒仍宣称通过;可继续的 fallback 条件见 build-brief-contract.md。 ## 输出 生成 `build/BUILD_BRIEF.md` 与实际候选;production 还生成权威验证入口。构建不生成最终 QA 结论。 截图、录制与 raw trace 只保留调试所需的最小集合;`game-qa` 是 production 完整路径与 `qa/verification.json` 的唯一 owner。
Direct game art and creative vision. Turn GAME_DESIGN into a production-level ART_DIRECTION defining a recognizable visual style, camera and composition, world and character grammar, functional colour/light/material, HUD feedback, motion and transition specs, audio direction, and a signature moment for every screen and mode. Use for what should the game look like, set the art direction, define the visual style. 游戏美术与创意方向。把 GAME_DESIGN 转成策划级 ART_DIRECTION,定义可辨识视觉风格、镜头构图、世界与角色语法、功能性色光材质、界面反馈、运动与转场规格、声音方向和每个界面/模式的签名游戏时刻。用于判断游戏应该长什么样、制定游戏美术方向等需求。
Design game concepts from a novel. From SOURCE_BIBLE and PRODUCT_BRIEF, generate three genuinely different directions on the dimensions still unlocked, then pick the most worthwhile playable prototype using hard vetoes and explicit trade-offs. Use for what game should this novel become, compare game concepts, choose a game direction for this book, decide whether this novel should become an interactive story. 小说游戏概念设计。根据 SOURCE_BIBLE 与 PRODUCT_BRIEF 在未锁定维度上生成三个真正不同的方案,用硬否决和关键取舍选择最值得做的可玩原型。用于判断小说适合做成什么游戏、该不该做成互动叙事、比较游戏方案等需求。
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. 游戏证据化质量验证。在选定的目标运行环境中启动实际构建,证明真实渲染、输入、核心循环、至少一个设计结果、重开和明确限制,不把主观趣味包装成确定性结论。用于测试生成游戏、检查游戏能否完整游玩或验证构建。
Design game experience, systems, and levels. Converge the chosen concept into one GAME_DESIGN defining the player promise, core loop, how the world responds, the systems actually needed, level pacing, feedback, failure, and a fully playable prototype. Use for design the game world, deepen the gameplay and levels, write the game design document, design the branching story structure, scenes, dialogue and consequences. 游戏体验、系统与关卡策划。把选定概念收束为一份 GAME_DESIGN,定义玩家承诺、核心循环、世界响应、必要系统、关卡节奏、反馈、失败和可完整游玩的原型。用于设计游戏世界、深化玩法和关卡、设计互动叙事的场景对白与分支因果等需求。
Deconstruct a novel for game adaptation. Compress a raw novel, deconstruction library, or writing project into a SOURCE_BIBLE with cited textual evidence, extracting world rules, player verbs, spaces, character will, systems, and visual anchors — without inventing a genre yet. Use for gameable book analysis, analyze a novel for game adaptation, extract game systems from a book. 游戏化拆书。把原始小说、拆文库或写作工程压缩成有必要原文证据的 SOURCE_BIBLE,提取世界规则、玩家动词、空间、角色意志、系统和视觉锚点,不提前发明游戏类型。用于游戏化拆书、分析小说的游戏改编基础等需求。
Turn a novel into a fully playable game on the selected target platform. Orchestrates the whole adaptation pipeline — requirements intake, gameable deconstruction, concept selection, world and visual design, target-runtime build, and evidence-based QA — for a novel in any language. Use for novel to game, story to game, book to game, adapt this novel into a game, turn this book into a playable prototype, make an interactive story or text adventure from this novel. NovelToGame 总入口。把任意语言的原始小说、拆文库或 oh-story 写作工程转成有原著依据、可在目标平台完整游玩的游戏,编排游戏化拆解、概念选择、游戏与视觉设计、目标运行环境构建和证据化质量验证。用于小说转游戏、把这本书做成游戏、把小说改成互动小说 / 互动叙事 / 文字冒险游戏等需求。