Agent 决策 + 图像生成 + 确定性脚本：Agent Sprite Forge 三层工作流架构解析

Agent 决策 图像生成 确定性脚本Agent Sprite Forge 三层工作流架构解析【免费下载链接】agent-sprite-forgeAgent Skill for generating 2D sprite sheets and map, transparent PNG frames, and animated GIFs from prompts.项目地址: https://gitcode.com/gh_mirrors/ag/agent-sprite-forgeAgent Sprite Forge 是一个面向 2D 游戏素材生成的开源 Agent Skill 工具集用自然语言提示词即可生成游戏可用的 2D 精灵图sprite sheets、透明 PNG 帧序列、动画 GIF 和分层式 2D 游戏地图。它的核心是一套清晰的三层工作流架构——Agent 决策 图像生成 确定性脚本让 AI 绘图的结果真正能进游戏引擎。 为什么 AI 绘图需要一个三层工作流直接用 AI 绘图模型生成游戏素材通常会遇到这些问题 背景无法干净去除模型不会生成透明背景 帧与帧之间角色大小漂移、位置偏移拼不成动画 缺乏碰撞、区域、摆放位置等结构化元数据引擎无法直接使用 每次生成结果不一致难以批量、可复现地生产Agent Sprite Forge 的解法是把生产流水线拆成职责明确的三层决策层负责想生成层负责画脚本层负责修和验。官方文档中的定位非常直接——脚本不是创造大脑Agent 做视觉与流水线决策Python 工具只执行可重复的像素与导出操作。 第一层Agent 决策——把一句话变成素材生产计划三层架构的第一层是智能体本身。用户只需要用自然语言描述需求比如给一个终极大地泰坦做一个 3x3 idleAgent 会自行推断出一整套生产计划。以精灵图技能 skills/generate2dsprite/SKILL.md 为例Agent 会从请求中推断这些参数参数含义示例取值asset_type素材类型player / npc / creature / spell / propaction动作idle / attack / cast / walk / impactsheet帧表布局2x2 / 2x3 / 3x3 / 4x4bundle资产组合unit_bundle / spell_bundle / hero_action_bundleart_style美术风格pixel_art / clean_hd / retro_pixelanchor/margin对齐与边距feet / centertight / normal / safe这一层的价值在于把专家经验固化成了决策规则。例如 skills/generate2dsprite/references/prompt-rules.md 中的约束4 帧身体动作默认2x2网格6 帧用2x3避免单行1x4造成角色水平漂移英雄攻击动作默认仅身体刀光、弹道、撞击特效拆成独立的 FX 素材创意提示词由 Agent 手写而不是交给脚本拼凑地图技能 skills/generate2dmap/SKILL.md 的决策粒度更细先选 6 种map_mode之一tile / scene / side_scroll / grid / room_chunk / baked_scene再映射到视觉模型、运行时对象模型、碰撞模型和引擎目标四个轴。详细的选型逻辑见 skills/generate2dmap/references/map-strategies.md。 第二层图像生成——内置 image_gen 产出原始视觉素材决策完成后Agent 调用宿主环境Codex / Grok Build内置的image_gen工具生成原始图像。这一层有几条关键规则纯色洋红背景#FF00FF所有原始帧表都要求纯洋红底色为第三层的抠像chroma-key做准备禁止代码画图Three.js、Canvas、SVG、PIL 绘制等代码生成艺术一律被禁止精灵图必须来自真实的图像生成参考图先可见再引用涉及参考图时必须先让图像出现在对话上下文中再要求生成保持角色身份、配色、轮廓一致地图流水线同样图像生成优先先只生成地面基础层base再生成摆放了道具的实景参考图dressed reference最后基于参考图生成道具包。这种参考交接机制保证了分层地图的风格与构图从头到尾一致。⚙️ 第三层确定性脚本——本地后处理让素材可进引擎第三层是一组本地 Python 脚本依赖 requirements.txt 中的 Pillow 与 numpy只做可复现的像素级操作洋红抠像洪泛填充去背景 despill 去溢色帧切分与对齐按行列切割帧表统一缩放shared_scale脚部/中心对齐道具包切片把 3x3 道具表切分为独立透明道具✅QC 元数据输出边缘触碰检测、尺寸校验等质检信息格式导出透明 PNG 帧表、逐帧 PNG、动画 GIF典型一次生成的交付物包括raw-sheet.png原始帧表、sheet-transparent.png透明帧表、逐帧 PNG、animation.gif、prompt-used.txt和pipeline-meta.json流水线元数据。地图侧的确定性脚本同样各司其职skills/generate2dmap/scripts/extract_prop_pack.py 负责道具包提取skills/generate2dmap/scripts/compose_layered_preview.py 负责合成扁平化分层预览。而$generate2dmap还能进一步产出Godot 可编辑场景——可编辑的TileMapLayer、独立Sprite2D道具、碰撞体、区域和调试玩家素材直接从生成流水线走进引擎 三个内置技能覆盖角色、地图、动作的完整素材链技能用途输出运行环境$generate2dsprite角色、怪物、法术、特效、道具与参考图衍生变体原始帧表、透明帧表、逐帧 PNG、GIF、元数据Codex / Grok需图像生成$generate2dmap烘焙地图、分层栅格地图、道具包、碰撞区域、Godot 可编辑场景基础地图、实景参考、道具包、分层预览、场景元数据Codex / Grok需图像生成$video2dsprite视频抽帧生成更密集动作帧静止图 → 6 秒原地跑动视频 → 抠像 → 8/16/24/48 帧集视频、清理帧、精灵条、预览 GIF仅 Grok Build需image_to_video技能文档分别是 skills/generate2dsprite/、skills/generate2dmap/ 与 skills/video2dsprite/SKILL.md。其中$video2dsprite是动作密度增强路径——用视频中间帧弥补 4~8 帧离散生成的生硬感代价是像素更软、可能有身份漂移生产级角色仍推荐走$generate2dsprite。它的本地处理器 skills/video2dsprite/scripts/video2dsprite.py 基于 ffmpeg 完成抽帧、洋红抠像与脚部对齐。️ 实际效果从一句提示词到分层地图与可玩原型分层地图流水线是最能体现三层协作的场景一次运行会依次产出仅地面的基础层foundation-only base基于可见参考图生成的实景道具摆放参考3x3 透明道具包 → 脚本切片为独立道具摆放、碰撞、区域元数据 扁平化分层预览一条典型提示词就能驱动整条链路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.README 中的完整案例还包括 Unity WebGL 生存原型、Godot 塔防、赛博朋克横版动作游戏和浏览器 RPG——全部由生成的素材 结构化场景数据 可玩原型接线闭环完成。 安装与快速上手本地后处理需要Python、Pillow、numpy视频技能另需ffmpeg。macOS / Linux 下一键安装git clone https://gitcode.com/gh_mirrors/ag/agent-sprite-forge cd ./agent-sprite-forge python3 -m pip install -r ./requirements.txt mkdir -p ~/.codex/skills cp -R ./skills/* ~/.codex/skills/Windows PowerShell 用户可参考 README.md 中的 Option 1 步骤。安装后开启新的 Codex / Grok Build 会话让技能重新加载然后直接用自然语言发起请求即可。推荐提示词Use $generate2dsprite to create a 3x3 idle for an ultimate earth titan.Use $generate2dmap to create a Godot-editable RPG map with separated props, encounter grass Area2D zones, collision StaticBody2D blockers, exit zones, and a debug player scene.✅ 总结三层架构的设计启示Agent Sprite Forge 用三层工作流回答了AI 绘图如何落地到生产这个问题Agent 决策层把领域专家规则帧表布局、道具分类、地图模式选型固化为可复用的技能文档图像生成层专注创意产出统一洋红背景与参考交接规则保证下游可处理⚙️确定性脚本层只做像素级后处理与质检输出透明帧、GIF 和引擎元数据这种让智能体负责判断、让脚本负责重复的分工让 AI 生成的 2D 游戏素材从看着好看进化为能直接进 Godot / Unity 使用。如果你正在做 2D 游戏原型这套 2D 精灵图与地图生成工作流值得直接上手试试。【免费下载链接】agent-sprite-forgeAgent Skill for generating 2D sprite sheets and map, transparent PNG frames, and animated GIFs from prompts.项目地址: https://gitcode.com/gh_mirrors/ag/agent-sprite-forge创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考