1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | agent-sprite-forge |
| 作者/维护者 | 0x0funky（GitHub 个人账号） |
| 来源链接 | https://github.com/0x0funky/agent-sprite-forge |
| 许可证 | MIT（仓库 LICENSE 文件确认） |
| GitHub Stars | 3,397（GitHub API 实测） |
| Forks | 334（GitHub API 实测） |
| 最新版本 | 无正式 Release / Tag，主分支持续更新（最近一次提交 2026-07-12） |
| 安装方式 | git clone 后本地安装 Python 依赖，再将 skills/ 目录复制进 Codex 或 Grok Build 的技能目录 |
项目自述名称即为「Agent Sprite Forge」，与正式名称一致（GitHub 独立仓库，正式名称按仓库名机械确定）。
2. 功能介绍与亮点
仓库包含三个协同子能力（generate2dsprite / generate2dmap / video2dsprite），本质是一套统一的“2D 游戏美术资产生成与引擎接入”工具：
- generate2dsprite：从自然语言描述生成角色、怪物、道具、技能特效的动画精灵表，自动完成去色抠图、分帧、对齐、透明导出
- generate2dmap：生成分层地图（基础地图、可复用道具包、碰撞/触发区），可直接产出 Godot 可编辑的 TileMap 场景
- video2dsprite：把短视频抽帧合成密度更高的过渡帧精灵，用于让动作更连贯（该环节仅 Grok Build 支持）
亮点：① “Agent 负责创意决策、脚本只做确定性后处理”分工清晰——原始美术图由宿主 Agent 内置图像生成能力产出，本地脚本仅依赖 Pillow/numpy/ffmpeg，只做去色抠图、分帧、缩放对齐、导出 GIF/透明 PNG；② 仓库自带 Godot 塔防、Unity 幸存者 like、网页类宝可梦 RPG 三个可在线试玩的原型项目，展示素材到成品的完整闭环；③ 提供英/繁中/简中/日/韩五语言 README，面向国际开发者社区。
3. 适用场景
固定分类：其他——该技能面向游戏开发的美术资产生成与引擎接入，现有分类中“前端与设计”特指 UI 组件、原型与设计系统，并不覆盖游戏素材生产场景，其余分类同样无法准确归类，故按分类规则第 10 项归入“其他”。
适用于用 Codex 或 Grok Build 搭建 2D 游戏原型的独立开发者、Game Jam 参赛者，以及希望把“写一句话提示词 → 拿到可直接导入引擎的精灵表/地图”这段美术管线自动化、从而把精力留给玩法设计的小团队。
4. 跨 Agent 兼容性
- Codex：✅ 原生支持——README 与 SKILL.md 明确围绕 Codex 内置的
image_gen工具设计，属于“Codex-first”工具，复制到~/.codex/skills后即可使用 - Grok Build：✅ 原生支持（且是 video2dsprite 环节的必需宿主）——README 注明 video2dsprite 依赖的
image_to_video步骤仅 Grok Build 提供，复制到~/.grok/skills后可用；另两个子技能同样可在 Grok Build 运行 - Claude Code：❌ 不支持——三个子技能均依赖宿主内置的
image_gen（及image_to_video）工具产出原始美术图，Claude Code 未内置对应能力；仓库 Issue #7 显示曾有用户尝试写一个“Codex CLI 桥接脚本”让 Claude Code 间接调用，但该方案作者本人未将其合并进主仓库，维护者的答复是“更适合放在个人 fork 里维护” - OpenClaw / Hermes Agent：❓ 未验证——已抓取材料未提及，且技术上同样依赖宿主内置的图像生成工具，能否使用取决于对应 Agent 是否具备该能力
5. 推荐理由
把“写一句话描述 → 拿到可直接导入 Godot/Unity 的精灵表与地图”这条游戏美术管线，做成了确定性、可复现的自动化流程。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 3,397 星、334 fork（API 实测，仓库创建于约 3 个月前，star/fork 比例正常，增长曲线平稳，未见异常爆发式增长）；Issue 区可见多位独立用户的真实使用反馈与二次创作，显示出真实的社区参与度 |
| 可用性 | 8 | git clone + 安装依赖 + 复制技能目录三步完成安装，步骤清晰且文档完整（含安装脚本、推荐提示词示例、五语言 README）；近期仍有提交，维护活跃；不依赖任何付费 API（图像生成完全复用宿主自带能力） |
| 安全性 | 8 | 见下方安全检查清单 |
安全检查清单逐项：①全部 9 个 Python 脚本均已检索，只做本地图像后处理（色键抠图、分帧、缩放、导出）与 ffmpeg 调用，无远程 shell 执行；②已对全部脚本做联网请求特征检索，未发现网络外发行为，原始图像生成由宿主 Agent 内置工具完成，本仓库代码本身不联网；③不要求任何 API Key 或账号凭据；④已读完三个子技能的 SKILL.md 全文，内容为资产生成规范与构图规则，未发现提示注入或可疑指令；⑤作者为 GitHub 个人账号，仓库有真实、可追溯的双向 Issue 讨论与外部用户贡献意愿；⑥MIT 许可证明确；⑦最近一次提交 2026-07-12，持续维护中。
综合评分：7.7（三项均值，四舍五入至一位小数）
7. 跟同类 Skills 相比的优势
| 名称 | 定位 | 与本技能的差异 |
|---|---|---|
| agent-sprite-forge（本次推荐） | 本地免费方案：复用宿主 Agent 内置图像生成能力，本地脚本只做确定性后处理；精灵、地图、视频抽帧三合一，并自带 Godot/Unity 引擎接入示例 | —— |
| SpriteCook（spritecook.ai 官方 skills 仓库） | 云端付费方案：通过 MCP 连接 SpriteCook 托管服务生成像素画与高清游戏美术，按 credits 计费，遵循 Agent Skills 开放标准，可安装到多种兼容编辑器 | 生成质量与风格一致性由专门训练的托管模型保证，理论上宿主兼容面更广（不限定 Codex/Grok）；但需要付费额度且要联网调用第三方服务，无法像本技能一样零成本复用宿主自带能力 |
差异化总结：两者代表“本地免费复用宿主能力”与“云端付费专用模型”两条不同路线——前者胜在零成本、无外部依赖，后者胜在生成质量的专门优化与更宽的宿主兼容面。
8. 用户评价
- 独立开发者 jay6697117 在 GitHub Issue 中分享了完全用该技能“纯 AI 速成”制作的像素风模拟经营类网页 Demo，并主动提出贡献回仓库，维护者本人回应认可
- 日本技术博主 npaka（note.com）撰写实操记录，亲自生成了一只火属性史莱姆的 3×3 待机动画精灵表和一张神社主题俯视角 RPG 地图（含碰撞与出口区），确认两个核心子技能均可正常产出可用素材
9. 安装使用方式
git clone https://github.com/0x0funky/agent-sprite-forge.git
cd agent-sprite-forge
python3 -m pip install -r requirements.txt # Pillow + numpy；video2dsprite 另需 ffmpeg 在 PATH 中
# Codex
mkdir -p ~/.codex/skills
cp -R ./skills/* ~/.codex/skills/
# Grok Build（video2dsprite 的视频抽帧环节需要）
mkdir -p ~/.grok/skills
cp -R ./skills/* ~/.grok/skills/安装后需重启 Codex 或 Grok Build 会话使技能重新加载。三个子技能可分别用 $generate2dsprite、$generate2dmap、$video2dsprite 显式调用，也可直接用自然语言描述需求触发。
10. 注意事项
- 仅支持 Codex 与 Grok Build；Claude Code 用户目前无法直接使用（宿主无内置图像生成工具可供本技能调用），需等待官方或社区提供替代方案
- video2dsprite 的视频抽帧环节为 Grok Build 独占能力，在 Codex 环境下该子技能会因缺少
image_to_video工具而无法完成生成步骤 - 仓库 Issue 区记录了一个尚未修复的已知问题：部分洋红/紫色系配色的精灵在去色抠图后边缘可能残留背景色，社区建议的规避方法是让角色配色避开与默认抠图背景色（纯洋红
#FF00FF）相近的色彩 - 无正式版本号或 Release，更新节奏以主分支提交为准，升级前建议先比对已安装目录再覆盖