godogen

分类: 内容与多媒体 | 上传者: htdt | 下载: 0 | 版本: v1.0（最新）

当用户要求“制作游戏”、“构建游戏”、“生成游戏”，或者想要从自然语言描述生成或更新完整的 Godot 游戏时，应该使用此技能。 --- # 游戏生成器 — Orchestrator 从自然语言生成和更新 Godot 游戏。 ## 功能当到达管道阶段时，从 `${CLAUDE_SKILL_DIR}/` 读取每个子文件。 |文件|目的|何时阅读 | |------|---------|--------------| | `视觉目标.md` |生成参考图像 |管道启动 | | `decomposer.md` |分解为任务DAG |视觉目标后| | `脚手架.md` |建筑+骨架|分解后| | `资产规划器.md` |预算和计划资产|如果提供预算| | `asset-gen.md` |资产生成 CLI 参考 |生成资产时 | | `rembg.md` |背景去除 |仅当资产需要删除透明度时 | | `任务执行.md` |任务工作流程+命令|第一个任务之前| | `怪癖.md` |戈多陷阱|编写代码之前 | | *（godot-api 技能）* | GDScript 语法参考 |当不确定 GDScript 语法时 | | `场景生成.md` |场景构建者 |目标包括 .tscn | | `测试线束.md` |验证脚本|测试线束前| | `capture.md` |截图/视频|捕获前| | `视觉质量保证。 MD` |视觉 QA（分叉技能）|捕获后| | `android-build.md` | APK 导出 |用户请求Android | ## 管道 ``` 用户请求 | +- 检查 PLAN.md 是否存在（继续检查） | +- 如果是：读取 PLAN.md、STRUCTURE.md、MEMORY.md -> 跳到任务执行 | +- 如果否：继续使用下面的新管道 | +- 生成视觉目标 -> reference.png + ASSETS.md（仅限艺术指导） +- 分析风险 + 定义验证标准 -> PLAN.md +- 设计架构 -> STRUCTURE.md + project.godot + 存根 | +- 如果提供预算（并且 ASSETS.md 中没有资产表）：| +- 规划和生成资产 -> ASSETS.md + 使用资产分配更新了 PLAN.md | +- 向用户显示简明的计划摘要（风险任务（如果有）、主要构建

更新日志: Source: GitHub https://github.com/htdt/godogen

目录结构

当前层级: tree/master/skills/godogen/

📁 tools/
- 📄 asset_gen.py 11.5 KB
- 📄 find_loop_frame.py 4.3 KB
- 📄 grid_slice.py 1.9 KB
- 📄 rembg_matting.py 12.0 KB
- 📄 requirements.txt 98 B
- 📄 tripo3d.py 3.3 KB
📄 android-build.md 3.2 KB
📄 asset-gen.md 13.4 KB
📄 asset-planner.md 10.2 KB
📄 capture.md 3.7 KB
📄 decomposer.md 3.8 KB
📄 quirks.md 9.0 KB
📄 rembg.md 4.2 KB
📄 scaffold.md 10.4 KB
📄 scene-generation.md 10.6 KB
📄 SKILL.md 5.8 KB
📄 task-execution.md 7.4 KB
📄 test-harness.md 1.4 KB
📄 visual-qa.md 2.8 KB
📄 visual-target.md 3.0 KB

SKILL.md

---
name: godogen
description: |
  This skill should be used when the user asks to "make a game", "build a game", "generate a game", or wants to generate or update a complete Godot game from a natural language description.
---

# Game Generator — Orchestrator

Generate and update Godot games from natural language.

## Capabilities

Read each sub-file from `${CLAUDE_SKILL_DIR}/` when you reach its pipeline stage.

| File | Purpose | When to read |
|------|---------|--------------|
| `visual-target.md` | Generate reference image | Pipeline start |
| `decomposer.md` | Decompose into task DAG | After visual target |
| `scaffold.md` | Architecture + skeleton | After decomposition |
| `asset-planner.md` | Budget and plan assets | If budget provided |
| `asset-gen.md` | Asset generation CLI ref | When generating assets |
| `rembg.md` | Background removal | Only when an asset needs transparency removed |
| `task-execution.md` | Task workflow + commands | Before first task |
| `quirks.md` | Godot gotchas | Before writing code |
| *(godot-api skill)* | GDScript syntax ref | When unsure about GDScript syntax |
| `scene-generation.md` | Scene builders | Targets include .tscn |
| `test-harness.md` | Verification scripts | Before test harness |
| `capture.md` | Screenshot/video | Before capture |
| `visual-qa.md` | Visual QA (forked skill) | After capture |
| `android-build.md` | APK export | User requests Android |

## Pipeline

```
User request
    |
    +- Check if PLAN.md exists (resume check)
    |   +- If yes: read PLAN.md, STRUCTURE.md, MEMORY.md -> 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
    +- Design architecture -> STRUCTURE.md + project.godot + stubs
    |
    +- If budget provided (and no asset tables in ASSETS.md):
    |   +- Plan and generate assets -> ASSETS.md + updated PLAN.md with asset assignments
    |
    +- Show user a concise plan summary (risk tasks if any, main build scope)
    |
    +- Execute (see Execution below)
    |
    +- If user requested Android app:
    |   +- Read android-build.md, add ETC2/ASTC to project.godot, create export_presets.cfg, export APK
    |
    +- Summary of completed game
```

## Execution

Read `task-execution.md` before starting. Three phases:

1. **Risk tasks** (if any) — implement each in isolation, verify, commit
2. **Main build** — implement everything else, verify, present results (video for new games), commit

## Godot API Lookup

When you need to look up a Godot class API (methods, properties, signals), use `Skill(skill="godot-api")` with your query. This runs in a separate context to avoid loading large API docs into the main pipeline.

Be specific about what you need — the docs are comprehensive and full returns are large:
- **Targeted query** — ask for specific methods/signals to get a concise answer: `"CharacterBody3D: what method applies velocity and slides along collisions?"`
- **Full API** — only request when you need to survey the entire class: `"full API for AnimationPlayer"`

Examples:
- Skill(skill="godot-api") "TileMapLayer: methods for setting/getting cells and their alternatives"
- Skill(skill="godot-api") "full API for CharacterBody3D"
- Skill(skill="godot-api") "which class handles 2D particle effects?"
- Skill(skill="godot-api") "GDScript: tween parallel syntax and callbacks"

## Visual QA

After capturing screenshots, verify with `Skill(skill="visual-qa")`. Runs in a forked context with Claude's native vision.

- **Static:** `Skill(skill="visual-qa") "Check reference.png against screenshots/{task}/frame0003.png — Goal: ..., Verify: ..."`
- **Dynamic:** `Skill(skill="visual-qa") "Check reference.png against frame1.png frame2.png ... — Goal: ..., Verify: ..."`
- **Question:** `Skill(skill="visual-qa") "Are surfaces showing magenta? screenshots/{task}/frame*.png"`

Save output to `visual-qa/{N}.md`. See `visual-qa.md` for full usage.

## Context Hygiene

Keep important state in files so the pipeline can resume even after compaction or clear:

- **PLAN.md** — task statuses, always up to date before moving on
- **STRUCTURE.md** — architecture reference, update if scaffolding changes
- **MEMORY.md** — discoveries, quirks, workarounds, what worked/failed
- **ASSETS.md** — asset manifest with paths and generation details

After completing each task: update PLAN.md status, write discoveries to MEMORY.md, git commit. This ensures the pipeline can resume from any point by reading these files.

If the context becomes polluted from debugging loops, manually compact with:
`/compact "Discard failed debugging attempts."`

## Visual QA

**Don't trust code — verify on screenshots.** The most common failure mode: code looks correct, you assume it works, and report "everything's fine." Then screenshots reveal broken placement, wrong scale, missing elements, clipped geometry — dozens of small details that go wrong in unexpected ways, especially with custom assets. Visual QA is your quality partner: use it actively after every task, not as a formality.

Visual QA runs inline with each task. **Never ignore a fail verdict** — always act on it before marking a task done.

**VQA reports are clear signal.** If a significant issue is reported, fix it. If you genuinely believe it's a false positive — report it to the user and let them decide. Never silently ignore a fail verdict.

- **pass/warning** — move on.
- **fail** — fix the issue. If you've already attempted up to 3 fix cycles, decide:
  - **Replan** — reset architecture, rewrite plan, and/or regenerate assets if the root cause is upstream.
  - **Escalate** — surface the issue to the user if you can't determine the right fix.

The final task in PLAN.md is a presentation video — a script that showcases gameplay in a ~30-second cinematic MP4.

登录后下载/点赞/收藏 ❤ 2.5K | ★ 0

godogen

目录结构

SKILL.md

举报内容

提示