用途：从概念、品牌线索、公司名称或参考图创建 AgentBro/Codex 兼容的动画宠物，也可修复、校验、视觉 QA 并打包。它是 hatch-pet 的后端灵活版本，保留确定性脚本，但不要求 Codex 的 $imagegen 路径。
主要能力：管理 imagegen-jobs.json 生成任务清单；生成基础宠物图与各状态横向动画条；按固定 9 个状态（idle、running-right、running-left、waving、jumping、failed、waiting、running、review）输出 1536x1872、8列x9行、单元格192x208、透明背景的 PNG/WebP 图集；提供帧提取、检查、合成、校验、接触表与动画预览脚本；支持 pixel、plush、clay、sticker、flat-vector、3d-toy、painterly、brand-inspired、auto 等风格。
使用方式：先运行 prepare_pet_run.py 创建运行目录与任务清单；按后端契约生成并复制 base，再生成 idle 与 running-right；仅在视觉安全时用 derive_running_left_from_running_right.py 派生 running-left；所有任务完成后依次运行 extract_strip_frames.py、inspect_frames.py、compose_atlas.py、validate_atlas.py、make_contact_sheet.py、render_animation_previews.py；最后打包 pet.json 与 spritesheet.webp。
适用场景：需要为 AgentBro/Codex 或通用项目制作统一风格动画宠物，且环境具备可调用的图像生成后端。
限制：行条任务必须使用清单中的输入图，后端无法附加参考图时应停止而非伪造；不得使用代码生成占位图；布局指南不得作为选中源或复制进 decoded/；禁止文字、UI、阴影、速度线、分离特效及与抠图色相近的颜色；默认避免品牌 logo 与可读标记；若仅有裸品牌名且无法联网搜索，需先向用户索取品牌线索。