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ção | Ação | Profundidade |
|---|---|---|
| Texto simples ou um documento para traduzir, nada exótico | Identifique 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 sobreviver | Placeholders 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 coluna | Orçamento de expansão por comprimento da fonte — a tabela abaixo, antes do congelamento do design | software-strings.md |
?????, é, æ¼¢, ou caixas de tofu na saída | Codificação, não tradução: decodifique a cadeia, depois cobertura de fonte | rtl-and-scripts.md |
| Árabe ou hebraico: pontuação no lado errado, números invertidos | Isolamento bidi, não inversão de string | rtl-and-scripts.md |
| Documento longo, DOCX/PDF/slides, notas de rodapé e tabelas | Extraia a estrutura primeiro, traduza segmentos, remonte, depois verifique layout | documents.md |
| Site, CMS, Markdown, central de ajuda ou hreflang | Atributos traduzíveis, política de URL, hreflang recíproco, palavras-chave por localidade | web.md |
| SRT, VTT, roteiro de dublagem ou legendas fora de sincronia | Velocidade de leitura e orçamento de linha primeiro, taxa de quadros depois | subtitles.md |
| Slogan, campanha, piada, trocadilho, poema ou uma voz de marca para carregar | Transcriação: brief sobre efeito, entregue opções com retro traduções | transcreation.md |
| Contrato, patente, clínico, financeiro ou "deve ser certificado" | Roteie por regime; retro tradução para os segmentos de risco | legal-medical.md |
| Texto de jogo: variáveis de diálogo, limites de caractere, classificações | Gramática segura para variáveis, LQA na compilação, passagem de culturalização | games.md |
| "Esta tradução é boa?" | Tipologia de erro e uma pontuação com fórmula declarada, não uma opinião | quality.md |
| Mesmo termo continua saindo diferente | Glossário e lista de não traduzir, aplicado na entrega | terminology.md |
| TM, TMX, XLIFF, correspondências fuzzy ou uma grade de desconto | Matemática de aproveitamento e a segmentação que a decide | translation-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 é proibida | machine-translation.md |
| Qual código de localidade, qual variante, qual fallback | Formato BCP 47, política de variante, padrões de registro por idioma | locales.md |
| Números, datas, moeda, endereços, nomes, ordenação | Formato da localidade, nunca traduza os dígitos | numbers-and-names.md |
| Escopo, cotação, briefing de tradutor, prazos | Contagens de palavras, números de produtividade, conteúdo do brief, handoff | jobs.md |
| Qualquer outra coisa | Traduza, 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
- 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.
- 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, omsgctxtou 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). - 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. - 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õeone/otherrenderiza 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 emsoftware-strings.md). - 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.
- 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 emterminologia.md. - 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). - 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). - 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.
| Sintoma | Causa mais provável | Primeiro passo |
|---|---|---|
é, ’, ñ | Bytes UTF-8 decodificados como Latin-1 em algum lugar da cadeia | Encontre o único salto que assume uma codificação legada; nunca "corrija" redigitando caracteres (rtl-and-scripts.md) |
????? ou _____ onde o texto deveria estar | Conversão com perda para um charset de byte único, geralmente em um banco de dados ou limite de exportação | Charset da coluna e charset da conexão, depois re-exporte da fonte |
| Caixas vazias (tofu) ou uma face de fallback | Fonte carece do script — um problema de renderização, não de codificação | Verifique a cobertura da fonte para o script, não o arquivo |
| String permanece em inglês independentemente da localidade | Nunca extraída, ou o framework nunca recebeu a localidade | Procure 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ção | Contagem ou ordem de placeholders alterada no alvo | Verificaçã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 itens | Categorias CLDR do alvo faltando no catálogo | Adicione 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ção | Reescreva 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 à esquerda | O algoritmo bidi funcionando corretamente no texto |