Tradução de Blog, Tradução de Blog Otimizada para SEO
Traduz um post de blog existente para um ou mais idiomas-alvo. Diferente da tradução genérica, esta skill produz conteúdo otimizado para SEO e pronto para publicação, com palavras-chave localizadas, meta tags e formatação culturalmente correta.
Referências Chave
Carregar sob demanda:
references/translation-rules.md, preservação de formato, formatos de número/data/moeda por localidade, manipulação de citações, critérios de qualidade.references/cultural-adaptation.md, perfis culturais por localidade (DACH, Francófona, Hispânica, Japonesa, personalizado). Este arquivo é compartilhado comblog-localize(não duplicar).
Fluxo de Trabalho
Fase 1: Análise da Entrada
- Leia o arquivo fonte (markdown, MDX ou HTML).
- Detecte automaticamente o idioma de origem. Ordem de preferência:
- Campo
langno frontmatter. - Atributo
langdo HTML. - Análise de conteúdo (script, palavras de parada comuns).
- Campo
- Analise os idiomas-alvo de
--tocomo códigos ISO 639-1 separados por vírgula (de,fr,es,ja,pt-BR). Se--toestiver ausente, pergunte ao usuário uma vez: "Para quais idiomas devo traduzir? Forneça códigos ISO 639-1 (ex.: de, fr, es, ja, pt-BR)." - Valide cada código. Rejeite os inválidos com uma sugestão (
jptorna-se "Você quis dizerjapara Japonês?"). Se um idioma-alvo for igual ao idioma de origem, pule-o com um aviso.
Fase 2: Análise de Conteúdo
Extraia a superfície traduzível:
- Frontmatter:
title,description,tags,author(apenas quando traduzível, ex.: rótulos de cargo, não nomes pessoais). - Todos os cabeçalhos (H1, H2, H3).
- Parágrafos do corpo.
- Texto
altde imagens e conteúdo de<figcaption>. - Conteúdo de
<text>e<tspan>de gráficos; preserve todos os atributos SVG (x,y,font-size,fill,transform). - Perguntas e respostas de FAQ.
- Texto da cápsula de citação.
- Principais conclusões ou caixa de resumo.
- Texto do CTA.
- Texto âncora da zona de link interno.
Preserve inalterado:
- Estrutura, tags e atributos Markdown e HTML.
- URLs de imagens, URLs de links, chaves do frontmatter.
- Blocos de código (traduza apenas comentários inline quando significativos).
- Marcadores de zona de link interno (
[INTERNAL-LINK: ...]). - Nomes de organizações de origem em citações (Gartner, McKinsey, etc.).
- Nomes de pessoas.
- Blocos Schema JSON-LD (traduza apenas os valores de string voltados para o usuário).
Identifique as palavras-chave primárias e secundárias para a Fase 3.
Fase 3: Localização de Palavras-chave
Para cada idioma-alvo:
- Decida se a palavra-chave de origem é o termo estabelecido no mercado-alvo. Se sim (ex.: "Content Marketing" permanece em Alemão), mantenha-a.
- Se um equivalente local tiver comportamento de busca real, troque para ele.
- Aplique a mesma lógica às palavras-chave secundárias.
- Registre o mapeamento. O agente tradutor o utiliza para atualizar título, meta descrição e cabeçalhos H2 de forma consistente.
Fase 4: Tradução
Invoque o agente blog-translator (via Task) para cada idioma-alvo com:
- O conteúdo de origem.
- O mapa de localização de palavras-chave da Fase 3.
- O código do idioma-alvo.
- Ponteiros para
references/translation-rules.mde o perfil cultural emreferences/cultural-adaptation.mdse houver um para a localidade-alvo.
Execute os agentes em paralelo ao traduzir para vários idiomas.
O agente retorna o post totalmente traduzido no mesmo formato da entrada.
Fase 5: Pós-processamento
Para cada versão traduzida:
- Adicione ou atualize o frontmatter de localidade:
lang: "de" translatedFrom: "en" translatedDate: "AAAA-MM-DD" slug: "wie-man-ki-slop-vermeidet" - Verifique a integridade estrutural:
- Mesmo número de seções H2 e H3 que o original.
- Todas as imagens presentes com texto alternativo traduzido.
- Todos os gráficos SVG presentes com rótulos de texto traduzidos (ajustados por comprimento: DE +30%, FR +15%, JA -20%, outros veja
references/translation-rules.md). - Contagem de FAQ corresponde.
- Cápsulas de citação presentes em cada H2.
- Salve os arquivos traduzidos:
Quando invocado detranslations/ {lang}/{slug-localizado}.{ext}blog-multilingual, salve emmultilingual/{lang}/{slug-localizado}.{ext}.
Fase 6: Salvaguardas de Qualidade de Tradução
Examine a saída em busca de artefatos de tradução automática antes de relatar conclusão:
- Expressões idiomáticas literais (expressões idiomáticas em inglês transliteradas, não adaptadas).
- Ordem de palavras não natural (SOV traduzido como SVO em um idioma não SVO, ou o inverso).
- Frases com idiomas misturados (exceto palavras emprestadas estabelecidas).
- Strings de número, data ou moeda ainda no formato de origem.
- Strings do frontmatter ainda no idioma de origem.
Sinalize cada problema inline (caminho do arquivo, número da linha, sugestão de correção). O agente tradutor deve revisar qualquer passagem sinalizada antes da entrega.
Fase 7: Entrega
## Tradução completa: [Título original]
### Origem
- Idioma: [origem]
- Arquivo: [caminho de origem]
### Traduções
| Idioma | Arquivo | Palavras-chave adaptadas | Status |
|--------|---------|---------------------------|--------|
| de | translations/de/{slug}.md | [N] | ok |
| fr | translations/fr/{slug}.md | [N] | ok |
### Verificações de qualidade
- Integridade estrutural: passou / falhou por idioma
- Meta tags localizadas: passou / falhou por idioma
- Números, datas, moedas formatados por localidade: passou / falhou
- Palavras-chave localizadas: [N] palavras-chave adaptadas
- Artefatos de tradução automática sinalizados: [N] (veja notas acima)
### Próximos passos
- Execute `/blog localize <arquivo> --locale <código>` para adaptação cultural profunda.
- Execute `/blog locale-audit translations/` para verificar a integridade.
- Use `/blog multilingual` para combinar escrita, tradução, localização e hreflang em um comando.
Tratamento de Erros
| Cenário | Ação |
|---|---|
| Código de idioma não suportado | Sugerir o código ISO 639-1 correto |
| Origem igual a um alvo | Pular com "A origem já está em [idioma]" |
| Arquivo não encontrado | Reportar erro com caminho sugerido |
| Tempo limite do agente tradutor | Tentar novamente uma vez, depois reportar resultados parciais |
| Arquivo binário ou não textual | Reportar erro, sugerir arquivo correto |
Referências Cruzadas
- Próximo passo (profundidade cultural):
/blog localize <arquivo> --locale <código> - Varredura de QA em todas as versões de idioma:
/blog locale-audit <diretório> - Pipeline de comando único:
/blog multilingual <tópico> --languages <códigos>