用途:该技能用于制作游戏可用的固定单元格像素角色动画,把文字概念、参考图或已有角色美术转换为动作精灵表。适合游戏原型与角色动画素材生产。
主要能力:
- 支持 32x32、64x64、128x128 单元格;用户指定尺寸为硬性交付范围,未指定时默认 64x64。
- 支持 idle(默认 4 帧,可选补到 6 格)、walk(6 帧)、attack(6 帧)等动作。
- 支持默认 8 方向:south、south-east、east、north-east、north、north-west、west、south-west;也支持单方向测试。
- 多尺寸请求需为每个尺寸分别生成原生条带,并遵循分辨率层级:32px 锁定轮廓与姿态节奏,64px 增加内部线条与细节,128px 增加微高光与更细腻的次动作;不得只做缩放变体冒充原生资产。
- 产出固定目录结构,包括 run-manifest.json、source 原图、generated 条带、frames 分帧、final 图集与元数据、qa 验证与联系表、previews 透明/棋盘格预览。
- 提供脚本:assemble_action_sheet.py 拼装、pixel_snap.py 抠像清理、validate_sheet.py 几何与残留验证、audit_sprite_motion.py 动作审计、validate_loop_animation.py 循环动画验证、validate_resolution_hierarchy.py 分辨率层级验证、export_animation_previews.py 预览导出、validate_run_manifest.py 来源与视觉验收验证、import_imagegen_contact_sheet.py 应急导入。
使用方式:
- 先明确范围:尺寸、动作、方向、帧数、武器/职业、必须保留的参考细节。
- 用用户参考图建立角色身份,无法读取图片时应停止而非编造纯文字角色。
- 生成前创建 run/run-manifest.json,记录参考来源、身份细节、范围和生成方式。
- 先生成最小尺寸(通常 32x32)的基础精灵,锁定主设计。
- 按动作-方向-尺寸逐个生成条带,例如 32/walk-south、64/walk-south、128/walk-south;不得用一个提示一次生成完整 8 方向表。
- 每个原生尺寸需有独立 imagegen 输出文件;记录到清单后,依次拼装、清理、验证、导出预览。
- 对循环动作验证循环接缝、身份稳定性和断帧/丢帧;多尺寸任务验证分辨率层级。
- 人工查看每张联系表和每组方向至少一个 GIF/WebP,检查循环接缝至少两圈,写 qa/visual-review.json。
- 只重做弱的方向或帧,不整体重做已合格行。
生成规则:使用 $imagegen 做视觉生成,不用本地代码手绘缺失帧;条带应使用纯色 chroma-key 背景(优先 #00ff00,角色或特效含绿色时用 #ff00ff),无渐变、圆角卡片、阴影、地面、UI、文字或帧编号;帧之间需清晰分隔,身体与武器不得裁切。
适用场景:游戏角色像素动画制作、原型移动包、攻击/行走/跳跃动画、单方向快速测试、多尺寸原生精灵生产。
限制:
- Codex Desktop 中生成图路径示例为 D:\CodexHome\generated_images<thread-id><image-id>.png,需复制到 run/source/;平台无法把生成图暴露为文件时应停止,不能声称完成。
- 验收会阻止以下情况:生成方式为 procedural、python_draw、script 或 text_only;缺少真实本地 imagegen 输出;一个输出复用于多个原生尺寸且未获明确批准;导入联系表却称为原生;参考未用于生成;最终将程序化冒烟测试称为真实图像/参考测试;视觉审查判定与参考、方向或动作不符。
- 聊天中的附件可作为身份依据,但最终交付需为清理后的透明 WebP/GIF 或棋盘格预览,不能直接展示原始 chroma-key 条带。
- 子代理仅在用户明确要求时使用,按动作或方向拆分且路径不重叠。