用途:规划、生成、质检并打包连续光栅动画帧集、GIF 预览和透明 spritesheet atlas,适合输出连续帧 PNG、单状态 GIF、透明 spritesheet、固定网格 atlas,以及网页或游戏动画素材。单张透明素材不在本技能范围,应转给透明视觉素材相关技能。
主要能力:先定义状态名、各状态帧数、画布尺寸与输出格式;生成或确认一张 canonical base image 作为身份锚点;分状态生成连续帧,保持同一角色参考与统一背景策略;目视质检身份一致、动作连贯、无漂浮杂点、无文字、无阴影地面、无裁切;必要时先用透明素材技能处理为透明 PNG;再用 scripts/compose_sprite_set.py 组合 atlas 并导出每个状态的 GIF 预览,检查 sprite-set-report.json 后做最终验收。
使用方式:准备 manifest,包含 cell_width、cell_height、columns 和 states(name、row、frames、durations_ms),运行: python "${CODEX_HOME:-$HOME/.codex}/skills/sprite-animation-assets/scripts/compose_sprite_set.py" --manifest /absolute/path/manifest.json --frames-dir /absolute/path/frames --output-atlas /absolute/path/spritesheet.png --output-dir /absolute/path/qa --gif 脚本会将每帧居中放入固定 cell,保持未使用 cell 全透明,输出 sprite-set-report.json,并在使用 --gif 时为每个状态导出 GIF 预览。
生图提示词需锁定身份:同一 subject 的分离帧,保持轮廓、比例、脸、配色、描边风格和配件一致,使用纯色可移除背景,无阴影、文字、场景、运动拖尾、帧号、网格线或分离装饰效果,每帧完整可见且可裁切为透明帧。兼容 Codex 自定义宠物 atlas 时,先读 references/sprite-atlas-layouts.md,采用官方 hatch-pet 的 8x9、192x208、9 行状态规格。
限制与验收:每状态帧数须符合 manifest;同一角色在所有帧保持身份与配色;所有帧应为透明背景或可干净抠成透明;动作能循环且首尾无明显跳变;spritesheet 未使用格子必须完全透明;GIF 仅为预览,最终素材优先交付 PNG 帧或透明 atlas。资料未提供收费、平台等其它信息。