mcpField
G
godogen

godogen

github.com/htdt开发7.2k115 次安装2 周前更新
代码仓库

关于 godogen

godogen 是一项根据自然语言生成和更新 Babylon.js 浏览器游戏的技能，面向游戏开发任务。它通过分阶段的规划、实现与浏览器画面验证来组织工作。

主要功能

  1. 01从自然语言生成与更新游戏
  2. 02分阶段规划和执行任务
  3. 03规划并生成游戏资源
  4. 04通过 Vite 热重载迭代
  5. 05用浏览器截图或视频验证画面

适用场景

  1. 01从描述搭建 Babylon.js 游戏
  2. 02继续执行已有 PLAN.md 中的任务
  3. 03为游戏规划并生成资源
  4. 04检查浏览器中的游戏画面

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/htdt/godogen --skill godogen

安装后在 Claude Code 中输入/godogen确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

architecture.md
capture.md
decomposer.md
quirks.md
scaffold.md
scene-generation.md
task-execution.md

详细介绍

Babylon Game Generator

通过自然语言生成和更新 Babylon.js 浏览器游戏。

功能

仅在到达相应阶段时，才从 ${GODOGEN_SKILL_DIR}/ 读取各阶段文件。

文件用途读取时机
visual-target.md生成参考图像流程开始时
decomposer.md分解为任务计划生成视觉目标后
scaffold.mdVite/Babylon 项目框架分解完成后
architecture.mdBabylon 游戏玩法架构方案设计游戏代码前
asset-planner.md预算和规划资源提供预算时
asset-gen.md资源生成 CLI 参考生成资源时
rembg.md移除背景仅在需要为资源移除背景时
task-execution.md任务工作流和命令开始首个任务前
quirks.mdBabylon/浏览器注意事项编写代码前
scene-generation.md场景/世界实现模式创建或替换可玩场景时
capture.md浏览器截图/视频捕获截图或录制视频前
(babylon-help skill)Babylon/Vite/浏览器 API 查询有 Babylon 相关问题时

流程

User request
    |
    +- Check if PLAN.md exists (resume check)
    |   +- If yes: read PLAN.md, STRUCTURE.md, MEMORY.md, ASSETS.md if present -> skip to task execution
    |   +- If no: continue with fresh pipeline below
    |
    +- Generate visual target -> reference.png + ASSETS.md (art direction only)
    +- Analyze risks + define verification criteria -> PLAN.md
    +- Scaffold/refresh Vite project -> package.json + src/ + STRUCTURE.md
    |
    +- If budget provided (and no asset tables in ASSETS.md):
    |   +- Plan and generate assets -> ASSETS.md + updated PLAN.md with asset assignments
    |
    +- Start/keep Vite dev server running at http://127.0.0.1:5173
    +- Execute risk slices first, then main build
    +- Use browser screenshots frequently while iterating
    +- If final presentation media is required:
        +- Record browser video to screenshots/result/{N}/video.mp4

资源

如果提供了预算，生成合适的资源就是任务的一部分。使用 asset-planner.md / asset-gen.md，再考虑使用程序化替代资源。

通过 TypeScript 导入的运行时加载资源应放在 src/assets/** 下；仅在需要稳定的直接 URL 时才放在 public/** 下。将参考图像、提示词、源文件旁注和调试捕获文件放在运行时资源路径之外。

执行

开始前阅读 task-execution.md。尽可能让 npm run dev 持续运行。Vite 热重载应作为常规开发循环：

  1. 编辑 src/game/** 或 src/assets/**。
  2. 等待已打开的浏览器中的场景重新加载。
  3. 捕获或检查浏览器画面。
  4. 大幅修改前运行 npm run check，最终媒体生成前运行 npm run build。

需要 Chrome/Chromium 和 WebGL2。如果缺少其中任一项，请停止并报告缺失的依赖，不要尝试绕过。优先使用硬件 GPU 加速——当 WebGL2 回退到软件渲染器（SwiftShader、llvmpipe、lavapipe 等）时，捕获脚本会记录醒目警告，但仍会完成捕获。在配备 GPU 的主机上，应将此警告视为需要修复的配置错误；在没有 GPU 的主机上，此警告仅供参考，运行仍可证明任务已完成，只是质量有所降低。

Babylon 帮助

有关 Babylon API、示例、加载器行为、Vite 集成、浏览器捕获问题或确切导入路径的问题，请使用 babylon-help。优先查阅当前项目版本中已安装的 npm 包源码/类型定义，然后再查阅官方文档。

上下文管理

将重要状态保存在文件中：

  • PLAN.md — 任务状态和验证标准
  • STRUCTURE.md — 架构参考
  • MEMORY.md — 发现、注意事项、变通方法，以及有效或无效的做法
  • ASSETS.md — 资源清单，包含路径和生成详情

完成每项任务后，更新相关状态文件。如果仓库策略要求提交，或用户要求提交，则在验证通过的任务阶段完成后提交。

视觉验证

不要只相信代码。使用截图或录制的视频在浏览器中验证可见效果。如果代码与媒体不一致，以媒体为准。如果某项要求在浏览器捕获中不可见，就视为尚未完成。

评论

支持 Markdown