Use o Remy
Revise alterações de código
Defina o escopo da revisão e inspecione cada problema encontrado.
Escopo: Um projeto Git local no aplicativo desktop.
Antes de fazer um commit, peça ao Remy que verifique se suas alterações atendem aos requisitos e se introduzem algum problema. Receba constatações que possa inspecionar uma a uma. Este exemplo começa por uma revisão e deixa você decidir se deseja fazer alterações.
1. Prepare o projeto e o escopo da revisão
Siga o Guia do desktop para adicionar o projeto e inicie uma nova conversa nele.
Antes de enviar a tarefa, prepare:
- O requisito ou problema que as alterações devem resolver.
- O escopo a revisar, como todas as alterações atuais sem commit ou um conjunto específico de arquivos.
- O comportamento que deve permanecer igual e os critérios de conclusão.
Alterações mostra a árvore de trabalho atual e pode incluir trabalhos anteriores. Confira primeiro a lista de arquivos. Se quiser revisar apenas parte dela, especifique esse escopo no prompt.
2. Inicie a revisão
Substitua o requisito do exemplo pela tarefa real do seu projeto:
Revise as alterações sem commit relacionadas à filtragem na lista de pedidos deste projeto.
O requisito é: mudar o filtro de palavra-chave ou status retorna a lista à página 1, atualiza os resultados e preserva a ordenação existente.
Primeiro liste os arquivos que vai revisar, diferenciando alterações preparadas para commit, alterações não preparadas e arquivos novos.
Revise somente as alterações relacionadas a esse requisito. Deixe os trabalhos existentes sem relação com ele fora da revisão.
Concentre-se em:
1. Se a implementação atende ao requisito.
2. Se os parâmetros das solicitações, as atualizações de estado e os resultados exibidos são consistentes.
3. Problemas com resultados vazios, mudanças rápidas e sucessivas de filtro ou falhas de solicitação.
4. Se os testes cobrem as alterações reais e se faltam casos importantes.
Liste as constatações por gravidade. Para cada uma, forneça a localização no arquivo, as condições de ocorrência, o impacto real, as evidências e uma recomendação.
Separe os problemas confirmados dos que ainda precisam de verificação. Se não encontrar problemas, descreva o escopo da revisão e o que ela não abrangeu.
Apenas revise. Não edite arquivos, instale dependências, faça commits nem envie código.
3. Confira as constatações
Abra os arquivos relevantes e confira se cada constatação procede.
| Verificação | O que você deve conseguir responder |
|---|---|
| Escopo da revisão | A revisão abrangeu as alterações solicitadas, incluiu arquivos novos e excluiu trabalhos sem relação com a tarefa? |
| Evidências | A localização existe e a descrição corresponde à implementação atual? |
| Condições de ocorrência | Em quais condições o problema ocorre? É possível reproduzi-lo ou verificá-lo com um teste? |
| Impacto | Afeta o comportamento ou é uma melhoria a considerar separadamente? |
| Verificações | Quais verificações realmente foram executadas, quais foram apenas sugeridas e quais não puderam ser executadas? |
Se uma constatação for vaga demais, peça mais detalhes:
Detalhe a constatação 2. Identifique o código exato e as condições de ocorrência e forneça o menor conjunto de passos para reproduzir o problema.
Se ainda for uma hipótese, diga isso e liste as verificações necessárias para confirmá-la.
Ainda não edite arquivos.
4. Corrija um problema selecionado
Depois de confirmar o que precisa mudar, continue na mesma conversa:
Corrija somente a constatação confirmada 1.
Preserve as outras alterações existentes, siga a abordagem atual do projeto e adicione e execute os testes relevantes.
Resuma os arquivos alterados, os resultados das verificações e quaisquer verificações que não conseguiu concluir.
Ainda não faça commits nem envie código.
Revise novamente o diff real e confira o comportamento usando os passos originais de reprodução. Nas versões que oferecem o Verification, você pode solicitá-lo explicitamente para conferir o resultado em relação aos requisitos. As conclusões dele ainda devem ser sustentadas por alterações e resultados reais de verificações.
5. Como é o trabalho concluído
Você tem uma revisão com escopo claro e constatações rastreáveis. Consegue distinguir problemas a corrigir, hipóteses a verificar e áreas não abrangidas. Se também solicitou uma correção, pode inspecionar as alterações correspondentes e os resultados das verificações.
“Nenhum problema encontrado” não significa que todos os cenários foram verificados. Siga o processo habitual do projeto para decidir se deve fazer um commit ou merge.
6. Continue explorando
- Use subagentes: Divida uma revisão por módulo ou perspectiva.
- Início rápido: Faça uma pequena alteração e verifique seu comportamento.
- Guia do Cloud: Execute trabalhos na nuvem e entregue por meio de um PR.