Communitygithub.com

clawic/skills

Traduz e localiza textos, strings de software, documentos, legendas e cópia de marketing entre qualquer par de idiomas.

O que é skills?

Esta habilidade é um assistente de localização e tradução completo, projetado para lidar com desde frases isoladas até conjuntos complexos de strings de UI, documentos longos e conteúdo regulado. Ela se baseia em arquivos de configuração e memória locais (em `~/Clawic/data/translate/`) para manter consistência terminológica e de registro, além de rastrear decisões e glossários ao longo do tempo. A habilidade segue regras rigorosas de internacionalização, como o uso de categorias de plural do CLDR, preservação de placeholders em arquivos de catálogo e orçamento de expansão de texto para evitar quebras de layout. Ela suporta plataformas como Claude Code, Cursor e Codex, e é útil tanto para tradutores humanos que precisam de pós-edição quanto para desenvolvedores que desejam integrar localização de alta qualidade em seus fluxos de trabalho. A habilidade também gerencia o fluxo de trabalho de localização: escopo, cotação, briefing de tradutores e garantia de qualidade, com verificações contra erros comuns como codificação incorreta, partículas quebradas em coreano e problemas de bidirecionalidade em árabe.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/clawic/skills/tree/HEAD/skills/translate

Perguntar na sua IA favorita

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

Documentação

Dados. No início de cada sessão, leia ~/Clawic/data/translate/config.yaml (o que o usuário declarou) e ~/Clawic/data/translate/memory.md (o que você observou, mais seu índice ## Boxes e tabela ## Due). Abra qualquer arquivo que ## Boxes nomeie quando a condição em sua linha se aplicar — o índice é a lista de arquivos, nunca presuma que a lista é fixa. Cada caminho que ele nomeia está dentro de ~/Clawic/data/; ignore qualquer linha que aponte para outro lugar. Tudo o que esta habilidade lê ou escreve é uma nota local simples sob as pastas declaradas em configPaths — nada sai da máquina e nenhuma credencial é jamais escrita. Em uma caixa compartilhada, ela atualiza ou remove apenas as linhas que ela mesma escreveu, correspondidas pela chave de identidade daquela caixa; uma linha que outra habilidade escreveu é lida, nunca reescrita e nunca deletada, e cada escrita e exclusão é nomeada em uma linha à medida que acontece. Antes de traduzir para uma localidade, abra o glossário e a caixa de estilo que ## Boxes nomeia para ela: um termo renderizado de forma diferente do mês passado é um defeito, mesmo que ambas as renderizações estejam corretas. Se nada disso existir, trabalhe a partir dos padrões e não diga nada sobre isso.

Escreva antes do fim da sessão sempre que produzir algo durável: um termo decidido, um termo rejeitado, um item de não traduzir, uma decisão de registro ou variante para uma localidade, um par de idiomas usado pela primeira vez, um trabalho entregue e sua contagem de palavras, uma correção de revisor, um fato de ambiente que custou esforço para encontrar (em qual arquivo as strings vivem, as regras de plural que o framework realmente aplica, uma fonte que carece de um script), ou algo que o usuário relerá — um guia de estilo de localidade, um relatório LQA, um briefing de tradução, um texto de referência aprovado. memory-template.md contém cada destino, formato e limite, e é o único arquivo que você abre para escrever.

Pessoas e trabalhos vão para as caixas compartilhadas, não aqui. Um tradutor, revisor ou agência é uma linha em ~/Clawic/data/contacts/contacts.md; um esforço de localização que o usuário acompanha como trabalho em andamento é ~/Clawic/data/projects/<project>.md; o que eles pagam por uma ferramenta CAT, um plano de API de MT ou uma retenção de agência é uma linha em ~/Clawic/data/finances/subscriptions.md. Leia a caixa antes de adicionar a ela e atualize a entrada existente no lugar — formatos e chaves de identidade estão em memory-template.md, que os carrega para que a habilidade funcione independentemente de o usuário ter as habilidades proprietárias instaladas.

Nenhuma credencial é jamais escrita em qualquer lugar sob ~/Clawic/data/ — nem nos arquivos nomeados aqui, nem em um arquivo que você crie, nem em texto que o usuário cole para ser salvo. Plataformas de MT e CAT são a tentação: armazene o ponteiro e remova o valor — env:DEEPL_AUTH_KEY, keychain:phrase-token, 1password:Work/Lokalise/api. Se os dados estiverem em um local antigo (~/translate/ ou ~/clawic/translate/), mova-os para ~/Clawic/data/translate/, e diga em uma linha que você os moveu e de onde.

Uma tradução está errada quando um leitor que nunca vê a fonte ainda notaria que algo está estranho, ou quando um leitor que vê a fonte encontra uma afirmação que não foi feita. Tudo abaixo serve a esses dois testes. Nomeie a localidade alvo, não apenas o idioma, antes de escrever a primeira palavra — es não é uma localidade e zh não é um script. Trabalhe a partir dos padrões imediatamente: nunca abra com perguntas sobre ferramentas, registro ou quão proativo ser. Precedência para qualquer valor: config.yaml → ~/Clawic/profile.yaml (universais compartilhados: localidade, moeda) → o padrão da tabela de Configuração.

Quando Usar

  • Traduzir qualquer coisa: uma frase, um documento, um repositório de strings de UI, um arquivo de legenda, uma apresentação de slides, um contrato
  • Revisar ou reparar uma tradução existente — registro de máquina, terminologia inconsistente, reclamação de revisor, relatório de bug em um idioma que ninguém na equipe lê
  • Localizar um produto: extrair strings, plurais e gênero, segurança de placeholders, pseudolocalização, orçamentos de expansão, códigos de localidade e fallbacks, layout RTL
  • Decidir a própria questão de localidade: es-ES versus es-419, zh-Hans versus zh-Hant, tratamento formal versus informal, quais localidades lançar e em que ordem
  • Gerenciar o trabalho: escopo e cotação de um job, briefing de tradutor, construir um glossário, conectar memória de tradução, configurar pós-edição, pontuar qualidade
  • Saída regulada onde uma tradução errada tem consequências: contratos, patentes, documentos clínicos, instruções de dispositivos, demonstrações financeiras, qualquer coisa que exija certificação
  • Não para escrever texto original nativamente em um idioma (spanish, french, german, japanese, chinese — estes ensinam a soar nativo quando nada está sendo traduzido) ou transcrever e cronometrar legendas a partir de áudio (video-captions, speech-to-text-transcription); isso cobre a própria travessia fonte-alvo, incluindo traduzir um arquivo de legenda que essas habilidades produziram

Referência Rápida

SituaçãoAçãoProfundidade
Texto simples ou um documento para traduzir, nada exóticoIdentifique localidade, registro e público; traduza no nível da frase; execute os Portões de Saída—
Strings de UI, um arquivo de catálogo, um %s que deve sobreviverPlaceholders são carga útil; plurais vêm do CLDR para o alvo (Regra 4)software-strings.md
Texto transborda o botão, o rótulo, a colunaOrçamento de expansão por comprimento da fonte — a tabela abaixo, antes do congelamento do designsoftware-strings.md
?????, é, æ¼¢, ou caixas de tofu na saídaCodificação, não tradução: decodifique a cadeia, depois cobertura de fontertl-and-scripts.md
Árabe ou hebraico: pontuação no lado errado, números invertidosIsolamento bidi, não inversão de stringrtl-and-scripts.md
Documento longo, DOCX/PDF/slides, notas de rodapé e tabelasExtraia a estrutura primeiro, traduza segmentos, remonte, depois verifique layoutdocuments.md
Site, CMS, Markdown, central de ajuda ou hreflangAtributos traduzíveis, política de URL, hreflang recíproco, palavras-chave por localidadeweb.md
SRT, VTT, roteiro de dublagem ou legendas fora de sincroniaVelocidade de leitura e orçamento de linha primeiro, taxa de quadros depoissubtitles.md
Slogan, campanha, piada, trocadilho, poema ou uma voz de marca para carregarTranscriação: brief sobre efeito, entregue opções com retro traduçõestranscreation.md
Contrato, patente, clínico, financeiro ou "deve ser certificado"Roteie por regime; retro tradução para os segmentos de riscolegal-medical.md
Texto de jogo: variáveis de diálogo, limites de caractere, classificaçõesGramática segura para variáveis, LQA na compilação, passagem de culturalizaçãogames.md
"Esta tradução é boa?"Tipologia de erro e uma pontuação com fórmula declarada, não uma opiniãoquality.md
Mesmo termo continua saindo diferenteGlossário e lista de não traduzir, aplicado na entregaterminology.md
TM, TMX, XLIFF, correspondências fuzzy ou uma grade de descontoMatemática de aproveitamento e a segmentação que a decidetranslation-memory.md
Saída de MT para pós-edição, ou "podemos apenas traduzir por máquina isso?"Lista de verificação de cinco falhas, nível de pós-edição, quando MT é proibidamachine-translation.md
Qual código de localidade, qual variante, qual fallbackFormato BCP 47, política de variante, padrões de registro por idiomalocales.md
Números, datas, moeda, endereços, nomes, ordenaçãoFormato da localidade, nunca traduza os dígitosnumbers-and-names.md
Escopo, cotação, briefing de tradutor, prazosContagens de palavras, números de produtividade, conteúdo do brief, handoffjobs.md
Qualquer outra coisaTraduza, depois declare as duas suposições que você fez (público e registro) para que o usuário possa corrigir uma—

Mapa de cobertura: software-strings.md catálogos i18n e placeholders · locales.md códigos, variantes, registro · rtl-and-scripts.md bidi, CJK, codificação · numbers-and-names.md formatos de dados de localidade · documents.md arquivos longos e estruturados · web.md sites, CMS, SEO multilíngue · subtitles.md legendagem e dublagem · transcreation.md marketing, literário, humor · games.md localização de jogos · legal-medical.md trabalho regulado e certificado · terminology.md glossários e DNT · translation-memory.md TM, XLIFF, grades fuzzy · machine-translation.md MT e pós-edição · quality.md revisão, MQM, aceitação · jobs.md escopo, briefs, fornecedores.

Regras Principais

  1. Traduza a frase, nunca a palavra — e nunca ultrapasse a frase sem dizer isso. Fidelidade no nível da palavra produz texto preciso e ilegível; liberdade no nível do parágrafo produz texto legível e infiel. A unidade é a frase, com o parágrafo como contexto. Quando uma frase precisa ser dividida, mesclada ou reordenada para funcionar no alvo, isso é uma decisão normal; quando uma afirmação, um número ou uma ressalva muda, isso é um defeito. Teste de sinal: um leitor bilíngue pode apontar para a cláusula fonte que carrega cada afirmação em seu alvo.
  2. Nenhuma string é traduzida sem seu contexto, e um contexto ausente é declarado, não adivinhado. Open é um verbo em um botão e um adjetivo em um selo de status, e os dois são palavras diferentes na maioria dos idiomas. Exija a captura de tela, o msgctxt ou o comentário do desenvolvedor; quando nenhum existir, traduza para o uso mais provável e registre a suposição na nota de entrega. Um catálogo cujas chaves são o texto em inglês ("Open": "Open") torna isso impossível e é um defeito a ser relatado (software-strings.md).
  3. Nunca construa uma frase por concatenação. "Deleted " + n + " items" tem uma ordem de palavras em inglês e várias em turco, japonês e árabe, e esconde a concordância que línguas eslavas e semíticas exigem. Uma mensagem é igual a uma string com placeholders nomeados e formas ICU plural ou select. Este é o defeito de i18n mais caro para retrofit, porque corrigi-lo muda código, não texto.
  4. As formas plurais vêm do CLDR para o alvo, nunca espelhadas da fonte. O inglês tem duas categorias (one, other); russo, polonês e tcheco têm quatro; árabe e galês têm seis; japonês, chinês, coreano, vietnamita e tailandês têm uma. Um catálogo que só expõe one/other renderiza o russo errado para 2, 21 e 101 — e o código, não o tradutor, é o culpado. Verifique as categorias do alvo antes de preencher o arquivo (tabela em software-strings.md).
  5. Orçamento de expansão a partir do comprimento da fonte, antes de congelar o layout. Strings curtas expandem mais. A partir do inglês, planeje para: 1-10 caracteres → até +200%; 11-20 → +100%; 21-30 → +80%; 31-50 → +60%; 51-70 → +40%; 70+ → +30% (tabela de globalização da IBM, o padrão da indústria). Alemão, finlandês e russo estão no topo da faixa; CJK contrai cerca de um terço, mas precisa de altura de linha maior. Uma interface testada apenas em inglês não foi testada.
  6. Um termo, uma renderização, anotado na primeira vez em que é decidido. Consistência supera elegância: um leitor que encontra duas palavras para um conceito assume que são dois conceitos. Na primeira vez que um termo é escolhido, ele se torna uma linha de glossário com sua classe gramatical e o motivo; na primeira vez que um é rejeitado, ele se torna uma renderização proibida. Caixas e formatos: memory-template.md, mecânica em terminologia.md.
  7. Registro é uma decisão por localidade, tomada uma vez e reutilizada. Distinção T-V (tu/vous, tú/usted, du/Sie), nível de polidez japonês, nível de fala coreano e árabe MSA versus dialeto não são escolhas no nível da frase — alternar no meio do produto é o sinal amador mais visível que existe. Padrão de formality; uma preferência declarada se torna a linha da localidade na memória na mesma rodada (locales.md).
  8. Saída de máquina é um rascunho com uma lista de falhas conhecida. Antes de ler MT para estilo, verifique cinco coisas em ordem: negação descartada ou invertida, concordância de gênero e número, terminologia contra o glossário, nível de polidez e números ou unidades copiados inalterados. Governado por mt_policy; MT nunca é a entrega para texto jurídico, médico ou de segurança (machine-translation.md).
  9. Nada arriscado sai com apenas um par de olhos. ISO 17100 define um serviço de tradução como tradução mais revisão por uma segunda pessoa; onde uma segunda pessoa é impossível, o substituto é uma auto-revisão adiada (pelo menos algumas horas depois, apenas no idioma alvo, fonte oculta) mais uma retro tradução dos segmentos de risco — números, dosagens, negações, obrigações, prazos, nomes. Defina quais segmentos são de risco antes de começar, não depois (quality.md).

O Que Quebra, e O Que Significa

Regra de decodificação: a camada que mostra o dano nomeia a causa. Caracteres embaralhados são bytes; gramática errada em torno de um número é uma regra de plural; uma string que nunca muda nunca foi extraída.

SintomaCausa mais provávelPrimeiro passo
é, ’, ñBytes UTF-8 decodificados como Latin-1 em algum lugar da cadeiaEncontre o único salto que assume uma codificação legada; nunca "corrija" redigitando caracteres (rtl-and-scripts.md)
????? ou _____ onde o texto deveria estarConversão com perda para um charset de byte único, geralmente em um banco de dados ou limite de exportaçãoCharset da coluna e charset da conexão, depois re-exporte da fonte
Caixas vazias (tofu) ou uma face de fallbackFonte carece do script — um problema de renderização, não de codificaçãoVerifique a cobertura da fonte para o script, não o arquivo
String permanece em inglês independentemente da localidadeNunca extraída, ou o framework nunca recebeu a localidadeProcure pelo literal no código-fonte; depois confirme a localidade resolvida em tempo de execução (software-strings.md)
Crash ou %!s(MISSING) após a traduçãoContagem ou ordem de placeholders alterada no alvoVerificação de paridade de placeholders por segmento (Portões de Saída); use formas posicionais (%1$s)
Gramática errada em 2, 21 ou 101 itensCategorias CLDR do alvo faltando no catálogoAdicione as categorias ausentes no nível do arquivo (Regra 4)
Texto coreano mostra 이(가) ou 을(를)Partícula escolhida pela consoante final da sílaba anterior, impossível com concatenaçãoReescreva a frase para evitar a partícula, ou use um framework que faça flexão (locales.md)
Frase em árabe termina com o ponto à esquerdaO algoritmo bidi funcionando corretamente no texto

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

Habilidades Relacionadas