Oi pessoal, tudo bem?

Não sei vocês, mas se eu ficar muito tempo sem olhar pra um código, mesmo que eu quem tenha escrito, esqueço tudo que estava acontecendo ali e preciso de um tempinho pra voltar ao meu ritmo normal de programação. Seria tão bom ter alguém pra me explicar o que o código faz…

E foi pensando nisso que eu escrevi o artigo de hoje.

Neste artigo, vamos aprender a usar o GitHub Copilot Chat para entender nosso código (ou o código dos coleguinha). Essa ferramenta pode nos explicar o código passo a passo e nos dizer o que ele faz de maneira resumida ou detalhada. 

Se você não sabe o que é o GitHub Copilot, dê uma lida neste artigo aqui.

Como começamos?

Primeiramente, você precisa ter acesso ao GitHub Copilot Chat. Essa funcionalidade está disponível para quem tem o  Copilot e pode ser usada diretamente no VS Code. Para ativá-lo:

1. Instale a extensão do GitHub Copilot no VS Code.
2. Faça login na sua conta do GitHub.
3. Verifique se o Copilot Chat está ativado (você verá um ícone na barra lateral do VS Code).
4. Abra o chat usando Ctrl + I no Windows/Linux ou Cmd + I no macOS. (ou clicando no ícone do Copilot, ao lado direito da Barra de comando)

Pedindo explicações ao Copilot Chat

Com o Copilot Chat ativado, você pode simplesmente colar um trecho de código e perguntar algo como:

• “O que esse código faz?”
• “Explique esse código passo a passo.”
• “Esse código tem algum problema ou pode ser otimizado?”

Exemplo prático

Vamos supor que encontramos o seguinte código e queremos entender o que ele faz

Vou perguntar ao Copilot Chat “O que esse código faz?.

(O copilot chat tem várias opções de agentes IA, para esse exemplo vou usar o Claude 3.7 Sonnet Thinking. Você pode ver qual agente você está usando e mudá-lo, embaixo do espaço onde digita no copilot chat).

A resposta que recebi foi essa:

Este código JavaScript define uma função chamada processarDados que:

Recebe um array como parâmetro (lista)

Processa esse array em duas etapas:

Primeiro usa filter() para manter apenas os números pares (onde x % 2 === 0)

Depois usa map() para transformar cada número par no seu quadrado (x ** 2)

Retorna um novo array contendo apenas os quadrados dos números pares da lista original

Por exemplo:

Se você chamar processarDados([1, 2, 3, 4, 5, 6])

O resultado será [4, 16, 36] (os quadrados dos números pares 2, 4 e 6)

Podemos pedir pra ele explicar de maneira mais detalhada, ou resumir em um parágrafo. 

Se quisermos mais detalhes, podemos continuar perguntando:

• “Explique cada parte do código.”
• “Existe uma forma mais eficiente de escrever isso?”

E você também pode testar fazer perguntas mudando o agente IA sendo usado.

Eu adoro ficar testando e iterando as possibilidades no Copilot chat.

Limitações

Embora o Copilot Chat seja uma ferramenta poderosa, ele pode não entender contextos muito complexos ou códigos obscuros. Uma recomendação é sempre que possível pedir pra ele explicar blocos menores de código. 

Conclusão

Usar o GitHub Copilot Chat para entender código pode ser uma grande ajuda, principalmente quando estamos revisitando projetos antigos ou lidando com código de terceiros. Teste essa funcionalidade e veja como ela pode melhorar seu fluxo de trabalho!