ESPAÇO PUBLICITÁRIO DISPONÍVEL · FALE CONOSCO
Português
English简体中文繁體中文日本語EspañolPortuguês한국어DeutschFrançais
Todos os sites

Como Usar o JetBrains AI Assistant para Gerar Mensagens de Commit e Descrições de Pull Request no Controle de Versão do IDE

Análise
365Finds Editorial
11.430 artigos Wiki catalogados

Use o 365 Wiki com sua IA

Copie o prompt abaixo, cole na IA que você já usa e faça sua pergunta.

Baixar o Skill completo

Experimente primeiro com o prompt. Se você usa o 365 Wiki com frequência, instale o Skill completo do 365Wiki para não precisar colá-lo novamente. Se não usa uma IA específica, as versões web do Gemini ou Microsoft Copilot também servem.

365Wiki Skill

Baixar o Skill completo
Manter mensagens de commit e descrições de Pull Request (PR) bem documentadas e padronizadas é fundamental para a manutenção de repositórios saudáveis, mas redigir esses textos a cada troca de contexto consome energia valiosa do desenvolvedor. O JetBrains AI Assistant é integrado nativamente às janelas de ferramentas de controle de versão dos IDEs da JetBrains (como IntelliJ IDEA, PyCharm, WebStorm e GoLand), permitindo sintetizar diffs de código em mensagens de commit precisas, executar autorrevisões com IA antes do commit e gerar descrições completas de PRs sem precisar sair do editor.


Este guia prático explica como configurar e utilizar o JetBrains AI Assistant nos fluxos de trabalho de Git, personalizar prompts de acordo com as convenções da equipe e aproveitar recursos complementares como resolução inteligente de conflitos e suporte à revisão de código.




Pré-requisitos e Configuração Inicial


Antes de gerar mensagens de commit e resumos de PR com IA, certifique-se de que seu ambiente preencha os seguintes requisitos:


    

  1. IDE JetBrains Compatível: Versão 2024.1 ou superior (como IntelliJ IDEA, PyCharm, WebStorm, GoLand, Rider ou CLion).
    2. 

  2. Plugin AI Assistant e Assinatura Ativa:

      

    • O plugin JetBrains AI Assistant deve estar habilitado em Settings | Plugins (Ctrl+Alt+S no Windows/Linux, Cmd+, no macOS).
      • 

    • Você deve estar conectado à sua JetBrains Account com cota ativa (teste AI Free, assinatura individual AI Pro, AI Ultimate ou licença corporativa via JetBrains Central).
      • 

    

    3. 

  3. Controle de Versão Configurado:

      

    • Repositório local inicializado com Git ou Mercurial.
      • 

    • Plugins integrados de Git e GitHub (ou GitLab) ativos para possibilitar o uso da janela de ferramentas de Pull Requests.
      • 

    

    4. 





1. Gerando Mensagens de Commit com o AI Assistant


O JetBrains AI Assistant examina as modificações no staging ou nas listas de alterações selecionadas (changelists) para resumir o propósito e os impactos das alterações diretamente no formato adequado.


Passo a Passo


    

  1. Abrir a Janela de Ferramentas Commit:

      

    • Pressione Alt+0 no Windows/Linux ou Cmd+0 no macOS (ou utilize Ctrl+K / Cmd+K).
      • 

    

    2. 

  2. Selecionar as Alterações Desejadas:

      

    • Marque as caixas de seleção correspondentes aos arquivos, blocos de código específicos ou changelists que entrarão neste commit. O assistente analisará estritamente os diffs marcados, facilitando commits parciais atômicos.
      • 

    

    3. 

  3. Disparar a Geração por IA:

      

    • Clique no ícone Generate Commit Message with AI Assistant (o símbolo de varinha mágica/brilho de IA) situado acima da caixa de mensagem de commit.
      • 

    

    4. 

  4. Revisar e Concluir:

      

    • O assistente preencherá um cabeçalho resumido acompanhado de marcadores com os principais detalhes técnicos.
      • 

    • Adicione referências a tickets de tarefas (como PROJ-1024) ou avisos de quebra de compatibilidade e confirme o commit (Ctrl+Enter ou Cmd+Enter).
      • 

    

    5. 



Add JWT authentication middleware and token expiration check

- Introduce AuthTokenValidator class to verify bearer tokens
- Register authentication interceptor in security configuration
- Add unit test coverage for expired and malformed tokens





2. Personalizando Padrões de Commit e Modelos de Prompt


Muitas equipes seguem diretrizes rígidas, como Conventional Commits (feat:, fix:, refactor:), limites de caracteres ou inclusão do nome do branch. O JetBrains oferece duas formas de customização:


Método A: Configuração Direta na Janela de Commit


    

  1. Clique no ícone de engrenagem (Settings) no canto inferior direito da janela Commit.
    2. 

  2. Na seção AI Assistant, insira as diretrizes desejadas no campo Prompt for generation.
    3. 

  3. Use a variável embutida $GIT_BRANCH_NAME para incluir dinamicamente dados do branch no prompt (exemplo: Extraia o número do ticket contido em $GIT_BRANCH_NAME e coloque-o como prefixo do commit).
    4. 



Método B: Regras Globais na Prompt Library


    

  1. Abra Settings | Tools | AI Assistant | Prompt Library (Ctrl+Alt+S ou Cmd+,).
    2. 

  2. Na seção Built-In Actions, selecione Commit Message Generation.
    3. 

  3. No editor à direita, defina as regras desejadas:

      

    • Convenção de escrita: "Adote rigorosamente o padrão Conventional Commits com prefixos como feat, fix e refactor".
      • 

    • Limitação de tamanho: "Mantenha o título com no máximo 50 caracteres e quebre as linhas de descrição em até 72 caracteres".
      • 

    • Idioma de saída: Configure para gerar o texto em português ou inglês conforme a preferência da equipe.
      • 

    

    4. 

  4. Clique em Apply. Todas as gerações futuras respeitarão esse modelo.
    5. 





3. Autorrevisão Pré-Commit com IA (Self-Review with AI)


Para evitar o envio involuntário de linhas de depuração esquecidas, chaves de API ou erros de lógica básicos, o AI Assistant oferece uma autorrevisão rápida antes da conclusão do commit:


    

  1. Na janela Commit, selecione os arquivos ou alterações que pretende enviar.
    2. 

  2. Clique no botão Self-Review with AI.
    3. 

  3. A janela de ferramentas Problems será aberta na aba AI Self-Review, destacando pontos de atenção:

      

    • Trechos de depuração esquecidos (como console.log ou print).
      • 

    • Riscos de ponteiro nulo, falta de tratamento de exceções e possíveis vazamentos de recursos.
      • 

    • Discrepâncias de estilo de código e convenções de nomenclatura.
      • 

    

    4. 

  4. Dê um duplo clique na ocorrência ou pressione F4 para navegar ao código-fonte e aplicar as correções rápidas (Quick Fixes) sugeridas pela IDE.
    5. 

  5. Equipes podem vincular um guia interno em formato Markdown em Settings | Tools | AI Assistant | Project Settings no campo Path to rules for AI Self-Review.
    6. 





4. Editando e Aprimorando Commits Já Realizados


Caso você já tenha feito um commit local, mas ainda não realizou o push para o repositório remoto, é possível usar o assistente para reescrever a descrição:


    

  1. Abra a janela de histórico do Git pressionando Alt+9 no Windows/Linux ou Cmd+9 no macOS.
    2. 

  2. Na lista de commits, clique com o botão direito sobre o commit desejado e escolha Edit Commit Message.
    3. 

  3. No diálogo exibido, clique em Improve Commit Message with AI Assistant.
    4. 

  4. A IA reanalisará os diffs daquele commit específico e fornecerá um texto mais claro. Clique em OK para salvar e faça o push (Ctrl+Shift+K ou Cmd+Shift+K).
    5. 





5. Gerando Títulos e Descrições de Pull Request


Ao transitar do trabalho local para a fase de revisão por pares (code review), elaborar descrições completas para Pull Requests (PR) ou Merge Requests (MR) acelera a aprovação do time.


Criação de PR Diretamente no IDE


    

  1. Abrir a Janela de Pull Requests:

      

    • No menu principal, acerte em Git | GitHub | View Pull Requests (ou GitLab | View Merge Requests).
      • 

    

    2. 

  2. Iniciar uma Nova Solicitação:

      

    • Clique no ícone + para abrir um novo PR/MR, definindo os branches de base e de origem.
      • 

    

    3. 

  3. Gerar Título e Corpo com um Clique:

      

    • No editor de descrição, clique em Generate a Title and Description with AI Assistant.
      • 

    • O assistente analisará todos os commits e arquivos modificados no branch, gerando uma estrutura organizada em Markdown:

        

      • Resumo (Summary): Visão geral da funcionalidade ou do bug solucionado.
        • 

      • Principais Modificações (Key Changes): Relação dos módulos alterados e novas rotinas.
        • 

      • Verificação (Verification): Testes executados e passos recomendados para validação.
        • 

      

      • 

    

    4. 

  4. Ajustar e Publicar:

      

    • Inclua links para tarefas externas, adicione revisores e clique em Create Pull Request.
      • 

    

    5. 



Resumo Automático de PRs de Colegas


Ao analisar solicitações de pull enviadas por outros membros da equipe, o AI Assistant também pode resumir o contexto:





Recomendações e Melhores Práticas



























Prática RecomendadaJustificativa e Impacto
Priorizar commits atômicos (Partial Commit)Use a seleção de linhas da IDE; diffs focados produzem mensagens objetivas e livres de generalizações vagas.
Validar códigos de tarefas externasA IA analisa o código com precisão, mas não adivinha identificadores de sprint boards (como Jira); combine com $GIT_BRANCH_NAME ou ajuste manualmente.
Aliar às verificações nativas da IDEMantenha ativas as checagens pré-commit (Reformat code, Optimize imports, Analyze code) para garantir alta qualidade antes do envio.
Usar Merge with AI na resolução de conflitosAo realizar rebase ou merge com sobreposição de alterações, use o botão Merge with AI no diálogo Merge Revisions para agilizar a integração.


Adotar o JetBrains AI Assistant na rotina diária de versionamento poupa tempo mental precioso e assegura um histórico de commits e revisões consistente, profissional e facilmente auditável por toda a organização.




Referências


Produtos abordados
JetBrains AI