Tradução de Documentos em Inglês para Chinês
Visão Geral
Traduz documentos Markdown em inglês para chinês de forma um-para-um, gerando um arquivo com o mesmo nome e sufixo -中文版.md (ex: X.md → X-中文版.md), colocado no mesmo diretório. O princípio central é um-para-um: os níveis de título, parágrafos, listas, tabelas, blocos de código e diagramas devem corresponder exatamente, sem adições, exclusões, fusões/divisões de parágrafos ou reestruturação parafraseada.
Todo o processo de tradução é executado em subagentes — o agente principal apenas localiza o alvo, despacha subagentes, valida o resultado e relata ao usuário. Ele não lê o original, não traduz por conta própria e não sobrecarrega seu contexto.
Regras de Tradução (Especificação Um-para-Um)
As regras a seguir são executadas pelos subagentes e também servem como critérios de validação para o agente principal:
- Produto final: Arquivo em inglês
X.md→X-中文版.mdno mesmo diretório. - Frontmatter: o campo
name:mantém o nome original em inglês;description:é traduzido para chinês; outros campos (se houver) são traduzidos conforme seu valor. - Frase de aviso: Após o frontmatter e antes do título principal, insira uma linha de bloco de citação:
> 📝 Este artigo é a tradução para chinês de \`. O original em inglês é a referência; em caso de divergência, o original deve ser considerado a autoridade.Se a versão de origem for conhecida, escreva comoTraduzido de v<versão>`. - Blocos de código não são traduzidos: Todo o conteúdo dentro de blocos de código cercados (
,dot,mermaid,bash, etc.) é mantido exatamente como está — sem tradução, sem alteração de indentação, sem remoção de linhas. - Código inline preservado: Conteúdo entre crases (nomes de skills, caminhos de arquivo, comandos, identificadores, URLs) é mantido em inglês.
- Primeira ocorrência de termos técnicos: Na primeira aparição, use o formato «chinês (English)». Após isso, apenas o chinês pode ser usado.
- Tabelas: Cabeçalhos e células de texto são traduzidos; células que contêm apenas código, caminhos ou identificadores são preservadas.
- Links: URLs são mantidas; o texto do link é traduzido.
- Notas de rodapé: A definição da nota (
[^n]: url) preserva a URL e traduz o texto explicativo; a referência no corpo ([^n]) é mantida inalterada. - Quebras de linha: As quebras de linha forçadas no arquivo original em inglês não são mantidas no chinês (não há quebra de linha dentro dos parágrafos em chinês); os limites de parágrafo e linhas em branco são preservados.
Fluxo de Trabalho
Independentemente de ser um único documento ou um diretório, a tradução é sempre delegada a subagentes. O agente principal não traduz diretamente.
- Localizar o alvo: Obtenha
$ARGUMENTS— que deve ser o caminho do arquivo a ser traduzido, um diretório, ou o nome de uma skill (ex:superpowers:brainstorming→ localiza seuSKILL.md). Se$ARGUMENTSestiver vazio, significa que a chamada não forneceu um alvo: emita um erro e saia, não adivinhe. - Determinar os arquivos a traduzir:
- Documento único → esse arquivo (1 arquivo).
- Diretório → liste todos os
.mdno diretório, excluindo aqueles que já possuem um-中文版.mdcorrespondente (pule os já existentes, não retraduza).
- Despachar subagentes em paralelo: Para cada arquivo a traduzir, dispare um subagente de propósito geral com
model: "haiku"e o prompt do template abaixo preenchido com o caminho absoluto do arquivo alvo. Todos os subagentes são despachados em uma única mensagem (várias chamadas de agente em paralelo). - Validar e relatar: Após o retorno de cada subagente, o agente principal executa uma verificação
diffem cada resultado (comparando com as regras acima) para confirmar que a tradução um-para-um está completa e sem omissões. Ao usuário, relate apenas o resultado (sucesso / falha / lista de omissões), não o processo de tradução.
Template do Prompt do Subagente
O subagente de propósito geral não herda as regras desta skill; o prompt deve ser autossuficiente:
Você é um agente de tradução de documentos em inglês. Traduza o arquivo Markdown em inglês especificado para o chinês de forma um-para-um, gerando um arquivo com o mesmo nome e sufixo `-中文版.md` (ex: `X.md` → `X-中文版.md`), colocado no mesmo diretório.
Regras:
- Um-para-um: níveis de título, parágrafos, listas, tabelas, blocos de código, diagramas devem corresponder exatamente, sem adições, exclusões, fusão/divisão de parágrafos ou reestruturação parafraseada.
- Frontmatter: o campo name mantém o nome original em inglês; description é traduzido para chinês.
- Após o frontmatter e antes do título principal, insira uma linha de bloco de citação: > 📝 Este artigo é a tradução para chinês de `<nome do arquivo original>`. O original em inglês é a referência; em caso de divergência, o original deve ser considerado a autoridade.
- Blocos de código não são traduzidos: todo o conteúdo dentro de blocos cercados (incluindo dot/mermaid) é mantido exatamente como está.
- Código inline é preservado em inglês (nomes de skills, caminhos de arquivo, comandos, URLs).
- Primeira ocorrência de termos técnicos: use o formato «chinês (English)».
- Tabelas: traduza o texto, preserve código; links: preserve URL, traduza o texto; notas de rodapé: preserve URL, traduza explicação.
- Parágrafos em chinês: não use quebras de linha forçadas.
Arquivo alvo: <caminho absoluto>
Traduza apenas este arquivo; após terminar, retorne um resumo de uma linha (nome do arquivo + sucesso/falha).
Restrições
- Um-para-um é um requisito rígido: sem adições, exclusões, fusão/divisão de parágrafos ou reestruturação parafraseada.
- Blocos de código nunca são traduzidos (incluindo diagramas dot/mermaid — os rótulos dos nós também permanecem em inglês).
- Nomes de arquivo / caminhos / nomes de skills / comandos em inglês são sempre preservados.
- O processo de tradução é sempre concluído em subagentes: o agente principal não lê o original nem traduz diretamente.
- O objeto da tradução vem de
$ARGUMENTS: quando é um nome de skill (ex:superpowers:brainstorming), localize automaticamente o caminho doSKILL.mddessa skill, não presuma um caminho absoluto local. - Modo diretório: por padrão, ignore arquivos que já possuem um
-中文版.mdcorrespondente; sob solicitação explícita do usuário, permita sobrescrever e retraduzir.