Automatizando mensagens de commit com AI

Escrever commits pode ser uma tarefa bastante monótona, especialmente quando estamos no fluxo de desenvolvimento e a vontade é de apenas "jogar" o código para o repositório e seguir em frente. No entanto, por mais "chato" que possa parecer, commits bem feitos são essenciais para o entendimento e a manutenção do projeto. Eles ajudam a documentar o histórico, facilitam o trabalho em equipe e tornam a volta ao código muito mais eficiente. Então, mesmo que pareça uma obrigação, dedicar alguns segundos a mais para escrever commits claros e objetivos acaba fazendo toda a diferença.

A AI pode ser uma aliada incrível na tarefa de escrever commits. Com a capacidade de analisar o conteúdo das mudanças no código, a AI pode sugerir descrições claras e detalhadas, destacando as principais modificações e até mesmo sugerindo padrões de escrita consistentes com o restante do projeto. Ela reduz o esforço e o tempo que normalmente gastamos tentando encontrar as palavras certas, permitindo que o foco permaneça no desenvolvimento enquanto ainda mantemos um histórico de commits bem documentado e fácil de entender.

Pensando nisso, trago aqui uma forma de como você pode automatizar suas mensagens de commit, totalmente de graça, usando AI.

Acesse GROQ e gere uma key: https://console.groq.com/keys

Faça a instalação da lib opencommit: npm install -g opencommit

Agora vamos configurar a opencommit com a GROQ e o modelo que será utilizado (acessando o site da GROQ você pode verificar os outros modelos): oco config set OCO_AI_PROVIDER='groq' OCO_MODEL=llama3-70b-8192

A opencommit por padrão, assim que realiza o commit, pergunta se você quer fazer o push, para desabilitar: oco config set OCO_GITPUSH=false

Passando sua API_KEY, que você acaba de pegar no site da GROQ, para o opencommit: oco config set OCO_API_KEY=SUA_API_KEY

Caso você queira utilizar o padrão do conventional commit, você pode configurar assim: oco config set OCO_PROMPT_MODULE=conventional-commit

Tudo pronto, agora você tem um "assistente" de commits, basta rodar oco no terminal.

Apesar das vantagens, o uso de AI para gerar mensagens de commit deve ser feito com cautela. É importante revisar e adaptar as sugestões para garantir que os commits reflitam de forma fiel e precisa as mudanças realizadas. A IA pode facilitar a escrita, mas não substitui o contexto e o entendimento do desenvolvedor sobre o impacto das alterações no código. Além disso, confiar cegamente na IA pode levar a descrições genéricas ou vagas, perdendo o propósito de um histórico bem documentado. Usada com equilíbrio, a IA é uma ferramenta poderosa, mas o controle e a responsabilidade ainda são seus.