Donchitos/Claude-Code-Game-Studios

O que Claude-Code-Game-Studios faz?

Pipeline completo de localização: digitalizar strings fixadas no código, extrair e gerenciar tabelas de strings, validar traduções, gerar briefings para tradutores, realizar revisão cultural/sensibilidade, gerenciar localização de VO, testar requisitos RTL/plataforma, impor congelamento de strings e relatar cobertura.

Visão Geral

Esta skill automatiza todo o processo de localização para jogos, desde a extração de strings até a validação final. Ela foi projetada para ser usada com Claude Code em repositórios de jogos, ajudando equipes a gerenciar traduções, revisões culturais e testes de plataforma de forma eficiente.

Funcionalidades Principais

• Varredura de Strings Hardcoded: Escaneia o código-fonte para encontrar strings não localizadas.
• Extração e Gestão de Tabelas de Strings: Extrai strings para tabelas gerenciáveis (ex: JSON, CSV).
• Validação de Traduções: Verifica se placeholders, formatação e contexto estão corretos.
• Geração de Briefings para Tradutores: Cria documentos com contexto, referências e regras de estilo.
• Revisão Cultural/Sensibilidade: Analisa traduções para possíveis problemas culturais ou ofensivos.
• Gestão de Localização de VO: Coordena arquivos de áudio e scripts de dublagem.
• Teste RTL/Plataforma: Valida suporte para idiomas da direita para a esquerda (RTL) e requisitos de plataforma (ex: limites de caracteres).
• Congelamento de Strings: Impõe que novas strings não sejam adicionadas após uma data limite.
• Relatórios de Cobertura: Gera relatórios detalhados sobre o progresso da localização.

Como Usar

1. Configuração Inicial: Defina o diretório do projeto e os idiomas alvo usando as variáveis de ambiente LOCALE_ROOT e TARGET_LOCALES.
2. Executar Varredura: Use o comando scan-strings para identificar strings hardcoded.
3. Extrair Tabelas: Execute extract-strings para gerar tabelas de tradução.
4. Validar Traduções: Use validate-translations para verificar a integridade das traduções.
5. Gerar Briefings: Execute generate-briefings para preparar documentos para tradutores.
6. Revisão Cultural: Use cultural-review para analisar traduções.
7. Gerenciar VO: Comandos vo-localization para gerenciar arquivos de áudio.
8. Testar RTL/Plataforma: Execute test-rtl e test-platform.
9. Impor Congelamento: Use enforce-string-freeze para bloquear novas strings.
10. Relatar Cobertura: Execute report-coverage para ver o progresso.

Comandos Disponíveis

Comando	Descrição
scan-strings	Varre o código em busca de strings não localizadas
extract-strings	Extrai strings para tabelas de tradução
validate-translations	Valida traduções contra o código-fonte
generate-briefings	Gera briefings para tradutores
cultural-review	Executa revisão cultural e de sensibilidade
vo-localization	Gerencia localização de dublagem
test-rtl	Testa suporte para idiomas RTL
test-platform	Testa requisitos específicos de plataforma
enforce-string-freeze	Impõe congelamento de strings
report-coverage	Gera relatório de cobertura de localização

Variáveis de Ambiente

• LOCALE_ROOT: Diretório raiz onde os arquivos de localização estão armazenados (padrão: ./locales).
• TARGET_LOCALES: Lista de idiomas alvo separados por vírgula (ex: pt-BR,es-ES,fr-FR).
• STRING_FREEZE_DATE: Data limite para congelamento de strings (formato ISO: YYYY-MM-DD).
• VO_LOCALE_DIR: Diretório para arquivos de áudio localizados (padrão: ./vo).

Exemplo de Uso

# Configurar ambiente
export LOCALE_ROOT="./locales"
export TARGET_LOCALES="pt-BR,es-ES,fr-FR,de-DE"
export STRING_FREEZE_DATE="2025-06-01"

# Executar pipeline completo
claude scan-strings
extract-strings
validate-translations
generate-briefings
cultural-review
vo-localization
test-rtl
test-platform
enforce-string-freeze
report-coverage

Notas

• A skill assume um projeto com estrutura padrão de jogos (Unity, Unreal, etc.).
• Certifique-se de que as dependências (ex: jq, node) estejam instaladas para comandos de validação.
• Para VO, garanta que os arquivos de áudio sigam a nomenclatura esperada (ex: {locale}_{id}.wav).