mcpField
G
game-build

game-build

github.com/zenstory-ai開発938293 回インストール1 週間前に更新
リポジトリ

game-build について

game-buildは、承認済みのゲーム設計をプレイ可能な候補にするためのスキルです。ホワイトボックスと本制作の段階に分け、実行時の挙動を検証し、ツールチェーンや制限を記録します。

主な機能

  1. 01ホワイトボックスまたは本制作で構築
  2. 02承認済みの体験とアートの境界を維持
  3. 03最小のプレイ可能なループを実装・検証
  4. 04再現可能な失敗経路を再実行
  5. 05実際のツールチェーンと検証コマンドを記録

活用シーン

  1. 01GAME_DESIGNをプレイ可能な候補に反映
  2. 02起動、入力、結果、再開の流れを検証
  3. 03実行画面と承認済みの目標画像を比較

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/zenstory-ai/novel-to-game --skill game-build

インストール後、Claude Code で/game-buildを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
baked-sprite-workflow.md
blender-asset-workflow.md
build-brief-contract.md
generative-media-pipeline.md
playable-model-contract.md
tts-production-contract.md

詳細

プロジェクトの README より

游戏构建执行

保护已批准的体验边界;正式生产时再保护已批准的美术边界。驱动实现模型完成真实可玩的候选,不在 构建阶段重新做概念、关卡或美术方向。

读取 build-brief-contract.md。白盒阶段必须已有 GAME_DESIGN.md; 完整候选还必须已有 ART_DIRECTION.md。缺产品决定时回对应 owner,不在 BUILD_BRIEF 就地发明。

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

目标与自由

按 PRODUCT_BRIEF 锁定的平台、生产引擎、目标运行时、显示/输入、范围、分级和联网边界交付。 目标工具链不可用时不得自动改做网页;只有 brief 已批准替代运行时才可使用,并分开记录 targetRuntime、testedRuntime 与未覆盖项。

正式生产继承 ART_DIRECTION.md 的可观察视觉约束与批准目标图,在实际运行中验证焦点资产。

BUILD_BRIEF 只压缩产品边界、必须保真的体验事实、运行方式与完成证据,实现细节交给实现模型。

先声明 buildStage: whitebox|production 与 buildPath: template|custom。已有交互语法只有在能保留原作 独有动作、代价和世界回应时才采用;实时手感、空间、视线、物理或模板覆盖不了的核心动词走 custom。 白盒也必须选择能验证最大风险的形态,不能把所有项目降成文游。

当前会话能编码时直接实现;外部模型不可用时只交付构建说明,不声称游戏已生成。不要发送与原型 无关的完整受版权保护原文。

按能力读取可选合同

共同构建循环

  1. 先实现一个最小但完整的核心循环:启动、真实输入、状态变化、结果和重开。范围不足时修范围, 不先堆审计材料。
  2. 实现 GAME_DESIGN 的状态、动作与结果;使用生成模型时,模型只解释输入和结果,规则器拥有提交权。 存在 signature_command 时再执行可选合同的专属边界。
  3. 保留能复现问题的初态与输入路径,涉及随机性时固定 seed;修订后重放失败路径与相邻反例。 同一手感或表现问题连续两次修复无效时停止换方案,先查成熟作品处理同类问题的公开资料(开发者 演讲、技术复盘或开源实现),理解其原理后再实现。
  4. 回写实际工具链、install/build/start 命令和版本;未知值写 NOT_AVAILABLE: 原因,不猜。 实际候选与 GAME_DESIGN、ART_DIRECTION 的事实描述不符时,交回对应 owner 修订或在 BUILD_BRIEF 标明冲突, 不留下描述已不存在的玩法、表现或声音的文档。

whitebox 到此按 build-brief-contract「完成证据」运行最窄检查并交回 design owner;设计修订后 重放受影响路径,直到最大风险已被实际暴露或当前方向被否决。

production 继续:

  1. 提供一条权威验证命令和最小可观察状态,使 game-qa 能一次走完 clean start → 核心动作 → 设计结果 → restart。
  2. 运行最窄的开发检查与启动 smoke,修复构建失败、阻断日志、资源失败和崩溃;替代运行时未覆盖的 目标平台输入、性能、打包或设备项写入 limitation。
  3. 达到 brief 的 targetFinish;更高完成度只处理已批准的焦点资产和招牌时刻,不制造与可玩闭环 无关的发布审计。有批准目标图的界面与焦点资产,在目标视口截取实际运行画面与目标图并排比对, 逐项列出布局、比例、字体、色光与层级差异后修正;连续两轮没有改善就停止,把剩余差异写进 BUILD_BRIEF 的限制,不修改目标图去迁就实现。
  4. 交给 game-qa;诊断、复跑与事实源规则见契约「完成证据」。

输出

生成 build/BUILD_BRIEF.md 与实际候选;production 还生成权威验证入口。截图、录制与 raw trace 只保留 调试所需的最小集合。

コメント