Triagem

Quando Usar

Use quando este fluxo de trabalho corresponder à solicitação do usuário: Mova issues e PRs externos através de uma máquina de estados de funções de triagem — categorize, verifique, questione se necessário e escreva resumos prontos para o agente.

Fonte: mattpocock/skills (MIT).

Mova issues no rastreador de issues do projeto através de uma pequena máquina de estados de funções de triagem.

Se este repositório trata pull requests externos como uma superfície de solicitação (veja a configuração do issue-tracker), a triagem também os abrange: um PR é uma issue com código anexado — mesmas funções, mesmos estados, mesma máquina, com alguns deltas marcados como "para um PR" abaixo. Resolva uma #42 simples para uma issue ou PR de acordo com a configuração do rastreador.

Todo comentário ou issue postado no rastreador de issues durante a triagem deve começar com este aviso:

> *This was generated by AI during triage.*

Documentos de Referência

• AGENT-BRIEF.md — como escrever resumos de agente duráveis
• OUT-OF-SCOPE.md — como a base de conhecimento .out-of-scope/ funciona

Funções

Duas funções de categoria:

• bug — algo está quebrado
• enhancement — nova funcionalidade ou melhoria

Cinco funções de estado:

• needs-triage — o mantenedor precisa avaliar
• needs-info — esperando mais informações do reportador
• ready-for-agent — totalmente especificado, pronto para um agente AFK
• ready-for-human — precisa de implementação humana
• wontfix — não será acionado

Para um PR, os mesmos estados são lidos em relação ao código anexado: ready-for-agent significa que um resumo está anexado e um agente deve dar o próximo passo no diff; ready-for-human significa que está pronto para um humano mesclar.

Cada issue triada deve ter exatamente uma função de categoria e uma função de estado. Se as funções de estado conflitarem, sinalize e pergunte ao mantenedor antes de fazer qualquer outra coisa.

Estes são nomes canônicos de funções — as strings de rótulo reais usadas no rastreador de issues podem diferir. O mapeamento deve ter sido fornecido a você - execute /setup-matt-pocock-skills se não.

Transições de estado: uma issue sem rótulo normalmente vai para needs-triage primeiro; a partir daí, move-se para needs-info, ready-for-agent, ready-for-human ou wontfix. needs-info retorna para needs-triage assim que o reportador responder. O mantenedor pode substituir a qualquer momento — sinalize transições que pareçam incomuns e pergunte antes de prosseguir.

Invocação

O mantenedor invoca /triage e descreve o que deseja em linguagem natural. Interprete a solicitação e aja. Exemplos:

• "Mostre-me tudo que precisa da minha atenção"
• "Vamos olhar o #42" (issue ou PR)
• "Mova #42 para pronto-para-agente"
• "O que está pronto para os agentes pegarem?"

Mostrar o que precisa de atenção

Consulte o rastreador de issues e apresente três grupos, do mais antigo para o mais novo:

1. Sem rótulo — nunca triado.
2. needs-triage — avaliação em andamento.
3. needs-info com atividade do reportador desde as últimas notas de triagem — precisa de reavaliação.

Quando PRs estiverem em escopo, inclua PRs externos nesses grupos e marque cada linha com [PR] ou [issue]. A descoberta mostra apenas PRs externos (a configuração do rastreador define quem é considerado externo) — um PR em andamento de um colaborador não é trabalho de triagem. Este filtro é apenas para descoberta; um PR explicitamente nomeado é sempre triado, independentemente do autor.

Mostre contagens e um resumo de uma linha por item. Deixe o mantenedor escolher.

Triar uma issue ou PR específico

1. Reúna contexto. Leia a issue ou PR completa (corpo, comentários, rótulos, autor, datas; para um PR, o diff também). Analise quaisquer notas de triagem anteriores para não refazer perguntas já resolvidas. Explore a base de código usando o glossário de domínio do projeto, respeitando os ADRs da área. Execute duas verificações na base de código: (a) redundância — procure por uma implementação existente do comportamento solicitado por conceito de domínio (não apenas pela redação da solicitação) e relate onde você procurou. Se encontrado, é uma wontfix já implementada (passo 5). (b) rejeição anterior — leia .out-of-scope/*.md e apresente qualquer uma que se assemelhe a esta solicitação.

2. Recomende. Diga ao mantenedor sua recomendação de categoria e estado com o raciocínio, mais um breve resumo da base de código relevante para a solicitação — incluindo se já foi implementada. Aguarde instruções.

…