Communitygithub.com

zhcmeng/shared-skills

Quando o usuário solicita a tradução de documentos em inglês para chinês, gerando arquivos com sufixo `-中文版`, ou pede «tradução um-para-um / tradução completa / localização» de um arquivo Markdown em inglês (especialmente SKILL.md, documentação técnica). Palavras-chave: tradução, localização, versão chinesa, zh-CN, translate, um-para-um.

O que é shared-skills?

Esta skill automatiza a tradução um-para-um de documentação Markdown em inglês para chinês, produzindo arquivos com o sufixo `-中文版.md` (ex: `X.md` → `X-中文版.md`) no mesmo diretório. O objetivo é manter a correspondência exata de estrutura: títulos, parágrafos, listas, tabelas, blocos de código e diagramas são preservados sem adições, exclusões, fusões ou paráfrases. A tradução é delegada a subagentes (modelo 'haiku'), liberando o agente principal para apenas localizar os arquivos de origem, despachar as tarefas, validar o resultado (via diff) e reportar ao usuário — nunca lendo o original ou traduzindo diretamente. A skill suporta a tradução de um único arquivo, de um diretório (ignorando arquivos já traduzidos) ou de um SKILL.md identificado por nome de skill no `$ARGUMENTS`. As regras de tradução garantem a preservação de frontmatter (apenas description traduzido), inserção de bloco de citação de aviso, não tradução de blocos de código e código inline, primeiro uso de termos técnicos no formato «chinês (English)» e tratamento adequado de tabelas e links. Essa abordagem é ideal para manter documentação técnica bilíngue consistente e de alta qualidade no ecossistema de agentes de IA.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zhcmeng/shared-skills/tree/HEAD/plugin/skills/translate-docs

Perguntar na sua IA favorita

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

Documentação

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:

  1. Produto final: Arquivo em inglês X.md → X-中文版.md no mesmo diretório.
  2. 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.
  3. 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>`.
  4. 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.
  5. Código inline preservado: Conteúdo entre crases (nomes de skills, caminhos de arquivo, comandos, identificadores, URLs) é mantido em inglês.
  6. 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.
  7. 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.
  8. Links: URLs são mantidas; o texto do link é traduzido.
  9. 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.
  10. 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.

  1. 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 seu SKILL.md). Se $ARGUMENTS estiver vazio, significa que a chamada não forneceu um alvo: emita um erro e saia, não adivinhe.
  2. Determinar os arquivos a traduzir:
    • Documento único → esse arquivo (1 arquivo).
    • Diretório → liste todos os .md no diretório, excluindo aqueles que já possuem um -中文版.md correspondente (pule os já existentes, não retraduza).
  3. 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).
  4. Validar e relatar: Após o retorno de cada subagente, o agente principal executa uma verificação diff em 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 do SKILL.md dessa skill, não presuma um caminho absoluto local.
  • Modo diretório: por padrão, ignore arquivos que já possuem um -中文版.md correspondente; sob solicitação explícita do usuário, permita sobrescrever e retraduzir.

Habilidades Relacionadas