Pet Hatch

Integração OpenDesign. Esta é a habilidade Codex hatch-pet não modificada, vendida sob skills/hatch-pet/ para que qualquer agente OpenDesign possa executá-la. Após a habilidade terminar de empacotar, o spritesheet.webp resultante (em ${CODEX_HOME:-$HOME/.codex}/pets/<pet-name>/) pode ser importado para o companheiro pet flutuante via Configurações → Geral → Pets → Importar sprite Codex. O fluxo de importação detecta automaticamente o atlas 8×9 / 192×208 e permite que o usuário escolha qual linha de animação reproduzir (parado, correndo para a direita, acenando, …).

Visão Geral

Crie um pet animado compatível com Codex a partir de um conceito, uma ou mais imagens de referência, ou ambos. Esta habilidade gerencia o planejamento de prompts específico para pets, linhas de animação, extração de quadros, geometria do atlas, QA, pré-visualizações e empacotamento. Ela delega a geração visual para $imagegen.

As entradas visíveis para o usuário são opcionais. Se o usuário omitir um nome para o pet, infira um a partir do conceito ou dos nomes dos arquivos de referência; se isso não for possível, escolha um nome curto e apropriado. Se o usuário omitir uma descrição, infira uma a partir do conceito ou das referências. Se o usuário omitir imagens de referência, gere o pet base a partir do texto primeiro, e então use essa base como a referência canônica para cada linha de animação.

Delegação de Geração

Use $imagegen para toda a geração visual normal.

Antes de gerar a arte base, as tiras de linha ou as linhas de reparo, carregue e siga a habilidade de geração de imagem instalada:

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

Não chame a API de Imagem diretamente para o caminho normal. Deixe $imagegen escolher seu próprio caminho com prioridade para o built-in e suas próprias regras de fallback de CLI. Se $imagegen indicar que um fallback requer confirmação, pergunte ao usuário antes de continuar.

Ao invocar $imagegen desta habilidade, passe o prompt do pet gerado como a especificação visual autoritativa. Não o envolva no esquema de prompt compartilhado genérico $imagegen e não adicione polimento extra, arte de destaque, foto, produto ou aumento de estilo de ilustração. Os prompts de pet devem permanecer concisos, específicos para sprites e orientados para pets digitais; adicione apenas rótulos de função para as imagens de entrada e quaisquer restrições essenciais do usuário.

Use os scripts desta habilidade apenas para trabalho determinístico: preparação de prompts e manifestos, ingestão de saídas $imagegen selecionadas, extração de quadros, validação de linhas, composição do atlas final, criação de mídia de QA e empacotamento.

Limite rígido: não crie, desenhe, tile, distorça, espelhe ou sintetize visuais de pet com scripts locais Python/Pillow, SVG, canvas, HTML/CSS ou outra arte nativa de código como substituto para $imagegen. Para uma execução normal de pet, espere até 10 trabalhos de geração visual: 1 pet base mais 9 trabalhos de tira de linha. A única exceção é running-left, que pode ser derivado espelhando running-right apenas após running-right ter sido gerado, inspecionado visualmente e explicitamente aprovado como seguro para espelhar. Se espelhar não for apropriado, gere running-left como uma linha $imagegen normal e fundamentada. Se essas chamadas forem muito caras, bloqueadas ou indisponíveis, pare e explique o bloqueio em vez de fabricar tiras de linha localmente.

Não marque os trabalhos visuais como concluídos editando imagegen-jobs.json, copiando arquivos para decoded/ ou escrevendo scripts auxiliares que preencham as saídas de linha. Use record_imagegen_result.py para saídas $imagegen built-in selecionadas, ou generate_pet_images.py apenas para o fallback secundário documentado. Os scripts determinísticos só podem processar saídas visuais já geradas.

Apenas o trabalho base pode ser apenas por prompt. Cada trabalho de tira de linha gerado através de $imagegen deve usar as imagens de entrada listadas em imagegen-jobs.json, incluindo a referência base canônica criada após o registro do trabalho base. Trate qualquer geração de linha sem imagens de aterramento anexadas como inválida.

Estilo de Pet Digital Codex

A arte padrão do pet deve corresponder aos pets digitais built-in do aplicativo Codex: mascotes pequenos adjacentes a pixel art com proporções chibi compactas, silhuetas robustas e legíveis, contornos grossos e escuros de 1-2 px, bordas de pixel/escalonadas visíveis, paletas limitadas, sombreamento cel plano, rostos expressivos simples e membros minúsculos. Mesmo que a arte de referência seja mais detalhada, complexa ou realista, o pet gerado deve ser simplificado para este estilo.

…