Анимированный питомец для Codex

Текст

---
name: hatch-pet
description: Создавай, чини, проверяй, визуально контролируй и упаковывай совместимых с Codex анимированных питомцев и их спрайт-листы по рисунку персонажа, сгенерированным изображениям, фирменным признакам компании или потенциального клиента либо визуальным референсам. Используй, когда пользователю нужен рабочий процесс питомца Codex на лёгких исполнителях, нестандартный непиксельный стиль питомца, питомец-талисман компании или потенциального клиента либо полный анимированный атлас питомца 8x9 с прозрачными неиспользуемыми ячейками, контактными листами для проверки и упаковкой в pet.json. Этот скилл опирается на установленный системный скилл $imagegen для генерации изображений и использует входящие в комплект скрипты для детерминированной сборки спрайт-листа.
---

Вылупление питомца

Обзор

Создай совместимого с Codex анимированного питомца по концепции, фирменному признаку, названию компании или потенциального клиента, одному или нескольким референсным изображениям или любой их комбинации. Этот процесс сохраняет детерминированный конвейер hatch-pet для геометрии атласа, проверки, визуального контроля и упаковки, но использует краткие промты под каждое состояние и допускает любой визуальный стиль, безопасный для питомца.

Входные данные от пользователя необязательны. Если пользователь не указал имя питомца, выведи его из концепции, бренда, компании или имён файлов референсов; если это невозможно, выбери короткое дружелюбное имя. Если пользователь не дал описания, выведи его из концепции или референсов. Если референсных изображений нет, сначала сгенерируй базового питомца по тексту, а затем используй его как канонический референс для каждой строки анимации.

Делегирование генерации

Для всей обычной визуальной генерации используй $imagegen.

Прежде чем генерировать базовое изображение, полосы строк или строки-исправления, загрузи и выполняй установленный скилл генерации изображений:

${CODEX_HOME:-$HOME/.codex}/skills/.system/imagegen/SKILL.md

Не обращайся напрямую к Image API, CLI изображений или любому другому пути генерации изображений. Пусть $imagegen сам выбирает свой путь (сначала встроенный) и правила запасных вариантов. Если $imagegen сообщает, что запасной вариант требует подтверждения, спроси пользователя, прежде чем продолжать.

При вызове $imagegen передавай сгенерированный промт питомца как авторитетную визуальную спецификацию. Промты питомца должны оставаться краткими, привязанными к состоянию, ориентированными на производство спрайтов и опираться на перечисленные входные изображения. Более длинные правила и проверки качества держи в этом скилле и в детерминированных скриптах проверки, а не раздувай ими каждый промт для изображения. Не оборачивай промты в общую схему промтов $imagegen.

Скрипты этого скилла используй только для детерминированной работы с изображениями: подготовки направляющих раскладки и промтов, зеркального отражения одобренной строки running-left, извлечения кадров, проверки строк, сборки итогового атласа и создания контактных листов и превью движения для контроля качества. Шаги с оболочкой и jq на стороне родительского агента отвечают за обновление манифеста, упаковку и очистку.

Контроль хранилища

Встроенный путь $imagegen сохраняет байты сгенерированных PNG в журнале запуска (rollout), который его вызвал, даже когда он также записывает файл в ${CODEX_HOME:-$HOME/.codex}/generated_images. Последующее удаление файлов уменьшает использование файловой системы, но не уменьшает уже записанный журнал. Держи генерацию изображений изолированной и ограниченной:

• Используй одного лёгкого исполнителя генерации на одну визуальную задачу. Не объединяй несколько задач базового изображения или строк в одного исполнителя.
• Исполнители должны возвращать только selected_source=... и qa_note=...; они не должны включать в финальный ответ превью изображений в Markdown, base64 или дополнительные визуальные вложения.
• Родитель не должен визуально открывать каждый сгенерированный PNG. Используй контроль качества исполнителя по каждой задаче и осматривай только итоговый контактный лист.
• После копирования выбранного сгенерированного результата в decoded/ удали выбранный оригинал из ${CODEX_HOME:-$HOME/.codex}/generated_images, если он лежит там, а затем по возможности удали ставший пустым каталог генерации.
• Для полных запусков, чувствительных к хранилищу, спроси пользователя, использовать ли запасной вариант через CLI $imagegen, если он доступен. Этот путь требует локальных учётных данных API и явного подтверждения пользователя, но может избежать встраивания встроенных данных изображений в события журнала.

Изучение бренда

Если пользователь называет бренд, компанию, продукт или потенциального клиента вместо конкретного описания аватара или референсного изображения, перед подготовкой запуска питомца запусти лёгкого субагента-разведчика. Разведчик должен использовать веб-поиск и предпочитать официальные источники: сайт бренда, страницы продукта, документацию, страницы «О нас», пресс-страницы или страницы бренда. Надёжные вторичные источники используй, только когда официальных страниц слишком мало. Держи поиск узким: достаточно, чтобы извлечь визуальные признаки и черты характера, а не писать бриф по исследованию рынка.

Пропусти изучение, когда пользователь уже даёт конкретное описание талисмана или аватара либо референсные изображения, если только он прямо не просит исследовать бренд.

Обязанности разведчика:

• найти в вебе 2–4 подходящих источника, отдавая предпочтение официальным страницам
• написать гибкий бриф в markdown, а не жёсткий перечень полей
• охватить идентичность и категорию, аудиторию и контекст использования, визуальную систему, характер и тон, мотивы продукта и предметной области, подсказки для превращения в талисман, чего избегать, а также доказательства и степень уверенности
• помечать как предположение рекомендации по талисману, выведенные из источников
• не копировать логотипы, читаемые знаки, скриншоты интерфейса, слоганы и текст
• завершить бриф кратким разделом Generation handoff, содержащим только brand_name, brand_brief, avatar_seed, avoid и brand_sources
• не генерировать изображения, не готовить папки запуска и не править посторонние файлы

Используй такой промт для разведчика:

Изучи бренд для создания талисмана в hatch-pet.

Бренд/продукт/потенциальный клиент: <brand name>
Контекст пользователя: <short user request>
Файл результата: <absolute path to brand-discovery.md>

Используй веб-поиск. Отдавай предпочтение официальным страницам бренда, продукта, документации, «О нас», пресс-страницам и страницам бренда. Надёжные вторичные источники используй, только если официальных слишком мало. Запиши гибкий бриф в markdown в файл результата. Заголовки могут меняться в зависимости от бренда, но бриф должен охватывать:
- идентичность и категорию: каноническое название, тип продукта, что он делает
- аудиторию и контекст использования: кому он служит и где встречается
- визуальную систему: палитру, формы, качество линий, материалы, ощущение от шрифтов, иконографию, узоры
- характер и тон: эмоциональные черты, энергию, степень формальности, игривость
- мотивы продукта и предметной области: предметы, рабочие процессы, глаголы, метафоры, окружение
- подсказки для превращения в талисман: возможные формы, фирменные черты, аксессуары, что должно читаться в размере питомца
- чего избегать: логотипы и текст, элементы, чувствительные с точки зрения товарных знаков, вводящие в заблуждение признаки, путаницу с конкурентами, неудачные для талисмана варианты
- доказательства и степень уверенности: URL источников и заметки там, где доказательства слабые или выведены

Не копируй логотипы, читаемые знаки, скриншоты интерфейса, слоганы и текст. Чётко помечай рекомендации по талисману, которые выведены, а не взяты напрямую из источников.

Закончи бриф разделом `Generation handoff`, содержащим ровно:
- brand_name=<canonical brand/product name>
- brand_brief=<one sentence, max 45 words, covering palette/tone/domain motifs/personality>
- avatar_seed=<short mascot-safe visual idea, no logo copying>
- avoid=<short comma-separated list>
- brand_sources=<comma-separated source URLs>

Верни ровно:
brand_discovery_file=<absolute output file path>
brand_name=<canonical brand/product name>
brand_brief=<same compact sentence from Generation handoff>
avatar_seed=<same short seed from Generation handoff>
avoid=<same short avoid list from Generation handoff>
brand_sources=<same comma-separated URLs from Generation handoff>

Родитель должен сохранить бриф в markdown до подготовки запуска, затем передать его в prepare_pet_run.py как --brand-discovery-file вместе с --brand-name, --brand-brief, повторяющимся --brand-source и кратким значением --pet-notes на основе avatar_seed, если пользователь не дал лучшего описания аватара. Держи полный бриф для проверки; на промты должны влиять только компактные поля передачи. Если веб-поиск недоступен, а пользователь назвал лишь бренд, спроси о признаках бренда, прежде чем генерировать.

В обычном запуске питомца ожидай до 10 задач визуальной генерации: 1 базовый питомец плюс 9 задач полос строк. Контракт приложения Codex сейчас использует все 9 состояний: idle, running-right, running-left, waving, jumping, failed, waiting, running и review. Единственное детерминированное визуальное получение — running-left: его можно получить зеркальным отражением running-right только после того, как running-right сгенерирована, визуально осмотрена и явно одобрена как безопасная для отражения. Если зеркальное отражение неуместно, сгенерируй running-left как обычную строку с опорой на изображения через $imagegen.

После выбора визуального результата родительский агент копирует именно это изображение в путь decoded/ этой задачи и отмечает задачу выполненной в imagegen-jobs.json. Не пиши вспомогательные скрипты, заполняющие результаты строк. Детерминированные скрипты Python могут обрабатывать только уже сгенерированные визуальные результаты.

Только базовая задача может быть генерацией по одному промту. Каждая задача полосы строки, сгенерированная через $imagegen, должна использовать входные изображения, перечисленные в imagegen-jobs.json, включая каноническую базовую ссылку, созданную после копирования выбранного базового результата. Считай недействительной любую генерацию строки без приложенных опорных изображений.

Безопасные для питомца стили

Стиль по умолчанию — auto: выведи стиль питомца из промта пользователя и референсов, затем сохраняй этот стиль во всех строках. Если пользователь называет стиль, соблюдай его. Поддерживаемые пресеты стилей: pixel, plush, clay, sticker, flat-vector, 3d-toy, painterly, brand-inspired и auto.

Допустим любой стиль, если он остаётся безопасным для питомца:

• компактный силуэт всего тела, читаемый внутри ячейки 192x208
• одинаковые лицо, пропорции, материал, палитра и аксессуары во всех строках
• чистый фон хромакея, который можно удалить
• детали достаточно крупные, чтобы читаться в размере питомца
• нет текста, подписей, интерфейса и читаемых логотипов, если пользователь прямо не предоставил одобренные референсные работы и не попросил их

Непиксельные стили полноправны. Плюшевый, глиняный, стикерный, векторный, 3D-игрушечный, живописный талисман, тушь и стили, вдохновлённые брендом, следует принимать, если они удовлетворяют ограничениям атласа и читаемости.

Прозрачность и эффекты

Строки питомца обрабатываются в прозрачные ячейки 192x208, поэтому каждый сгенерированный пиксель должен либо принадлежать спрайту питомца, либо быть чистым удаляемым фоном хромакея. Предпочитай изменения позы, выражения и силуэта декоративным эффектам.

Детерминированный растровый конвейер отвечает за инвариант прозрачности: пиксели, которые становятся полностью прозрачными, нормализуются, чтобы не сохранять скрытых остатков RGB, а проверка атласа должна завершаться ошибкой, если экспортированные файлы нарушают этот инвариант. Не маскируй цветные ореолы или остатки в прозрачных пикселях, принимая визуально непоследовательные результаты.

Допустимые эффекты должны удовлетворять всем этим условиям:

• Эффект относится к состоянию и помогает объяснить анимацию.
• Эффект физически прикреплён к силуэту питомца, касается его или перекрывает его, а не парит рядом.
• Эффект находится в том же слоте кадра, что и питомец, и не создаёт отдельного компонента спрайта.
• Эффект непрозрачный, достаточно резкий для чистого извлечения и использует цвета, не совпадающие с хромакеем.
• Эффект достаточно мал, чтобы оставаться читаемым в 192x208 без загромождения.

По умолчанию избегай следующего, потому что оно обычно ломает очистку прозрачного фона или извлечение компонентов:

• меток волн, дуг движения, линий скорости, штрихов действия, остаточных изображений, размытия или смазывания
• отдельных звёзд, свободных искр, парящей пунктуации, парящих значков, падающих слёз, отдельных клубов дыма или свободной пыли
• падающих теней, контактных теней, отброшенных теней, овальных теней на полу, пятен на полу, следов приземления, всплесков удара, свечения, ореола, ауры или мягких прозрачных эффектов
• текста, подписей, номеров кадров, видимых сеток, направляющих отметок, облачков речи, облачков мыслей, панелей интерфейса, фрагментов кода, шахматной прозрачности, белого фона, чёрного фона или декораций
• цветов, близких к хромакею, в питомце, аксессуаре, эффектах, бликах или тенях
• случайных пикселей, оторванных кусочков контура, крапа и шума, обрезанных частей тела, перекрывающихся поз или любой позы, заходящей в соседний слот кадра

Указания по состояниям:

• idle: делай спокойным и ненавязчивым. Используй только едва заметное дыхание, крошечное моргание, лёгкое покачивание головы или тела, очень небольшое покачивание материала или другое тихое движение, сохраняющее характер. Цикл всё равно должен содержать заметное микроразличие; не принимай шесть практически одинаковых копий. Не показывай махание, ходьбу, бег, прыжки, разговор, работу, проверку, эмоциональные реакции, крупные жесты, взаимодействие с предметами или новые аксессуары.
• waving: показывай махание только позой лапы, руки, крыла или конечности. Не рисуй метки волн, дуги движения, линии, искры, символы или парящие эффекты вокруг жеста.
• jumping: показывай вертикальное движение только положением тела. Не рисуй тени, пыль, следы приземления, всплески удара, батуты и намёки на пол.
• failed: слёзы, прикреплённые клубы дыма или прикреплённые звёзды допустимы, если они соответствуют правилам допустимых эффектов; не используй красные крестики, парящие символы, отдельный дым, отдельные звёзды или отдельные капли слёз.
• waiting: покажи, что Codex нужны одобрение, помощь или ввод пользователя, выжидающей просящей позой. Отличай от обычного idle и review.
• running: показывай активную работу над задачей, обработку, размышление, сканирование, набор текста или сосредоточенное усилие. Не показывай буквальный бег ногами, трусцу, спринт, беговую дорожку, поднятые колени, длинные шаги, размахивание руками, движение в определённом направлении, линии скорости, облака пыли, тени на полу, шлейфы движения или отдельные эффекты движения.
• review: показывай сосредоточенность наклоном, морганием, глазами, наклоном головы или положением лапы или руки. Не добавляй лупы, бумаги, код, интерфейс, знаки препинания, символы и другие новые аксессуары, если их нет в базовой идентичности питомца.
• running-right и running-left: показывай движение с направлением (тяга) только движением тела, конечностей и аксессуаров. running-right должна смотреть и двигаться вправо; running-left — влево. Ритм должен заметно чередоваться на протяжении цикла, а не повторять один почти статичный шаг. Не рисуй линии скорости, облака пыли, тени на полу, шлейфы движения или отдельные эффекты движения.

Видимый план выполнения

Для каждого запуска питомца веди видимый контрольный список, чтобы пользователь видел, на каком этапе работа. Создай список до начала, держи активным один шаг и обновляй список по мере завершения каждого шага.

Используй этот список для обычного запуска питомца, заменяя <Pet> на имя питомца или «твоего питомца»:

1. Готовим <Pet>.
2. Придумываем основной облик <Pet>.
3. Рисуем позы <Pet>.
4. Вылупляем <Pet>.

Что означает каждый шаг:

• Готовим <Pet>. Выбери или подтверди имя питомца, описание, исходные изображения, пресет стиля, заметки по стилю и рабочую папку. Для запросов с одним лишь брендом, продуктом или компанией сначала запусти разведчика бренда и зафиксируй компактный бриф бренда, URL источников и зерно аватара.
• Придумываем основной облик <Pet>. Сгенерируй главное референсное изображение питомца. Оно становится визуальным источником истины.
• Рисуем позы <Pet>. Сгенерируй строки поз через лёгких исполнителей, начиная с idle и running-right, чтобы подтвердить идентичность и походку. Отражай running-left зеркально, только если running-right явно работает при отражении.
• Вылупляем <Pet>. Преврати одобренные позы в итоговые файлы питомца, проверь контактный лист, превью и результаты проверки, исправь все сломанные части, сохрани pet.json и spritesheet.webp, затем сообщи пути к результатам.

Отмечай шаг выполненным, только когда реальный файл, изображение или решение существует. Если это запуск для починки, начни с первого подходящего шага, а не перезапускай весь список.

Основной рабочий процесс

1. Подготовь папку запуска питомца и манифест задач imagegen:

SKILL_DIR="${CODEX_HOME:-$HOME/.codex}/skills/hatch-pet"
python "$SKILL_DIR/scripts/prepare_pet_run.py" \
  --pet-name "<Name>" \
  --description "<one sentence>" \
  --reference /absolute/path/to/reference.png \
  --output-dir /absolute/path/to/run \
  --pet-notes "<stable pet description>" \
  --brand-discovery-file /absolute/path/to/brand-discovery.md \
  --brand-name "<optional researched brand name>" \
  --brand-brief "<optional compact researched brand cue sentence>" \
  --brand-source "https://example.com/source" \
  --style-preset auto \
  --style-notes "<optional freeform style notes>" \
  --force

Все аргументы выше необязательны, кроме флагов, нужных для выражения ограничений пользователя. Для запросов только с текстом передай концепцию через --pet-notes и опусти --reference; prepare_pet_run.py при необходимости сам выведет имя, описание, хромакей и выходную папку. Для запросов с одним лишь брендом сначала запусти разведчика, сохрани бриф в markdown, затем передай путь к брифу через --brand-discovery-file, avatar_seed через --pet-notes, brand_name через --brand-name, brand_brief через --brand-brief и каждый URL источника через повторяющийся --brand-source.

1. Изучи imagegen-jobs.json и найди следующие готовые задачи $imagegen. Задача готова, когда её status не равен complete, а каждый id из depends_on уже выполнен. Предпочитай читать манифест напрямую через jq или в редакторе, а не добавлять вспомогательные скрипты для показа статуса:

jq '.jobs[] | {id, kind, status, depends_on, prompt_file, retry_prompt_file, input_images, output_path, derivation_policy}' /absolute/path/to/run/imagegen-jobs.json

1. По умолчанию генерируй визуальные задачи лёгкими исполнителями:

• Сначала сгенерируй и скопируй base, используя лёгкого исполнителя базового изображения.
• Затем сгенерируй и скопируй idle и running-right как проверку идентичности и походки, используя одного лёгкого исполнителя на строку.
• Осмотри running-right; отражай running-left зеркально, только если визуальная идентичность, расположение аксессуаров, отметины, освещение и смысл направления остаются верными.
• Сгенерируй running-left обычным образом лёгким исполнителем, когда отражение изменило бы смысл или идентичность.
• Сгенерируй остальные строки лёгкими исполнителями, используя каждое входное изображение, перечисленное для каждой задачи.

Для каждой готовой визуальной задачи вызывай $imagegen с файлом промта, указанным в imagegen-jobs.json, каждым перечисленным входным изображением с его меткой роли и встроенным путём image_gen по умолчанию, если сам $imagegen не направляет иначе. Родительский агент должен сводить свою работу с изображениями к минимуму: не открывай каждое сгенерированное базовое изображение или строку в журнале родителя. Исполнители возвращают только путь к выбранному источнику и одно предложение с заметкой о качестве; родитель записывает путь выбранного источника в манифест.

prepare_pet_run.py создаёт 9 направляющих изображений раскладки под строки в references/layout-guides/, по одному на состояние анимации. Задачи строк прикладывают подходящую направляющую как входное изображение только для раскладки, чтобы модель следовала правильному числу кадров, интервалам, центрированию и безопасным полям. Считай эти направляющие невидимыми вспомогательными построениями: сгенерированная полоса строки не должна содержать видимых рамок, границ, отметок центра, подписей, цветов направляющих или фона направляющей.

При генерации полос строк сохраняй главенство блокировки идентичности в промте строки. Сохраняй тот же стиль, лицо, отметины, палитру, материалы, дизайн аксессуаров, пропорции тела и силуэт, что и в каноническом базовом изображении. Задачи строк по умолчанию прикладывают направляющую раскладки и каноническую базу; декодированная база хранится в папке запуска для детерминированной обработки, а не отправляется как лишнее входное изображение для генерации.

Если $imagegen возвращает ошибку транспортного уровня Bad Request для строки, повтори эту же строку один раз с её сгенерированным retry_prompt_file. Повторный промт сохраняет id строки, число кадров, хромакей, идентичность канонической базы и действие состояния. Оставь каноническую базу приложенной. Если повтор всё равно не удался, остановись и сообщи о строке, на которой сбой, и путях к промтам, а не переключайся на любой другой путь генерации.

1. После выбора сгенерированного результата для задачи скопируй его в путь декодированного результата и отметь задачу выполненной. Для base также создай каноническую референсную копию идентичности:

RUN_DIR=/absolute/path/to/run
JOB_ID=<job-id>
SOURCE=/absolute/path/to/generated-output.png
OUTPUT_REL=$(jq -r --arg id "$JOB_ID" '.jobs[] | select(.id == $id) | .output_path' "$RUN_DIR/imagegen-jobs.json")
mkdir -p "$(dirname "$RUN_DIR/$OUTPUT_REL")"
cp "$SOURCE" "$RUN_DIR/$OUTPUT_REL"

if [ "$JOB_ID" = "base" ]; then mkdir -p "$RUN_DIR/references"; cp "$RUN_DIR/$OUTPUT_REL" "$RUN_DIR/references/canonical-base.png"; fi

UPDATED_AT=$(date -u +%Y-%m-%dT%H:%M:%SZ)
TMP_MANIFEST=$(mktemp)
jq --arg id "$JOB_ID" --arg source "$SOURCE" --arg at "$UPDATED_AT" '(.jobs[] | select(.id == $id)) += {status: "complete", source_path: $source, completed_at: $at}' "$RUN_DIR/imagegen-jobs.json" > "$TMP_MANIFEST"
mv "$TMP_MANIFEST" "$RUN_DIR/imagegen-jobs.json"

Если скопированный источник находится в ${CODEX_HOME:-$HOME/.codex}/generated_images, удали исходный сгенерированный файл после того, как декодированная копия существует:

GENERATED_ROOT="${CODEX_HOME:-$HOME/.codex}/generated_images"
case "$SOURCE" in
  "$GENERATED_ROOT"/*)
    rm -f "$SOURCE"
    rmdir "$(dirname "$SOURCE")" 2>/dev/null || true
    ;;
esac

1. Получай running-left только когда это визуально безопасно:

python "$SKILL_DIR/scripts/derive_running_left_from_running_right.py" \
  --run-dir /absolute/path/to/run \
  --confirm-appropriate-mirror \
  --decision-note "<why mirroring preserves this pet's identity>"

Этот скрипт отражает каждый слот кадра сгенерированной полосы на месте, чтобы строка влево сохраняла временной порядок строки вправо. Не заменяй его зеркальным отражением всей полосы целиком, которое обращает время анимации.

1. Когда все задачи выполнены, запусти скрипты обработки изображений напрямую:

RUN_DIR=/absolute/path/to/run
mkdir -p "$RUN_DIR/final" "$RUN_DIR/qa"

python "$SKILL_DIR/scripts/extract_strip_frames.py" \
  --decoded-dir "$RUN_DIR/decoded" \
  --output-dir "$RUN_DIR/frames" \
  --states all \
  --method auto

python "$SKILL_DIR/scripts/inspect_frames.py" \
  --frames-root "$RUN_DIR/frames" \
  --json-out "$RUN_DIR/qa/review.json" \
  --require-components

python "$SKILL_DIR/scripts/compose_atlas.py" \
  --frames-root "$RUN_DIR/frames" \
  --output "$RUN_DIR/final/spritesheet.png" \
  --webp-output "$RUN_DIR/final/spritesheet.webp"

python "$SKILL_DIR/scripts/validate_atlas.py" \
  "$RUN_DIR/final/spritesheet.webp" \
  --json-out "$RUN_DIR/final/validation.json"

python "$SKILL_DIR/scripts/make_contact_sheet.py" \
  "$RUN_DIR/final/spritesheet.webp" \
  --output "$RUN_DIR/qa/contact-sheet.png"

python "$SKILL_DIR/scripts/render_animation_previews.py" \
  --frames-root "$RUN_DIR/frames" \
  --output-dir "$RUN_DIR/qa/previews"

Если GIF-превью показывают скачки размера или сдвиги базовой линии, вызванные подгонкой каждого кадра под ячейку при извлечении, а исходная полоса строки сама имела стабильный масштаб и положение, заново запусти извлечение кадров с явным режимом стабильности строк, а затем снова запусти проверку, сборку атласа, валидацию, создание контактного листа и превью:

python "$SKILL_DIR/scripts/extract_strip_frames.py" \
  --decoded-dir "$RUN_DIR/decoded" \
  --output-dir "$RUN_DIR/frames" \
  --states all \
  --method stable-slots

python "$SKILL_DIR/scripts/inspect_frames.py" \
  --frames-root "$RUN_DIR/frames" \
  --json-out "$RUN_DIR/qa/review.json" \
  --require-components \
  --allow-stable-slots

Используй stable-slots как осознанную корректировку по результатам контроля качества, а не как вариант по умолчанию. Она должна уменьшать скачки движения из-за извлечения, не скрывая обрезанные широкие позы или плохие исходные полосы.

Ожидаемый результат до очистки:

run/
  pet_request.json
  imagegen-jobs.json
  prompts/
  decoded/
  frames/frames-manifest.json
  final/spritesheet.webp
  final/validation.json
  qa/contact-sheet.png
  qa/previews/*.gif
  qa/review.json
  qa/run-summary.json

Результат упаковки по умолчанию записывается вне каталога запуска. Если задан CODEX_HOME, используй его; иначе используй $HOME/.codex.

${CODEX_HOME:-$HOME/.codex}/pets/<pet-name>/
  pet.json
  spritesheet.webp

Упаковка через оболочку и jq:

RUN_DIR=/absolute/path/to/run
PET_ID=$(jq -r '.pet_id' "$RUN_DIR/pet_request.json")
DISPLAY_NAME=$(jq -r '.display_name' "$RUN_DIR/pet_request.json")
DESCRIPTION=$(jq -r '.description' "$RUN_DIR/pet_request.json")
PET_DIR="${CODEX_HOME:-$HOME/.codex}/pets/$PET_ID"
mkdir -p "$PET_DIR"
cp "$RUN_DIR/final/spritesheet.webp" "$PET_DIR/spritesheet.webp"
jq -n --arg id "$PET_ID" --arg displayName "$DISPLAY_NAME" --arg description "$DESCRIPTION" '{id: $id, displayName: $displayName, description: $description, spritesheetPath: "spritesheet.webp"}' > "$PET_DIR/pet.json"

Запиши qa/run-summary.json после упаковки:

jq -n --arg run_dir "$RUN_DIR" --arg spritesheet "$RUN_DIR/final/spritesheet.webp" --arg validation "$RUN_DIR/final/validation.json" --arg contact_sheet "$RUN_DIR/qa/contact-sheet.png" --arg review "$RUN_DIR/qa/review.json" --arg package "$PET_DIR" '{ok: true, run_dir: $run_dir, spritesheet: $spritesheet, validation: $validation, contact_sheet: $contact_sheet, review: $review, package: $package}' > "$RUN_DIR/qa/run-summary.json"

После детерминированной обработки изображений осмотри qa/contact-sheet.png и qa/previews/*.gif лёгким исполнителем визуального контроля, прежде чем принимать питомца. Детерминированная проверка необходима, но недостаточна. Блокируй приёмку, если какая-либо строка меняет вид или тип тела, лицо, отметины, палитру, материал, дизайн аксессуара, стиль, неожиданно меняет сторону аксессуара или общий силуэт. Превью движения также должны отклонять непреднамеренные скачки размера, перевёрнутый или застывший ритм движения в направлении, неверное направление взгляда и циклы idle, которые технически различаются, но визуально неподвижны.

После того как модельный визуальный контроль принял контактный лист, удали промежуточные артефакты запуска:

Оставь pet_request.json, final/spritesheet.webp, final/validation.json, qa/contact-sheet.png, qa/previews/, qa/review.json и qa/run-summary.json. Удали сгенерированные файлы промтов, направляющие раскладки, декодированные полосы строк, извлечённые кадры, final/spritesheet.png и манифест задач imagegen. Пропусти очистку, если пользователь хочет отладочные артефакты или запуск ещё нуждается в починке.

Лёгкие визуальные исполнители

Используй лёгких субагентов для тяжёлой работы с изображениями по умолчанию. Это ограничивает каждый журнал $imagegen одним выбранным изображением, держит визуальные данные контактных листов вне родительского потока и снижает стоимость, сохраняя полный контракт приложения из 9 состояний.

Делегирование субагентам

Если пользователь прямо не запретил, используй для этого запуска субагентов. Если пользователь не разрешал использование субагентов или намерение по их использованию неясно, попроси у пользователя разрешение запустить субагентов для параллельных направлений работы.

Обязанности родителя:

• запустить разведчика бренда до подготовки, когда пользователь называет лишь бренд, продукт, компанию или потенциального клиента
• подготовить запуск и изучить imagegen-jobs.json
• поручить базовую задачу, задачи строк и итоговый визуальный контроль контактного листа лёгким исполнителям
• скопировать выбранные результаты исполнителей в их декодированные пути и отметить задачи выполненными в imagegen-jobs.json
• создать references/canonical-base.png из выбранного базового результата
• выполнить одобренное зеркальное получение running-left, когда оно уместно
• выполнить детерминированную обработку изображений, упаковку, повторную генерацию для починки и очистку

Обязанности исполнителя базового изображения:

• обрабатывать только задачу base
• прочитать prompts/base-pet.md и использовать любые перечисленные референсные изображения
• использовать только $imagegen
• учитывать любую компактную строку вдохновения брендом в промте как общее визуальное указание по внешнему виду и характеру, не копируя логотипы, читаемые знаки, скриншоты интерфейса, слоганы и текст
• возвращать только selected_source=/absolute/path/to/selected-output.png и qa_note=<one sentence>

Обязанности исполнителя строки:

• обрабатывать ровно одну задачу строки
• прочитать промт строки и использовать все перечисленные входные изображения
• использовать только $imagegen; не рисовать, не править, не размножать плиткой и не синтезировать спрайты локально
• провести быструю визуальную проверку здравого смысла: число кадров, идентичность, фон хромакея, интервалы, обрезка и отдельные эффекты
• применять правила прозрачности и эффектов из промта строки, включая: никаких отдельных эффектов, никаких меток волн для waving, никаких линий скорости или пыли для строк бега с направлением, никакого буквального бега ногами для строки running без направления и только прикреплённые непрозрачные спрайтовые слёзы, дым и звёзды, когда промт состояния их допускает
• возвращать только selected_source=/absolute/path/to/selected-output.png и qa_note=<one sentence>

Обязанности исполнителя итогового визуального контроля:

• осмотреть qa/contact-sheet.png и GIF строк в qa/previews/, при необходимости используя qa/review.json и final/validation.json как текстовый контекст
• проверить, что все 9 строк соответствуют контракту состояний приложения Codex и одной и той же идентичности питомца
• вернуть компактный результат: visual_qa=pass или visual_qa=fail плюс заметки по починке конкретных строк при провале
• не править файлы, не ставить починки в очередь, не упаковывать и не очищать

Выбор модели для исполнителей:

• Для изучения бренда предпочитай меньшую способную модель, так как он возвращает компактный исследовательский бриф, а не занимается оркестрацией.
• Для визуальных исполнителей предпочитай меньшую способную модель, например gpt-5.4-mini со средним рассуждением, когда доступно переопределение модели.
• Модель родителя или модель по умолчанию используй только для оркестрации или когда меньшая модель исполнителя недоступна.
• Держи не более двух активных исполнителей генерации одновременно, если пользователь прямо не просит большего параллелизма. Запускай итоговый визуальный контроль одним исполнителем после детерминированной обработки изображений. Закрывай исполнителей после того, как их результат использован.

Используй такой промт для исполнителя базового изображения:

Сгенерируй базовое изображение hatch-pet.

Каталог запуска: <absolute run dir>
Id задачи: base
Файл промта: <absolute base prompt file>
Входные изображения:
- <absolute path> — <role>

Используй только $imagegen. Прочитай базовый промт и приложи каждое перечисленное входное изображение. Если в промте есть вдохновение брендом, используй его только как общее указание, безопасное для талисмана; не копируй логотипы, читаемые знаки, скриншоты интерфейса, слоганы и текст. Перед возвратом визуально проверь, что результат — один отцентрованный питомец в полный рост на плоском фоне хромакея, без текста, декораций, теней и отдельных эффектов.

Не правь манифесты, не копируй в decoded, не отмечай задачи выполненными, не генерируй строки, не запускай скрипты обработки изображений, не чини, не упаковывай и не открывай посторонние файлы.
Не включай в финальный ответ превью изображений в Markdown, base64 или дополнительные вложения.

Верни ровно:
selected_source=/absolute/path/to/selected-output.png
qa_note=<one sentence>

Используй такой промт для исполнителя строки:

Сгенерируй одну строку hatch-pet.

Каталог запуска: <absolute run dir>
Id строки: <row-id>
Файл промта: <absolute prompt file>
Файл повторного промта: <absolute retry prompt file>
Входные изображения:
- <absolute path> — <role>
- <absolute path> — <role>

Используй только $imagegen. Прочитай промт строки и приложи каждое перечисленное входное изображение. Если imagegen вернёт Bad Request, повтори один раз с повторным промтом и теми же входными изображениями.

Перед возвратом визуально проверь: точное число кадров, ту же идентичность питомца, что в канонической базе, плоский фон хромакея, полные раздельные необрезанные позы и отсутствие отдельных эффектов и направляющих отметок. Правила прозрачности и эффектов из промта обязательны: никаких отдельных эффектов, никаких меток волн для `waving`, никаких линий скорости или пыли для строк бега с направлением, никакого буквального бега ногами для строки `running` без направления и только прикреплённые непрозрачные спрайтовые слёзы, дым и звёзды, когда промт состояния их допускает.

Не правь манифесты, не копируй в decoded, не отмечай задачи выполненными, не отражай строки зеркально, не запускай скрипты обработки изображений, не чини, не упаковывай и не открывай посторонние файлы.
Не включай в финальный ответ превью изображений в Markdown, base64 или дополнительные вложения.

Верни ровно:
selected_source=/absolute/path/to/selected-output.png
qa_note=<one sentence>

Используй такой промт для исполнителя итогового визуального контроля:

Визуально проверь один итоговый контактный лист hatch-pet.

Каталог запуска: <absolute run dir>
Контактный лист: <absolute run dir>/qa/contact-sheet.png
Каталог превью: <absolute run dir>/qa/previews
JSON проверки: <absolute run dir>/qa/review.json
JSON валидации: <absolute run dir>/final/validation.json

Визуально осмотри контактный лист и GIF-превью. Подтверди ту же идентичность питомца, стиль, палитру, силуэт, лицо, пропорции и аксессуары во всех строках:
0 idle, 1 running-right, 2 running-left, 3 waving, 4 jumping, 5 failed, 6 waiting, 7 running, 8 review.

Забракуй строки с дрейфом идентичности, отсутствующими или пустыми кадрами, скопированными отметками направляющих, белым или непрозрачным фоном, обрезанными телами, наложением слотов, отдельными эффектами, тенями, свечением, смазыванием, пылью, артефактами хромакея, движением, не соответствующим состоянию строки, непреднамеренными скачками размера, неверным направлением взгляда, перевёрнутой или нечередующейся походкой либо циклами idle, которые фактически статичны.

Не правь файлы, не ставь починки в очередь, не упаковывай, не очищай и не проверяй посторонние файлы.

Верни ровно:
visual_qa=pass|fail
qa_note=<one sentence summary>
repair_rows=<comma-separated row ids, or none>
repair_notes=<short row-specific notes, or none>

Порядок починки

Если проверка кадров или итоговый визуальный контроль не пройдены, прочитай qa/review.json, заново сгенерируй наименьшую сбойную область, скопируй заменяющую строку в тот же путь декодированного результата и оставь эту задачу отмеченной выполненной с новыми source_path и completed_at. Чини сбойную строку, а не весь лист.

Для починки идентичности используй каноническое базовое изображение, исходные референсы, контактный лист и точную заметку о сбое строки как опорный контекст. Дай исполнителю строки существующий промт строки плюс краткую заметку о починке из qa/review.json; сохраняй каноническую идентичность питомца и выбранный стиль.

При скачках движения из-за извлечения не начинай с повторной генерации изображений. Если исходная полоса уже сохраняет масштаб и базовую линию на уровне строки, заново запусти детерминированный конвейер с --method stable-slots, проверь с --allow-stable-slots, затем заново проверь GIF-превью. Генерируй строку заново, только когда сама исходная полоса обрезана, нестабильна или семантически неверна.

Правила

• Оставляй $imagegen основным слоем генерации.
• Для запросов о бренде, продукте, компании или потенциальном клиенте без конкретного описания аватара или референсного изображения запусти изучение бренда до генерации базового изображения и передай в запуск только компактный бриф.
• Используй $imagegen как единственный слой визуальной генерации. Не вызывай из этого скилла API изображений, CLI изображений, локальные растровые генераторы или разовые скрипты генерации.
• Держи референсные изображения приложенными и видимыми для $imagegen, когда выбранный путь поддерживает референсы.
• Прикладывай изображение references/layout-guides/<state>.png строки к каждой задаче полосы строки как направляющую только для раскладки и не принимай результаты, копирующие пиксели направляющей.
• По умолчанию используй лёгких визуальных исполнителей для генерации базового изображения, визуальной генерации полос строк и итогового контроля контактного листа; родитель отвечает за обновления манифеста, детерминированные скрипты изображений, упаковку и очистку.
• Генерируй каждую обычную визуальную задачу через $imagegen: базовое изображение плюс все полосы строк, кроме явно одобренных зеркальных получений running-left.
• Считай только базовую задачу допускающей генерацию по одному промту; каждая задача строки должна прикладывать перечисленные для неё опорные изображения.
• Генерируй running-right до того, как решишь, можно ли получить running-left зеркальным отражением.
• При зеркальном получении running-left сохраняй порядок кадров и смысл времени; получай её детерминированным скриптом, а не зеркальным отражением всей полосы целиком.
• Не получай и не используй повторно waiting, running, failed, review, jumping или waving из другого состояния: у каждого своя семантика в приложении, и каждое должно быть сгенерировано как своя строка.
• Никогда не подставляй вместо отсутствующих результатов $imagegen нарисованные локально, размноженные плиткой, преобразованные или сгенерированные кодом полосы строк.
• Отмечай визуальную задачу выполненной только после того, как выбранный результат скопирован в путь декодированного результата.
• Не полагайся на сгенерированные изображения в точной геометрии атласа; используй детерминированные скрипты изображений этого скилла.
• Используй хромакей, сохранённый в pet_request.json; не навязывай фиксированный зелёный экран.
• Держи силуэт, лицо, материалы, палитру, стиль и аксессуары питомца согласованными во всех строках.
• Считай дрейф визуальной идентичности или стиля блокирующей проблемой, даже когда в qa/review.json и final/validation.json нет ошибок.
• Считай проваленным контактный лист, на котором видны обрезанные референсы, повторяющиеся плитки, белый фон ячеек или не относящиеся к спрайту фрагменты.
• Считай проваленными GIF-превью, показывающие скачки размера из-за извлечения, перевёрнутое направленное время, неверное направление взгляда или неподвижные циклы idle.
• Считай проваленными строками запрещённые отдельные эффекты, артефакты, близкие к хромакею, тени, свечение, смазывание, пыль, следы приземления, метки волн, линии скорости или шлейфы движения.
• Считай ошибки в qa/review.json блокирующими. Предупреждения требуют визуального осмотра.

Критерии приёмки

• Итоговый атлас — PNG или WebP, 1536x1872, с поддержкой прозрачности, построен на ячейках 192x208.
• Используемые ячейки не пусты, а неиспользуемые полностью прозрачны.
• Атлас соответствует числу строк и кадров из references/animation-rows.md.
• Контактный лист и превью движения по строкам созданы и осмотрены лёгким исполнителем визуального контроля.
• В qa/review.json нет ошибок.
• Построчная проверка подтверждает, что циклы анимации достаточно полны для приложения Codex.
• Превью движения не показывают непреднамеренных скачков размера, перевёрнутого ритма движения в направлении или неверной семантики строк.
• Непиксельные стили принимаются, если они читаемы в размере питомца и согласованы во всех строках.
• ${CODEX_HOME:-$HOME/.codex}/pets/<pet-name>/pet.json и ${CODEX_HOME:-$HOME/.codex}/pets/<pet-name>/spritesheet.webp подготовлены вместе для пользовательских питомцев.

Перевод: iiuniversitet. Оригинал: https://github.com/openai/skills/tree/main/skills/.curated/hatch-pet, лицензия Apache-2.0. Изменения: перевод на русский язык.