用途
codex-pet 是 RunComfy 上的一个技能，用来从单张参考图生成 Codex 兼容的自定义 Codex Pet。OpenAI Codex Pets（2026 年 5 月发布）是悬浮在桌面上的像素风动画伴侣，会随 Codex 的状态变化产生反应，例如思考时抓头、任务完成时弹出对话气泡。Codex 内置 8 个宠物，同时支持把自定义宠物以文件夹形式安装到本地 ${CODEX_HOME:-$HOME/.codex}/pets/ 下。本技能就是用来批量或按需产出这种自定义宠物的。
主要能力
一个自定义 Codex Pet 文件夹包含恰好两个文件：
- pet.json —— 清单，含 id、displayName、description、spritesheetPath。
- spritesheet.webp —— 精灵图集，1536×1872 的 PNG 或 WebP，8 列 × 9 行、每格 192×208，透明背景。
9 行分别对应 9 种动画状态，每行只使用固定数量的前导帧，其余格子保持完全透明。各行状态、使用列数与帧数为：idle（列 0-5，6 帧）、running-right（0-7，8 帧）、running-left（0-7，8 帧）、waving（0-3，4 帧）、jumping（0-4，5 帧）、failed（0-7，8 帧）、waiting（0-5，6 帧）、running（0-5，6 帧）、review（0-5，6 帧）。
该技能与 OpenAI 官方 hatch-pet 技能的产物完全一致（相同的 pet.json 结构、相同的 1536×1872 图集、相同的 9 行动画），但走 RunComfy CLI 路线，只需一个 RUNCOMFY_TOKEN 加 runcomfy、magick 二进制，不需要 Codex Pro、$imagegen 或 OPENAI_API_KEY。
视觉风格
Codex Pet 的官方视觉风格为：夸大的 Q 版比例（头部约占整体高度的 60%，身体和腿短小粗拙，整体接近正方形包围盒）；像素风低分辨率吉祥物、块状轮廓；1-2 px 深色粗描边、可见的像素阶梯边缘；有限调色板、平涂赛璐璐上色、简单有表现力的脸、极小的四肢；透明背景。需避免：运动线、投影、发光、闪光、漂浮特效、文字标签、场景、白/黑背景。
使用方式
先决条件：RunComfy CLI（npm i -g @runcomfy/cli）、RunComfy 账号（runcomfy login，CI 下可用 RUNCOMFY_TOKEN=<token>）、ImageMagick（macOS：brew install imagemagick；Linux：apt-get install imagemagick），以及一张可公开访问的 HTTPS 源图（JPEG/PNG/WebP）。
管线共 6 步，总计 1 次 GPT Image 2 调用、约 2 分钟：
- 生成标准姿态：一次 runcomfy run openai/gpt-image-2/edit 调用，产出 1024×1024 的 Q 版姿态，背景为品红（#FF00FF）色键。
- 单元格归一化：把品红抠成 alpha 0，裁剪，等比适配到 192×208 并加透明补边。
- 程序化生成 9 行条带：对每个动画状态，用 ImageMagick 微变换（translate/mask/mirror）从标准格生成该行 8 格，尾部未用格填透明，再横向拼接为 1536×208 的行条带。
- 合成图集：把 9 条行条带纵向堆叠为 1536×1872 的图集。
- 转 WebP。
- 写 pet.json 并把两个文件复制到 ${CODEX_HOME:-$HOME/.codex}/pets/<pet-name>/。
安装命令：npx skills add agentspace-so/runcomfy-agent-skills --skill codex-pet -g
提示词要点
唯一一次 GPT Image 2 调用决定一切。要点：开头锁定 Q 版比例（头部约 60% 高）；在基础提示词中明确要求品红 #FF00FF 色键背景，因为 GPT Image 2 只输出 RGB、无 alpha；同时禁止宠物本体使用色键色或接近品红的亮部；固定风格关键词；明确排除错误风格（不要精致插画、不要厚涂、不要动画主视觉、不要 3D、不要光面图标质感、不要写实细节）。反模式包括：写泛泛的 transparent background（模型会画成近白底）、让模型自由发挥比例、在同一提示词中混合多种风格。
微动画调优
第 3 步的默认配方产出与内置宠物相近的细腻动画。可通过调整位移值改变幅度，例如把 idle 的 shift:0:-1 改为 shift:0:-2、加大 running-right 的水平位移、把跳跃峰值从 shift:0:-8 改为 shift:0:-12、把 review 的旋转从 ±2 改为 ±4。位移建议保持在 ≤4 px 或 ≤4° 以内，避免分散注意力。
适用场景
想要自定义 Codex Pet 但没有 Codex Pro / $imagegen 时；希望通过 RunComfy Model API 构建时；需要从一整个源图文件夹批量生成时；以不同底层模型参加 Codex Pet 比赛时。非人类主体（宠物、吉祥物、物件、食物）也可使用，基础提示词会自动将其简化为该风格。
限制
每个 Codex Pet 只有一张标准姿态，动画来自 ImageMagick 变换而非多帧模型生成，因此不会产生强烈动作（例如逐帧差异明显的跑步循环）。GPT Image 2 不输出 alpha，品红色键加后处理只是变通方案；若宠物本身含接近品红的颜色，需在提示词与步骤中同时把色键换成其他纯色（如 #00FFFF 青或 #00FF00 绿）。各行的图集槽位数量必须遵守 Codex 约定（idle=6、running-right/left=8、waving=4、jumping=5、failed=8、waiting/running/review=6）才能被正确播放；可修改第 3 步的 build_row 调用来自定义姿势或替换行。若标准姿态偏离原图身份，可收紧第 1 步的身份保留提示词重跑，其余步骤无需改动。
关于该技能的收费、价格、支持的平台范围等信息，资料暂未提供。