企业官网建设流程全解析

把sprite-gen装成Codex/Claude技能：AI Agent驱动的精灵图全自动生成

【免费下载链接】sprite-genGenerate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.项目地址: https://gitcode.com/gh_mirrors/sp/sprite-gen

sprite-gen 是一个开源的 2D 游戏精灵图（Sprite）生成工具：给它一张基础立绘，它就能自动完成状态行生成、抠图去背、逐帧提取和运行时图集烘焙，最终产出带透明通道、带机器可读manifest.json的游戏就绪素材。更妙的是，它可以整体安装为Codex / Claude 技能（Skill）——装好后你用自然语言提需求，AI Agent 会替你检查权限、补齐参数、驱动整条流水线并把成品文件交到你手上。

为什么值得装成 AI Agent 技能？

传统做法是拿图像模型硬要"sprite sheet"，结果往往是：脸每帧都在变、背景抠不干净、姿势漂移出格、引擎根本没法吃。sprite-gen 用"组件行"（component-row）流水线解决了这个问题：

• 锁住角色身份：按状态一行一行生成，而不是整张网格一把梭；
• 真实透明通道：绿/品红幕布抠图走"反混合"而非硬剥，边缘没有色边残留；
• 引擎可直接消费：图集附带manifest.json.frame_layout，帧矩形、fps、循环标志全部写死，引擎采样不靠猜；
• 最后 10% 可人工把关：内置 curation webview，逐帧对比、拖拽换帧、实时预览循环。

而装成 Codex/Claude 技能后，这些能力变成 Agent 的"本能"：它会先跑只读的workflow向导检查你的凭据和默认配置，只问缺失的问题，然后按 用户工作流契约 走完生成、QA、交付全流程。你只需要说"帮我做一组像素风骑士精灵，要 idle、walk、attack"。

三步安装：把 sprite-gen 装成技能

安装要求不高：Python 3.11+（依赖 Pillow、NumPy），视频流水线另需ffmpeg、img2webp，走 Grok 视频用你自己的登录态。完整依赖清单见 SKILL.md 头部的depends_on声明，打包元数据在 pyproject.toml。

# 1. 克隆仓库 git clone https://gitcode.com/gh_mirrors/sp/sprite-gen # 2. 在项目 venv 里安装（venv 是该技能唯一支持的运行环境） cd sprite-gen python3 -m venv .venv && source .venv/bin/activate pip install -e . # 3. 验证 sprite-gen --help

然后把它注册为技能：

• Codex：使用其自带的技能安装脚本~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py，指定 sprite-gen 仓库路径、技能名sprite-gen即可（官方推荐方式见 SKILL.md）。
• Claude：将仓库目录以同样方式挂载为 Skill，Agent 会通过 SKILL.md 里的"执行路由表"自行分派任务——做精灵走图集流水线，做视频走video-set，做换色/阴影/背景走独立工具组。

⚠️ 技能的所有命令都通过项目.venv的绝对路径执行，禁止回退到全局python3。这条规则和原因（NumPy 依赖门禁）在 docs/interpreter.md 中有完整说明。

AI Agent 如何驱动两条精灵图流水线

装好技能后，Agent 按 docs 索引 中的两条主流水线工作：

流水线 A · 图集行（atlas rows）：一张立绘 + 一份状态清单 →sprite-sheet-alpha.png+ 运行时 manifest。Agent 依次执行prepare（生成请求与提示词）→gen-set（每行状态生成）→extract（去背提取）→compose-atlas（烘焙图集），详见 图集工作流。

流水线 B · 视频→循环（video → loop）：同一张立绘交给视频模型（Grok Imagine），每个状态产出一个无缝透明动画循环。跳跃给高画布、攻击给宽画布，循环切点取片段的真实周期，详见 视频流水线。

两条流水线可以混用：GPT 画立绘、Grok 做动效，Agent 会自动记住你的偏好（defaults save），下次一句话复用。

精选视图：人工修正最后 10%

生成不是终点。sprite-gen curation会启动一个本地 webview：候选帧以卡片形式排开，你可以拖拽换帧、删帧、加帧、旋转，右侧实时预览合成循环，确认无误后一键"Export PNGs / Bake atlas"。这是 精选契约 定义的人机协作层，也是 Agent 交付前的最后一道质检。

选中 idle 帧后还能勾选Breathe：确定性的挤压拉伸呼吸动画会被烘焙进图集，让静态站姿"活"过来，参数细节见 呼吸动画文档。

后处理与导出：换色、呼吸、引擎导出

图集定稿后还有一整组不重绘就能改的工具（工具组 D）：

• 确定性换色：recolor按调色板映射烘焙 N 个变体，同输入同输出字节，见 recolor；
• Aseprite / Phaser / Flame 导出：export-aseprite直接产出引擎友好的分层工程文件；
• 独立素材工具：背景平铺background-tile、脚下投影阴影shadow、动作与接地测量inspect-motion，见 素材工具。

延伸阅读

一句话总结：clone → venv 安装 → 注册成技能，之后你只管用自然语言要精灵图，AI Agent 负责把整条流水线跑完、把最后的挑选权交给你。

【免费下载链接】sprite-genGenerate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.项目地址: https://gitcode.com/gh_mirrors/sp/sprite-gen