VorobiovD/air

O que air faz?

Revisão de código automatizada com verificação, aprendizado de padrões e conhecimento da equipe.

Visão Geral

O VorobiovD/air é uma skill de revisão de código baseada em IA que automatiza o processo de revisão de pull requests e commits. Ao integrar-se diretamente com seus repositórios, ele verifica a qualidade do código, sugere melhorias e aprende os padrões específicos da sua equipe ao longo do tempo.

Funcionalidades Principais

• Revisão Automatizada: Analisa automaticamente pull requests e commits em busca de problemas de estilo, bugs potenciais, vulnerabilidades de segurança e desvios das melhores práticas.
• Verificação Contextual: Vai além de linters estáticos ao entender a lógica de negócios e o contexto do projeto, fornecendo feedback relevante e acionável.
• Aprendizado de Padrões: Aprende com as revisões passadas e com as preferências da sua equipe, adaptando-se gradualmente às suas convenções de codificação e regras específicas do projeto.
• Conhecimento da Equipe: Permite que você codifique o conhecimento institucional em regras e diretrizes, garantindo consistência entre os membros da equipe.

Plataformas Suportadas

• GitHub (via GitHub Actions ou webhooks)
• GitLab (via webhooks)
• Bitbucket (via webhooks)
• Qualquer plataforma git com suporte a webhooks

Como Configurar

1. Clone este repositório e instale as dependências.
2. Configure suas variáveis de ambiente:

   GITHUB_TOKEN=<seu_token_do_github>
   OPENAI_API_KEY=<sua_chave_da_api_openai>
   

3. Configure um webhook no seu repositório apontando para a URL de instância implantada.
4. Personalize as regras em config/rules.yml para corresponder às diretrizes da sua equipe.

Usando com Agentes de IA

Para usar esta skill com agentes como Claude Code ou Cursor, basta incluir este markdown no prompt de configuração do agente. O agente irá:

• Ler e seguir as regras definidas
• Analisar automaticamente as alterações de código
• Fornecer feedback diretamente no contexto da revisão

Exemplo de Prompt

Você é um revisor de código que utiliza o VorobiovD/air. Revise o seguinte diff e:
- Identifique possíveis bugs e vulnerabilidades
- Sugira melhorias de estilo e legibilidade
- Garanta a conformidade com nossas regras de projeto (definidas em config/rules.yml)

Contribuindo

Contribuições são bem-vindas! Por favor, siga as diretrizes de contribuição padrão e certifique-se de que todos os testes passem.

Licença

MIT