| name | github-pr-comment-triage |
| version | 1.0.0 |
| description | Organiza, prioriza e responde comentarios de revisao em Pull Requests do GitHub. Use quando um PR tiver multiplos comentarios de revisores e precisar de triagem estruturada. Nao use para implementar as correcoes solicitadas — use execute-task ou bugfix para isso. |
GitHub PR Comment Triage
Procedimentos
Etapa 1: Coletar comentarios
- Confirmar que o contrato de carga base definido em
AGENTS.md foi cumprido.
- Usar
gh pr view <numero> --comments ou gh api repos/<owner>/<repo>/pulls/<num>/comments para listar comentarios.
- Separar comentarios por: revisor, arquivo, linha e tipo (sugestao, bloqueante, duvida, elogio).
Etapa 2: Classificar por prioridade
- Bloqueantes (
must fix): alteram corretude, seguranca ou quebram contrato — resolver antes do merge.
- Importantes (
should fix): qualidade, testabilidade, boas praticas — resolver quando possivel.
- Sugestoes (
nit, optional): estilo, preferencia — responder e decidir.
- Duvidas: responder com explicacao ou ajustar o codigo se a duvida revelar falta de clareza.
Etapa 3: Gerar plano de resposta
- Para cada comentario bloqueante: propor acao concreta (arquivo + mudanca necessaria).
- Para sugestoes: redigir resposta clara aceitando ou recusando com justificativa.
- Agrupar mudancas por arquivo para eficiencia de implementacao.
Etapa 4: Registrar resultado
- Listar comentarios triados com status:
resolved, pending, dismissed.
- Sugerir proximo passo: implementar via
execute-task ou bugfix.
Tratamento de Erros
- Se o PR nao estiver acessivel, verificar permissoes do token
gh sem logar o token.
- Nao marcar como
dismissed comentarios bloqueantes sem resposta ou implementacao.
- Se um comentario for ambiguo, perguntar ao revisor antes de assumir a intencao.
