Responder a Comentários do GitHub

Visão Geral

Responda eficientemente a comentários de revisão de PR ou feedback de issues usando o GitHub CLI (gh). Esta habilidade garante que todo o feedback seja abordado sistematicamente.

Pré-requisitos

Certifique-se de que gh esteja autenticado.

gh auth status

Se não estiver logado, execute gh auth login.

Fluxo de Trabalho

1. Inspecionar Comentários

Busque os comentários do PR do branch atual.

gh pr view --comments

--comments mostra comentários de conversas; ele não enumera cada thread de revisão inline. Use o conector GitHub disponível ou a conexão GraphQL pullRequest.reviewThreads com paginação para inspecionar comentários inline, âncoras de arquivo/linha e estado de resolução. Registre o repositório, o número do PR, o SHA principal atual, os IDs das threads e as alterações solicitadas.

2. Categorizar e Planejar

• Liste os comentários e threads de revisão.
• Proponha uma correção para cada um.
• Aborde o feedback já coberto pelo escopo solicitado pelo usuário. Pergunte apenas quando o feedback conflitar, expandir o escopo ou exigir uma escolha consequente.

3. Aplicar Correções

Leia a implementação circundante, preserve edições não relacionadas e aplique as alterações para os comentários selecionados. Execute as verificações relevantes do repositório e vincule o resultado ao principal atualizado antes de relatar uma correção.

4. Responder a Comentários

Quando o usuário autorizar a postagem de respostas, responda com o commit e evidências de verificação. Um comentário de conversação não resolve uma thread de revisão inline. Resolva a thread específica através da API GitHub suportada apenas depois que sua solicitação for realmente abordada e a resolução for autorizada; caso contrário, deixe uma resposta proposta para o usuário.

gh pr comment <PR_NUMBER> --body "Addressed in <commit SHA>; verified with <check and result>."

Erros Comuns

• Aplicar correções sem entender o contexto: Sempre leia o código circundante de um comentário.
• Não verificar a autenticação: Verifique gh auth status antes de começar.

Quando Usar

Use quando um PR existente tiver threads de revisão ou comentários de issues que exijam uma correção de código com escopo e uma resposta baseada em evidências.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem faltando.