1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | sprite-gen |
| 作者/维护者 | aldegad（GitHub 个人开发者，账号存续 11 年） |
| 来源链接 | https://github.com/aldegad/sprite-gen |
| 许可证 | Apache-2.0（数据来源：GitHub API） |
| GitHub Stars | 520（数据来源：GitHub API） |
| Forks | 46（数据来源：GitHub API） |
| 最新版本 | SKILL.md 内声明 v1.56.80；GitHub 正式 Release 最新为 v1.56.16（2026-07-16） |
| 安装方式 | 手动复制到 Claude Code skills 目录，或用 Codex 官方 skill-installer 脚本一键安装 |
2. 功能介绍与亮点
sprite-gen 用一条“component-row”流水线，把一张基础角色立绘变成游戏引擎可直接使用的精灵动画图集：
- 锚点锁定：先确认一张比例、风格、身份都正确的“idle 基准图”，再生成后续状态，避免误差逐帧累积
- 确定性抽帧：色键抠图→连通域分割→网格对齐→共享调色板→单元格排布，同输入必得同输出
- 可视化精修：并排比较生成候选，非破坏性拖拽/缩放/旋转/镜像调整每一帧
- 多供应商生图：可接 Codex（ChatGPT OAuth）或 Grok（xAI OAuth）
- 反向工具链：
unpack_atlas_run从成品精灵表反推可精修目录，cutout为任意导入图片单独去背景 - 多语言文档：README 提供英/韩/日/中/西/法六语言版本
亮点：完全开源（Apache-2.0），近两个月 10 次正式发布，且已合入 3 位外部贡献者的真实 bug 修复，非单人自用项目。
3. 适用场景
所属分类：内容创作与知识管理
面向独立游戏开发者与小型工作室：给一张角色原画，批量生成 idle/walk/run/jump/attack 等多状态、风格一致的透明精灵图集，省去逐帧手绘像素美术的人力。其精修界面也通用于“从候选图里挑一张”，如比较多版 Logo 或 AI 草图。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 支持 | README 明确说明技能可运行于 “Claude Code Desktop”，采用标准 SKILL.md 格式 |
| Codex | 原生支持 | 仓库提供官方 skill-installer 一键安装脚本，是首要发布目标之一 |
| OpenClaw | 未验证 | 已抓取材料未提及 |
| Hermes Agent | 未验证 | 已抓取材料未提及 |
5. 推荐理由
它解决了一个具体痛点：AI 图像模型直接生成的“精灵表”往往帧不对齐、背景抠不干净、姿态漂移，游戏引擎用不了。sprite-gen 把“AI 生成”限制在单一环节，其余全走确定性代码路径，再用可视化工具把最后的人工判断交还给开发者——生成走量，人把关质量。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 520 Stars / 46 Forks，处于 200–1k 星区间；已有 3 位外部贡献者提交并被合入的真实修复 PR，作者账号存续 11 年，非新建刷榜号 |
| 可用性 | 8 | 文档详尽（架构说明 + 多语言 README），安装步骤清晰，但实际生图依赖用户自行安装并完成 OAuth 登录的 Codex 或 Grok 命令行工具，并非纯粹开箱即用 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 仅执行仓库自带的图像处理脚本（切帧/合成/校验），并用文件锁 + 原子写防止并发写坏产物，范围明确 |
| ② 联网外发 | 仅在调用 codex/grok 生图时联网，目标是用户自行安装并鉴权的官方 CLI，用途透明 |
| ③ 凭据存储 | 不自行存储密钥，复用 Codex/Grok CLI 已有的 OAuth 会话 |
| ④ 可疑指令 | 未在 SKILL.md 与脚本中发现隐蔽指令或提示词注入迹象 |
| ⑤ 作者信誉 | 个人开发者，GitHub 账号存续 11 年，commit 记录与外部贡献者 PR 均可验证，无刷星迹象 |
| ⑥ License | Apache-2.0，明确 |
| ⑦ 维护时间 | 近一周内（2026-07-20）仍有提交，维护活跃 |
7. 跟同类 Skills 相比的优势
| 对比对象 | 形态与定位 | 与 sprite-gen 的差异 |
|---|---|---|
| SpriteCook（spritecook.ai） | Claude 插件，MCP 工具 + 技能组合，对话式生成精灵图，免费增值模式 | 需浏览器登录账号，生成过程未公开是否采用确定性抽帧方法；sprite-gen 完全开源可审计、无需注册账号，抽帧与合成走可复现的确定性代码路径 |
| 第三方技能市场（如 mcpmarket.com）收录的多款“Sprite Sheet Generator” | 目录型列表页包装，多未见开源仓库或技术文档支撑 | sprite-gen 提供完整开源实现、架构文档与可查证的第三方贡献记录 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；已知的外部互动是 3 位不同 GitHub 用户提交并被合入的真实代码修复（见第 2 章）。
9. 安装使用方式
Claude Code：克隆/复制仓库到本地 skills 目录（如 ~/.claude/skills/sprite-gen），重新加载后即可触发。
Codex（官方一键安装）：
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
--repo aldegad/sprite-gen --path .安装后注意：生图前需先装好并登录 codex 或 grok 命令行工具（二选一）；需要 Python 3.10+，建议用 venv 安装依赖；首次使用需准备一张背景干净、比例风格已定的角色基准图作为“锚点”。
10. 注意事项
- 生图能力来自第三方 CLI（Codex/Grok），本仓库不提供生图模型，效果与配额受所选供应商限制
- 仅验证了与 Claude Code、Codex 的兼容性，OpenClaw、Hermes Agent 尚未验证
- 部分高级工作流细节（如“呼吸”动效参数）仅有韩文说明，非母语使用者可能需额外翻译
- 项目星标与外部贡献仍处早期阶段，长期维护走向有待观察