IA Commiter: O Arquiteto de Commits Inteligente

O IA Commiter é uma extensão para o Visual Studio Code que eleva a qualidade e a consistência dos seus commits a um novo patamar. Utilizando o poder de modelos de Inteligência Artificial de ponta (como Gemini, GPT, Claude e Ollama), a extensão analisa suas alterações de código (git diff) e gera automaticamente mensagens de commit semânticas, detalhadas e profissionais, além de manter seu CHANGELOG.md sempre atualizado.

Diga adeus a commits genéricos como "fix" ou "update". Com o IA Commiter, cada commit se torna uma peça de documentação valiosa, criada por um arquiteto de software virtual.

✨ Funcionalidades Principais

• 🤖 Geração de Commits Semânticos: Cria mensagens de commit seguindo o padrão Conventional Commits, analisando o contexto e o impacto das suas alterações.
• 📖 Changelog Automatizado: Atualiza (ou cria) o arquivo CHANGELOG.md a cada novo commit, refletindo as mudanças de forma organizada e acessível.
• 🧠 Análise Multi-IA: Utilize o poder de diferentes provedores de IA (Google Gemini, OpenAI, Anthropic, Ollama) para uma análise técnica profunda do seu código.
• 🚀 Fluxo de Trabalho Simplificado: Integre a geração de commits ao seu fluxo de trabalho Git com um único comando, sem sair do VS Code.
• 🔧 Altamente Configurável: Adapte a extensão escolhendo o provedor de IA, o modelo específico e outras configurações avançadas.

🚀 Começando

Pré-requisitos

• Visual Studio Code: Versão ^1.90.0 ou superior.

• Acesso a uma IA: Para utilizar esta extensão, você precisa de acesso a um dos provedores de IA suportados. A maioria requer uma chave de API.

• Google Gemini: Obtenha sua chave no Google AI Studio.

• OpenAI (GPT): Obtenha sua chave no OpenAI Platform.

• Anthropic (Claude): Obtenha sua chave no Anthropic Console.

• Ollama: Instale o Ollama e tenha um modelo rodando localmente (não requer chave de API).

Instalação

1. Abra o Visual Studio Code.
2. Vá para a aba de Extensões (ou pressione Ctrl+Shift+X).
3. Procure por "IA Commiter".
4. Clique em Instalar.

⚙️ Configuração

Após a instalação, configure a extensão para usar seu provedor de IA preferido.

1. Abra a paleta de comandos (Ctrl+Shift+P).

2. Digite Preferences: Open User Settings (JSON).

3. Adicione as seguintes propriedades ao seu arquivo settings.json:

   {
     // 1. Escolha o provedor de IA
     "ia-commiter.provider": "google", // "google", "openai", "anthropic", ou "ollama"
   
     // 2. Informe a chave de API (ignorado se o provider for "ollama")
     "ia-commiter.apiKey": "SUA_CHAVE_DE_API_AQUI",
   
     // 3. Especifique o modelo
     "ia-commiter.model": "gemini-1.5-pro-latest", // Ex: "gpt-4o", "claude-3-opus-20240229", "llama3"
   
     // 4. (Opcional) Apenas para Ollama, configure o endpoint se não for o padrão
     "ia-commiter.ollamaEndpoint": "http://localhost:11434/api/generate"
   }
   

Exemplos de Configuração

• Para usar Google Gemini:

  "ia-commiter.provider": "google",
  "ia-commiter.apiKey": "SUA_CHAVE_GEMINI_AQUI",
  "ia-commiter.model": "gemini-1.5-pro-latest"
  

• Para usar OpenAI GPT-4o:

  "ia-commiter.provider": "openai",
  "ia-commiter.apiKey": "SUA_CHAVE_OPENAI_AQUI",
  "ia-commiter.model": "gpt-4o"
  

• Para usar Anthropic Claude 3.5 Sonnet:

  "ia-commiter.provider": "anthropic",
  "ia-commiter.apiKey": "SUA_CHAVE_ANTHROPIC_AQUI",
  "ia-commiter.model": "claude-3-5-sonnet-20240620"
  

• Para usar Ollama com Llama 3:

  "ia-commiter.provider": "ollama",
  "ia-commiter.model": "llama3" // Certifique-se de ter o modelo 'llama3' baixado
  

⌨️ Como Usar

1. Prepare suas Alterações: Faça as modificações no seu código.
2. Execute o Comando:
   • Abra a paleta de comandos (Ctrl+Shift+P).
   • Digite e selecione o comando IA Commiter: Gerar Commit e Changelog.
3. Mágica!: A extensão irá:
   • Adicionar todos os arquivos modificados ao staging (git add .).
   • Analisar as alterações.
   • Gerar uma mensagem de commit detalhada.
   • Realizar o commit.
   • Atualizar o CHANGELOG.md.

Importante: A extensão faz o stage de todas as alterações pendentes antes de gerar o commit.

🤝 Contribuindo

Contribuições são sempre bem-vindas! Se você tem ideias para novas funcionalidades, melhorias ou encontrou um bug, sinta-se à vontade para abrir uma Issue ou um Pull Request.

1. Faça um Fork deste repositório.
2. Crie uma nova Branch (git checkout -b feature/sua-feature).
3. Faça suas alterações e Commite (git commit -m 'feat: Adiciona nova feature').
4. Envie para a sua Branch (git push origin feature/sua-feature).
5. Abra um Pull Request.

📄 Licença

Este projeto está licenciado sob a Licença MIT. Veja o arquivo LICENSE para mais detalhes.

Feito com ❤️ por Chagastec