i18n e Localização
Visão Geral
Esta cópia de repositório público empacota plugins/antigravity-awesome-skills/skills/i18n-localization de https://github.com/sickn33/antigravity-awesome-skills no formato editorial nativo do Omni Skills sem ocultar sua origem.
Use-a quando o operador precisar que o fluxo de trabalho upstream, os arquivos de suporte e o contexto do repositório permaneçam intactos enquanto o validador público e o aprimorador privado continuam seu fluxo downstream normal.
Esta cópia mantém intactos os arquivos upstream copiados e usa o bloco external_source em metadata.json mais ORIGIN.md como âncora de proveniência para revisão.
i18n e Localização > Internacionalização (i18n) e Localização (L10n) - Melhores práticas. ---
Seções importadas da fonte que não foram mapeadas claramente para os cabeçalhos públicos ainda estão preservadas abaixo ou nos arquivos de suporte. Seções importadas notáveis: 1. Conceitos Principais, 3. Padrões de Implementação, 4. Estrutura de Arquivos, 6. Problemas Comuns, 7. Suporte RTL, 8. Lista de Verificação.
Quando Usar Esta Skill
Use esta seção como o filtro de ativação. Ela deve tornar explícito o limite de ativação antes que o operador carregue arquivos, execute comandos ou abra um pull request.
- Tipo de Projeto - i18n Necessário?
- Aplicativo web público - ✅ Sim
- Produto SaaS - ✅ Sim
- Ferramenta interna - ⚠️ Talvez
- Aplicativo de região única - ⚠️ Considere no futuro
- Projeto pessoal - ❌ Opcional
Tabela de Operação
| Situação | Comece aqui | Por que é importante |
|---|---|---|
| Primeiro uso | metadata.json | Confirma repositório, branch, commit e caminho importado através do bloco external_source antes de tocar no fluxo de trabalho copiado |
| Revisão de proveniência | ORIGIN.md | Fornece aos revisores uma trilha de auditoria em linguagem simples para a fonte importada |
| Execução do fluxo de trabalho | scripts/i18n_checker.py | Começa com o menor arquivo copiado que altera materialmente a execução |
| Contexto de suporte | scripts/i18n_checker.py | Adiciona o próximo arquivo fonte copiado mais relevante sem carregar o pacote inteiro |
| Decisão de transferência | ## Skills Relacionadas | Ajuda o operador a mudar para uma skill nativa mais forte quando a tarefa se desvia |
Fluxo de Trabalho
Este fluxo de trabalho é intencionalmente editorial e operacional ao mesmo tempo. Ele mantém a fonte importada útil para o operador enquanto ainda satisfaz os padrões de recebimento público que alimentam o fluxo downstream do aprimorador.
- Confirme o objetivo do usuário, o escopo do fluxo de trabalho importado e se esta skill ainda é o roteador certo para a tarefa.
- Leia a visão geral e os arquivos de proveniência antes de carregar quaisquer arquivos de suporte upstream copiados.
- Carregue apenas as referências, exemplos, prompts ou scripts que alteram materialmente o resultado para a solicitação atual.
- Execute o fluxo de trabalho upstream mantendo a proveniência e os limites da fonte explícitos nas notas de trabalho.
- Valide o resultado em relação às expectativas upstream e às evidências que você pode apontar nos arquivos copiados.
- Escalone ou transfira para uma skill relacionada quando o trabalho sair do centro de gravidade deste fluxo de trabalho importado.
- Antes da mesclagem ou encerramento, registre o que foi usado, o que mudou e o que o revisor ainda precisa verificar.
Notas do Fluxo de Trabalho Importado
Importado: 1. Conceitos Principais
| Termo | Significado |
|---|---|
| i18n | Internacionalização - tornar o aplicativo traduzível |
| L10n | Localização - traduções reais |
| Locale | Idioma + Região (en-US, tr-TR) |
| RTL | Idiomas da direita para a esquerda (árabe, hebraico) |
Exemplos
Exemplo 1: Solicitar o fluxo de trabalho upstream diretamente
Use @i18n-localization-v2 para lidar com <tarefa>. Comece pelo fluxo de trabalho upstream copiado, carregue apenas os arquivos que alteram o resultado e mantenha a proveniência visível na resposta.
Explicação: Este é o ponto de partida mais seguro quando o operador precisa do fluxo de trabalho importado, mas não do repositório inteiro.
Exemplo 2: Solicitar uma revisão baseada em proveniência
Revise @i18n-localization-v2 com base em metadata.json e ORIGIN.md, depois explique quais arquivos upstream copiados você carregaria primeiro e por quê.
Explicação: Use isso antes de revisão ou solução de problemas quando precisar de uma explicação precisa e auditável da origem e seleção de arquivos.
Exemplo 3: Restringir os arquivos de suporte copiados antes da execução
Use @i18n-localization-v2 para <tarefa>. Carregue apenas as referências, exemplos ou scripts copiados que alteram o resultado e nomeie os arquivos explicitamente antes de prosseguir.
Explicação: Isso mantém a skill alinhada com a divulgação progressiva em vez de carregar todo o pacote copiado por padrão.
Exemplo 4: Criar um pacote para o revisor
Revise @i18n-localization-v2 usando os arquivos upstream copiados mais a proveniência, depois resuma quaisquer lacunas antes da mesclagem.
Explicação: Isso é útil quando o PR está aguardando revisão humana e você deseja um pacote de auditoria reproduzível.
Melhores Práticas
Trate a skill pública gerada como uma camada de empacotamento revisável em torno do repositório upstream. O objetivo é manter a proveniência explícita e carregar apenas o material fonte copiado que melhora materialmente a execução.
- Use chaves de tradução, não texto bruto
- Namespace de traduções por funcionalidade
- Suporte a pluralização
- Manipule formatos de data/número por locale
- Planeje RTL desde o início
- Use formato de mensagem ICU para strings complexas
- Strings hardcoded em componentes
Notas Operacionais Importadas
Importado: 5. Melhores Práticas
FAÇA ✅
- Use chaves de tradução, não texto bruto
- Namespace de traduções por funcionalidade
- Suporte a pluralização
- Manipule formatos de data/número por locale
- Planeje RTL desde o início
- Use formato de mensagem ICU para strings complexas
NÃO FAÇA ❌
- Strings hardcoded em componentes
- Concatenar strings traduzidas
- Assumir comprimento de texto (alemão é 30% mais longo)
- Esquecer do layout RTL
- Misturar idiomas no mesmo arquivo
Solução de Problemas
Problema: O operador pulou o contexto importado e respondeu de forma muito genérica
Sintomas: O resultado ignora o fluxo de trabalho upstream em plugins/antigravity-awesome-skills/skills/i18n-localization, não menciona proveniência ou não usa nenhum arquivo fonte copiado.
Solução: Reabra metadata.json, ORIGIN.md e os arquivos upstream copiados mais relevantes. Verifique o bloco external_source primeiro, depois reafirme a proveniência antes de continuar.
Problema: O fluxo de trabalho importado parece incompleto durante a revisão
Sintomas: Os revisores podem ver o SKILL.md gerado, mas não conseguem identificar rapidamente quais referências, exemplos ou scripts são importantes para a tarefa atual.
Solução: Aponte para as referências, exemplos, scripts ou ativos copiados exatos que justificam o caminho que você seguiu. Se a lacuna ainda for real, registre-a no PR em vez de escondê-la.
Problema: A tarefa se desviou para uma especialização diferente
Sintomas: A skill importada começa no lugar certo, mas o trabalho se transforma em depuração, arquitetura, design, segurança ou orquestração de lançamento que uma skill nativa lida melhor. Solução: Use a seção de skills relacionadas para transferir deliberadamente. Mantenha a proveniência importada visível para que a próxima skill herde o contexto certo em vez de começar às cegas.
Skills Relacionadas
@00-andruia-consultant- Use quando o trabalho for melhor tratado por essa especialização nativa após esta skill importada estabelecer contexto.@00-andruia-consultant-v2- Use quando o trabalho for melhor tratado por essa especialização nativa após esta skill importada estabelecer contexto.@10-andruia-skill-smith- Use quando o trabalho for melhor tratado por essa especialização nativa após esta skill importada estabelecer contexto.@10-andruia-skill-smith-v2- Use quando o trabalho for melhor tratado por essa especialização nativa após esta skill importada estabelecer contexto.
Recursos Adicionais
Use esta matriz de suporte e os arquivos vinculados abaixo como o pacote do operador para esta skill importada. Eles devem refletir material fonte copiado real, não scaffolding genérico.
| Família de recursos | O que fornece ao revisor | Caminho de exemplo |
|---|---|---|
references | notas de referência copiadas, guias ou material de fundo do upstream | references/n/a |
examples | exemplos trabalhados ou prompts reutilizáveis copiados do upstream | examples/n/a |
scripts | scripts auxiliares upstream que alteram a execução ou validação | scripts/i18n_checker.py |
agents | notas de roteamento ou delegação que são genuinamente parte do pacote importado | agents/n/a |
assets | ativos de suporte ou esquemas copiados do pacote de origem | assets/n/a |
Notas de Referência Importadas
Importado: 3. Padrões de Implementação
React (react-i18next)
import { useTranslation } from 'react-i18next';
function Welcome() {
const { t } = useTranslation();
return <h1>{t('welcome.title')}</h1>;
}
Next.js (next-intl)
import { useTranslations } from 'next-intl';
export default function Page() {
const t = useTranslations('Home');
return <h1>{t('title')}</h1>;
}
Python (gettext)
from gettext import gettext as _
print(_("Welcome to our app"))
Importado: 4. Estrutura de Arquivos
locales/
├── en/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
├── tr/
│ ├── common.json
│ ├── auth.json
│ └── errors.json
└── ar/ # RTL
└── ...
Importado: 6. Problemas Comuns
| Problema | Solução |
|---|---|
| Tradução ausente | Falhar para o idioma padrão |
| Strings hardcoded | Use script linter/verificador |
| Formato de data | Use Intl.DateTimeFormat |
| Formato de número | Use Intl.NumberFormat |
| Pluralização | Use formato de mensagem ICU |
Importado: 7. Suporte RTL
/* Propriedades Lógicas CSS */
.container {
margin-inline-start: 1rem; /* Não margin-left */
padding-inline-end: 1rem; /* Não padding-right */
}
[dir="rtl"] .icon {
transform: scaleX(-1);
}
Importado: 8. Lista de Verificação
Antes do lançamento:
- Todas as strings voltadas ao usuário usam chaves de tradução
- Arquivos de locale existem para todos os idiomas suportados
- Formatação de data/número usa a API Intl
- Layout RTL testado (se aplicável)
- Idioma de fallback configurado
- Nenhuma string hardcoded em componentes
Importado: Script
| Script | Propósito | Comando |
|---|---|---|
scripts/i18n_checker.py | Detectar strings hardcoded e traduções ausentes | python scripts/i18n_checker.py <caminho_do_projeto> |
Importado: Limitações
- Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como substituta para validação, teste ou revisão especializada específica do ambiente.
- Pare e peça esclarecimentos se as entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.