0x0funky/agent-sprite-forge

Agent Sprite Forge 是一组面向游戏美术的智能体技能：从一张审核通过的主角静帧出发生成角色的动作动画，也能制作地图与图块。它适合已经在使用 Claude Code、Codex 或 Grok、并且想要成套精灵包而非单张生成图的 2D 游戏开发者。

实际改变的工作流

文档给出的流程是 master → set → finish → export。你用提示词让智能体创建主角静帧；master_still.py 负责写提示词、生成多个候选、做定向编辑，并把通过的那张记入 master.json。随后智能体为每个动作（idle、walk、run、attack、jump、hurt）生成一段 image-to-video 片段。确定性的 Python 工具会按面积、脚部、身份一致性、缩放、边缘、背景、多余物体、运动、结束姿态、颜色串色和时长逐条质检，最多重拍 3 次；再做软遮罩抠像、配准、按测量选择循环、把一次性动作重新计时，最后打包 Agent Sprite Forge README。

两个机制承担了实际工作。软遮罩抠像器消除色键边缘：作者报告紫色边缘从 0.704 降至 0，145 帧的处理时间从 271 秒降至 44 秒。一次性动作重计时把生成模型的慢动作片段剪到游戏长度，报告的攻击动作从 4.1 秒缩到 0.7 秒。这些都是作者在 2026-10-06 实跑中报告的数字，不是独立测量 验证记录。

使用路径与前提

Claude Code 用户以插件方式安装，需要 Python 3.10+ 以及 numpy、Pillow、scipy。Codex 和 Grok 用户克隆仓库后运行安装脚本，脚本会备份已安装副本并写入 sha256 清单，之后可检查漂移。视频、精灵集、打包和场景循环需要 PATH 上有 ffmpeg 5.1+，且带 libvpx-vp9 与 libx264。安装后要新开智能体会话，技能才会加载 安装与要求。

图像和视频生成需要二选一：配置 OpenAI、Gemini、xAI、BytePlus 或 fal.ai 的 API key，或使用你自己已登录的 Codex / Grok CLI。两者都没有，或你明确要求时，codeart2d 会以代码绘制作为兜底，并明确标注为代码生成。路由按固定顺序尝试；配置了 key 即视为同意调用，不再逐次询问。每次调用（包括本地调用）都会记入支出账本，不设预算上限，除非你自行设置 路由与提供商。

输出与限制

产物包括 animation.json 3.0 加 PNG 图集、VP9-alpha WebM、packed-alpha MP4，以及 Godot SpriteFrames/Sprite3D 和 Aseprite JSON 导出。地图可导出到 Tiled、Godot 4 和 LDtk 引擎导出。README 明确提醒：0.4.0 的 Godot、LDtk 和 Aseprite 导出只验证到解析层面，尚未有人在对应编辑器中打开过。

脚本不负责创作判断：数值质检无法批准解剖和动作，因此需要智能体查看审核图，由你批准主角静帧。image-to-video 模型在快速肢体和跳跃上会出现漂移，run 和 jump 应有重拍的心理准备；已知限制文档列明了哪些结论已证实、哪些未证实 已知限制。

MIT 许可证只覆盖本仓库的代码和文档。生成的图像与视频仍受各提供商条款约束；作者建议商业项目使用自有角色或你控制的 IP 许可说明。