agent-sprite-forge：用 Codex 生成引擎可用的 2D 素材和地图

AI 图像生成产出的游戏美术往往没法进引擎：帧尺寸漂移、背景去不掉底、"行走循环"永远对不齐。agent-sprite-forge（3,950 星）正是打这个缺口——agent 负责规划资产，内置图像生成负责画，确定性的本地脚本负责抠色、抽帧和导出，落到磁盘上的就是能用的游戏素材。

为什么这个 Skill 重要

仓库自带三个 skill。$generate2dsprite 产出精灵图、动画序列、道具、法术包和特效——附清理后的透明图、抽好的帧、GIF 和元数据。$generate2dmap 构建烘焙或分层地图、RPG 场景和道具包，还能交付带碰撞、区域和 y-sort 的 Godot 可编辑场景。$video2dsprite 从生成的短视频里采样出更密的帧集，让跑步循环更顺滑——但它仅限 Grok Build，因为它依赖 Grok 原生的 image_to_video 工具，Codex 没有这个能力。贯穿始终的设计原则：模型决定方案，脚本保证输出格式。

安装

本地处理器需要 PATH 里有 Python、Pillow 和 numpy（视频 skill 还要 ffmpeg）。macOS 或 Linux 上：

git clone https://github.com/0x0funky/agent-sprite-forge.git
cd ./agent-sprite-forge
python3 -m pip install -r ./requirements.txt

mkdir -p ~/.codex/skills
cp -R ./skills/* ~/.codex/skills/

Grok Build 则复制到 ~/.grok/skills——README 标明这是 $video2dsprite 的必要条件。安装后新开一个 Codex 或 Grok Build 会话，让 skill 重新加载。

实战：一套横版攻击动画

你在做一款 2D 动作游戏，需要一套雷电骑士的攻击动画。

1. 在任意工作目录打开 Codex 会话，提示：

Use $generate2dsprite to create a side-view lightning knight attack animation.

2. agent 选定图集布局和帧数，生成原始图像，然后跑本地流水线：品红色 chroma-key 去除、despill、抽帧、对齐。
3. 收产出：清理后的透明图集、单帧、预览 GIF，以及导入前可以核对的校验元数据。

哪一帧不对，带参考图重跑——skill 的 wrapper 规则会让 agent 先用 view_image 查看本地参考，让生成保留角色的形体和风格。

实战：带碰撞的 RPG 地图

环境制作走同样的路数：

Use $generate2dmap to create a top-down RPG forest shrine map. Use a layered raster pipeline, a 3x3 prop pack for small environmental props, precise collision, encounter grass zones, a rest point, and actors that can walk in front of and behind tall props.

产出包括带 TileMap 层和碰撞体的 Godot 可编辑场景——仓库展示页那几款游戏（含一款 Unity WebGL 类幸存者）正是用这些流水线拼出来的。

技巧

• 小型环境道具会批量打进 2x2、3x3 或 4x4 道具包再切片成单张透明 PNG——比逐个生成便宜。
• $video2dsprite 用清晰度换密度：中间姿势更顺滑，但像素更软、可能有形体漂移。要生产级图集，README 的建议是继续用 $generate2dsprite。
• 仓库提供英文、繁简中文、日文、韩文文档。
• 要风格延续的变体，先用 view_image 打开本地参考图——这是文档写明的保留 sprite 血统的方法。

何时不用这个 Skill

这是 Codex/Grok 流水线，不是通用图像工具：没有 npx 安装器、没有 Claude Code marketplace——要自己拷文件夹、自备 Python 环境。要高清概念图或非像素风格，普通图像模型更合适；要逐帧手调的精灵，绘图工具仍然是赢家。

查看 排行榜 了解更多 skill。