CommunityImagemgithub.com

Ativos

Gera ativos de imagem finais para jogos (ícones, itens, planos de fundo, personagens, arte de loja) usando o modelo GPT Image mais recente da OpenAI, versão 2 ou posterior, combinando com a arte existente do jogo.

O que é Ativos?

A habilidade 'Ativos' automatiza a geração de ativos de imagem finais para jogos, como ícones, itens, planos de fundo, personagens e arte de loja, utilizando o modelo GPT Image mais recente da OpenAI (versão 2 ou posterior). Ela é projetada para projetos de desenvolvimento de jogos que usam um repositório com convenções de arte, garantindo que os novos ativos combinem estilisticamente com os existentes. A habilidade suporta configuração por projeto, verificando se a geração de imagens está ativada, e orienta o usuário na configuração de uma chave de API OpenAI, armazenando-a de forma segura (Keychain, .env, shell ou arquivo de configuração). O processo inclui planejamento dos ativos com base no estilo e especificações do jogo, geração em lote com parâmetros como tamanho, transparência e modelo (automático ou rápido), verificação visual de cada imagem (com até 3 regenerações) e relatório final listando os ativos gerados, caminhos, modelos e quaisquer problemas. A habilidade também registra cada geração em um arquivo de log e alerta sobre a necessidade de divulgação de conteúdo gerado por IA, se aplicável.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/robson-work/gd-toolkit/tree/HEAD/skills/asset

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Ativos de imagem finais

<skill-dir> é a pasta que contém este SKILL.md, e <plugin-root> fica duas pastas acima. Substitua-os pelos caminhos reais nos comandos. (No Claude Code, eles são ${CLAUDE_SKILL_DIR} e ${CLAUDE_PLUGIN_ROOT}.)

Entrada: um ativo ou uma lista, como "ícone de streak freeze" ou "os 6 ícones de recompensa do GDD de daily-quests". Saída: PNGs no caminho de ativos do jogo, cada um registrado com seu prompt e modelo.

Leia primeiro <plugin-root>/shared/conventions.md e a configuração do repositório (seção Art).

GI="<skill-dir>/scripts/gen_image.py"   # Python 3 apenas; nunca imprime a chave
python3 "$GI" check                              # chave + modelo que seria usado, sem custo (execute a partir do repositório do jogo)
python3 "$GI" generate --prompt "…" --out <file.png> [--size WxH] [--background transparent] [--ref <art.png> …] [--log <log.jsonl>]

0. A geração de imagens está ativada para este projeto?

Leia config: Geração de imagens:

  • on: vá para o passo 1.
  • off: não gere. Use arte existente ou o padrão de placeholder do repositório, e liste os ativos ainda necessários (nome, tamanho, uso) no relatório. Não pergunte novamente.
  • not set ou ausente: esta é a primeira imagem para este projeto. Execute check, depois pergunte com a ferramenta de pergunta:
    • Se nenhuma chave foi encontrada, a pergunta informa que os ativos finais usam por padrão o GPT Image da OpenAI (a versão mais recente, 2 ou posterior) e que uma chave de API é necessária. As opções são:
      1. Configurar uma chave agora (Recomendado): mostre as etapas de configuração abaixo e aguarde até o usuário dizer que está pronto. Então execute check novamente. Quando estiver pronto, escreva on.
      2. Não para este projeto: escreva off (opted out <YYYY-MM-DD>) e continue sem arte gerada.
      3. Agora não: pule imagens desta vez, deixe o campo not set e pergunte novamente na próxima vez.
    • Se uma chave foi encontrada (no .env do repositório, no ambiente, ou configurada para outro projeto), a pergunta informa onde foi encontrada e o modelo que check escolheu. Se check disser que o arquivo .env é rastreado pelo git, avise que a chave está comprometida e deve ser rotacionada, e recomende movê-la para fora do git. As opções são: usar para este projeto (Recomendado, então escreva on), não para este projeto (off), e agora não.

Configuração da chave de API (mostre ao usuário)

  1. Acesse platform.openai.com → API keys → Create new secret key. Uma chave com escopo de projeto é a melhor.
  2. Certifique-se de que Billing tenha crédito. Os modelos GPT Image podem pedir que você verifique sua organização (Settings → Organization → General). O acesso pode levar alguns minutos para ser ativado após a verificação.
  3. Salve a chave nesta máquina. Nunca cole no chat.
    • macOS (recomendado): execute no Terminal. Ele pede a chave sem mostrá-la e a armazena no Keychain: security add-generic-password -U -a "$USER" -s gd-toolkit-openai -w
    • Apenas este projeto: adicione OPENAI_API_KEY=… ao .env ou .env.local do repositório. Verifique se o arquivo está no .gitignore primeiro.
    • Em qualquer lugar: adicione export OPENAI_API_KEY=… ao seu perfil de shell, como ~/.zshrc, depois abra um novo terminal.
    • Ou use um arquivo legível apenas por você: ~/.config/gd-toolkit/openai_api_key (chmod 600).
  4. Avise-me quando estiver pronto, e eu verificarei. Essa verificação não custa nada.

Uma chave no Keychain, no shell ou no arquivo de configuração funciona para todos os projetos; uma chave no .env funciona para seu repositório e tem prioridade sobre o Keychain. A escolha on/off é feita por projeto.

1. Planeje os ativos

  • Estilo: leia config: Estilo de arte e veja as artes de referência listadas. Passe 1–4 dos ativos existentes mais próximos como --ref, para que a nova arte combine com o jogo. Descreva o estilo em todos os prompts com as mesmas palavras: paleta, espessura de linha, sombreamento, ângulo de câmera e material.
  • Especificações: para cada ativo, seu tamanho final, formato, se precisa de transparência, nome do arquivo e caminho (config: Diretório de ativos, mais o padrão de nomenclatura do repositório).
  • Mostre a lista, com contagem total e modelo, e gere assim que o usuário aprovar. Uma confirmação cobre o lote.

2. Gere

  • Modelo: --model auto (padrão) usa o modelo gpt-image mais recente, versão 2 ou posterior, que a chave pode usar, preferindo a variante detalhada para arte final. --fast (passado como --prefer fast) é apenas para rascunhos. Se config: Modelo de imagem nomear um modelo, passe-o com --model.
  • Tamanho: gere no maior quadrado ou proporção mais próxima do modelo, depois reduza para os tamanhos finais (sips -Z <px> no macOS). Nunca aumente.
  • Transparência: ícones, itens e sprites precisam de --background transparent. Se a saída indicar que o modelo rejeitou, a imagem foi gerada opaca: regenere com uma cor de fundo plana e simples nomeada no prompt, remova essa cor e informe no relatório.
  • Prompt: descreva o assunto, depois o bloco de estilo, depois a composição (centralizado, padding, sem texto a menos que solicitado). Peça para não conter palavras, logotipos ou marcas d'água, a menos que o ativo precise de texto.
  • Registre cada geração em config: Log de arte (--log). Nunca coloque arquivos de metadados ao lado dos ativos entregues.

3. Verifique cada imagem

Olhe para cada imagem antes de mantê-la, usando uma cópia pequena para economizar contexto. Regenere-a, no máximo 3 vezes, se não corresponder às referências de estilo, tiver texto estranho ou artefatos, estiver cortada incorretamente ou for ilegível em seu menor tamanho no jogo. Se ainda falhar, mantenha a melhor e sinalize-a.

4. Relatório

Liste cada ativo com seu caminho, tamanhos, modelo e quaisquer sinalizações. Também forneça os ativos ainda necessários (se a geração estiver off ou pulada), e o caminho do log. Informe que as imagens são geradas por IA, para que o proprietário possa decidir onde isso precisa ser divulgado, como em listagens de loja.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas