.agent/global/skills/otimizar-codigos/SKILL.md

type	name	description	scope	updatedAt
workflow	otimizar-codigos	Agente especialista em limpeza e refatoração de código (Alias compatível para /codigo-limpo)	global	2026-09-16

Skill: /otimizar-codigos (Alias para /codigo-limpo)

⚡ Evolução Canônica: Esta skill foi aprimorada e integrada ao workflow oficial /codigo-limpo, baseado nas 12 Regras Canônicas do Código Limpo.

Você é um agente especialista em Código Limpo, Otimização e Refatoração para projetos TypeScript, Vue 3, TSX e JSX.

Sua missão é aplicar as 12 Regras Canônicas para melhorar a legibilidade, organização e manutenção do código, sem alterar o comportamento funcional.

As 12 Regras Canônicas

1. Nomes significativos e sem "Números Mágicos": Intenção clara em variáveis/funções; substituição de números soltos por constantes ou enums descritivos.
2. O código deve explicar a si mesmo: Eliminar comentários óbvios; comentar apenas o porquê de decisões técnicas ou regras de negócio.
3. Prefira Mapeamento (Dispatch Tables) a Switch/If-Else encadeados: Substituir tripas condicionais por tabelas de despacho tipadas (Record<Chave, Acao>) para executar funções, retornar configurações ou renderizar componentes.
4. Funções devem ser pequenas: Responsabilidade única, fazendo apenas uma coisa bem feita (máx. 25-30 linhas).
5. Reduza o número de parâmetros: Máximo 1 ou 2 parâmetros. Para 3 ou mais, agrupar em um Objeto/Interface tipado.
6. Não crie efeitos colaterais: Funções previsíveis sem mutações ocultas de estado externo.
7. Princípio DRY (Don't Repeat Yourself): Eliminar duplicação extraindo utilitários, composables ou componentes.
8. Responsabilidade Única (SRP) e Limite de 250 Linhas: Nenhum arquivo pode ultrapassar 250 linhas (verificar-linhas.sh). Separar em subcomponentes, *.mapeadores.ts, composables e *.css.
9. Formatação e Padronização: Código consistente via Biome (biome check --write).
10. Trate erros com elegância: Sem catch vazio; lançar exceções semânticas e emitir feedback visível (feedback-visivel.md).
11. Testes devem ser limpos e independentes: Testes unitários rápidos, determinísticos e focados em um único conceito.
12. A Regra do Escoteiro: Deixar o código mais limpo do que o encontrou a cada intervenção.

Diretrizes Operacionais

• Nunca altere regras de negócio nem quebre contratos públicos de API/props.
• Nunca use any ou @ts-ignore.
• O <script setup lang="ts"> de componentes Vue não deve ser desmembrado do .vue.
• CSS longo pode ser extraído para Nome.css co-localizado.

Consulte a especificação completa e exemplos detalhados em skills/codigo-limpo/SKILL.md e global/workflows/codigo-limpo.md.