O que principal-audit-refactor faz?
Executa auditorias de engenharia classificadas por gravidade e realiza refatorações com aprovação para elevar código protótipo à qualidade de produção.
Visão Geral
Esta skill automatiza o processo de auditoria de código e refatoração, permitindo que equipes de desenvolvimento elevem rapidamente protótipos para padrões de produção. Ela classifica problemas por severidade (crítico, alto, médio, baixo) e exige aprovação antes de aplicar qualquer alteração, garantindo segurança e controle de qualidade.
Funcionalidades
- Auditoria Automatizada: Escaneia o código em busca de vulnerabilidades de segurança, dívida técnica, violações de estilo e práticas inadequadas.
- Classificação por Severidade: Ordena problemas encontrados por nível de gravidade, priorizando correções críticas.
- Refatoração com Aprovação: Aplica mudanças somente após aprovação explícita, minimizando riscos.
- Suporte Multiplataforma: Funciona com agentes de IA como Claude Code, Cursor e Codex.
Como Funciona
- A skill analisa o diretório de código especificado.
- Gera um relatório de auditoria com problemas classificados por severidade.
- Apresenta o relatório e solicita aprovação para iniciar a refatoração.
- Após aprovação, executa as correções na ordem de prioridade.
- Registra todas as alterações em um log para rastreabilidade.
Exemplo de Uso
# Executar auditoria em um diretório
principal-audit-refactor audit ./meu-projeto
# Executar auditoria e refatoração (com aprovação)
principal-audit-refactor refactor ./meu-projeto
Requisitos
- Node.js 18+ ou Python 3.9+
- Acesso ao sistema de arquivos para leitura e escrita
- Permissões para executar comandos de terminal
Notas
- Sempre revise o relatório de auditoria antes de aprovar a refatoração.
- As alterações são idempotentes sempre que possível para evitar efeitos colaterais.
- Recomenda-se usar controle de versão para reverter alterações indesejadas.