Communitygithub.com

lec-lerka/revisão-de-tradução

Revise a qualidade das traduções, idioma por idioma, como um editor nativo faria: significado conforme a referência, redação natural, termos consistentes, formalidade correta, gramática adequada para contagens e gênero, comprimento da interface, convenções locais de número/data/unidade e as regras de redação do projeto. Use após a verificação de tradução em textos novos ou alterados, ao revisar um PR que adiciona textos, ou quando solicitado a verificar traduções em todos os idiomas.

O que é revisão-de-tradução?

Esta skill realiza uma revisão detalhada e profissional da qualidade de traduções, idioma por idioma, simulando o olhar de um editor nativo. Ela vai além de simples verificações de sintaxe, avaliando aspectos como fidelidade de significado, naturalidade da redação, consistência de termos, formalidade adequada, concordância gramatical com plurais e gêneros, comprimento para elementos de interface e conformidade com convenções locais (unidades, datas, moedas). É particularmente útil para revisar Pull Requests que adicionam textos, após uma verificação automatizada de tradução (translation-check), ou quando se precisa garantir a qualidade de traduções em múltiplos idiomas. A skill analisa o diff dos arquivos de localização, verifica onde cada chave é usada no código, consulta as regras do projeto (AGENTS.md, .claude/translations.json), e compara com um glossário existente. O resultado é um relatório agrupado por idioma, com sugestões de correção. A skill é compatível com assistentes de código como Claude Code, Cursor e Codex, sendo executada por meio de instruções no SKILL.md. Ela também suporta que o usuário aplique as correções diretamente, executando novamente a verificação de tradução e commitando as alterações.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lec-lerka/claude-skills/tree/main/plugins/i18n/skills/translation-review

Perguntar na sua IA favorita

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

Documentação

Revisão de tradução, um idioma de cada vez

translation-check prova que cada chave existe com os placeholders corretos. Esta skill lê as palavras.

1. Escopo e contexto

  • Quais textos: as chaves que uma alteração adicionou ou editou (diff dos arquivos de localização em relação ao branch base), ou um namespace/arquivo inteiro, se solicitado. Obtenha o valor de referência e o valor de cada idioma lado a lado.
  • Onde aparecem: encontre o uso de cada chave no código (git grep "<key>"). É um botão, um título, um e-mail, um erro, uma dica de ferramenta? Quanto espaço ele tem? Está em uma frase com outras chaves ou recebe um {{count}}, um nome, uma data?
  • Regras do projeto: AGENTS.md e .claude/translations.json, para palavras a evitar, nomes de produtos e planos que permanecem sem tradução, formalidade e quem é o leitor (cliente, revendedor, administrador).
  • Glossário existente: como os mesmos termos já estão traduzidos em outros lugares nos arquivos daquele idioma. git grep um termo na pasta de localização. Consistência supera sua preferência pessoal.

2. Revisar cada idioma separadamente

Para cada idioma, verifique cada texto quanto a:

  1. Significado: diz o mesmo que a referência. Nada adicionado, nada removido, sem falsos cognatos. Os placeholders são usados no papel gramatical correto.
  2. Natural: soa como uma redação própria do produto naquele idioma, e não uma tradução palavra por palavra do inglês. Cuidado com a ordem das palavras, artigos e capitalização (substantivos alemães capitalizados; nenhum Title Case em inglês em outros idiomas).
  3. Termos: a mesma coisa tem o mesmo nome em todos os lugares (relatório, pedido, crédito, VIN, nomes de planos) e corresponde ao glossário da etapa 1.
  4. Formalidade: um único registro em todo o produto, ex. Sie ou du em alemão, ви em ucraniano, vous em francês, Vy em tcheco, Pan/Pani ou formas neutras em polonês. Não os misture.
  5. Gramática com variáveis: formas plurais corretas para contagens reais (1, 2, 5, 21, 22, 25 em ucraniano, polonês, tcheco); caso após preposições; concordância de gênero quando um placeholder é um substantivo.
  6. Comprimento: botões, abas e emblemas devem permanecer aproximadamente tão curtos quanto a referência. Sinalize qualquer coisa cerca de 40% mais longa em um espaço apertado.
  7. Convenções locais: unidades (км, кВт, к.с. em ucraniano/búlgaro), vírgula decimal, ordem da data, posição da moeda, aspas („…" em alemão, « … » em francês, «…» em ucraniano).
  8. Regras do projeto: palavras proibidas, ortografia da marca, nomes de planos.

3. Relatório

Agrupe por idioma e apresente cada descoberta com a chave, o texto atual, o problema e um texto sugerido:

uk — 2 descobertas
- reportPage:upgrade.cta — "Оновити до Complete звіту" — ordem das palavras parece inglesa; Complete é um nome de plano → "Перейти на звіт Complete"
- ...
de — nenhuma descoberta
  • Diga quais idiomas você pode avaliar com confiança. Para aqueles que não puder, diga isso em vez de adivinhar e sugira uma verificação nativa.
  • Se solicitado a corrigir: aplique as sugestões nos arquivos de localização, execute i18n:translation-check novamente e faça commit com a alteração.
  • Em uma revisão de PR, publique estas como Nits, a menos que o significado esteja errado ou uma palavra proibida apareça: nesse caso, é Importante.

Habilidades Relacionadas