Triagem
Mova issues no issue tracker do projeto através de um pequeno estado-máquina de funções de triagem.
Todo comentário ou issue postada no issue tracker durante a triagem deve começar com este aviso:
> *Isso foi gerado por IA durante a triagem.*
Documentação de referência
- AGENT-BRIEF.md — como escrever briefs duráveis para agentes
- OUT-OF-SCOPE.md — como a base de conhecimento
.out-of-scope/funciona
Funções
Duas funções de categoria:
bug— algo está quebradoenhancement— nova funcionalidade ou melhoria
Cinco funções de estado:
needs-triage— o mantenedor precisa avaliarneeds-info— aguardando mais informações do relatorready-for-agent— totalmente especificada, pronta para um agente AFKready-for-human— precisa de implementação humanawontfix— não será tratada
Toda issue triada deve carregar exatamente uma função de categoria e uma função de estado. Se as funções de estado entrarem em conflito, sinalize e pergunte ao mantenedor antes de fazer qualquer outra coisa.
Estes são nomes de funções canônicos — os rótulos reais usados no issue tracker podem diferir. O mapeamento deve ter sido fornecido a você — execute /setup-matt-pocock-skills se não estiver.
Transições de estado: uma issue sem rótulo normalmente vai para needs-triage primeiro; de lá, move-se para needs-info, ready-for-agent, ready-for-human ou wontfix. needs-info retorna para needs-triage assim que o relator 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 qualquer coisa que precise da minha atenção"
- "Vamos olhar a #42"
- "Mova a #42 para ready-for-agent"
- "O que está pronto para os agentes pegarem?"
Mostrar o que precisa de atenção
Consulte o issue tracker e apresente três categorias, da mais antiga para a mais recente:
- Sem rótulo — nunca triada.
needs-triage— avaliação em andamento.needs-infocom atividade do relator desde as últimas notas de triagem — precisa de reavaliação.
Mostre contagens e um resumo de uma linha por issue. Deixe o mantenedor escolher.
Triar uma issue específica
-
Colete contexto. Leia a issue completa (corpo, comentários, rótulos, relator, datas). Analise quaisquer notas de triagem anteriores para não refazer perguntas já respondidas. Explore a base de código usando o glossário de domínio do projeto, respeitando os ADRs na área. Leia
.out-of-scope/*.mde destaque qualquer rejeição anterior que se assemelhe a esta issue. -
Recomende. Diga ao mantenedor sua recomendação de categoria e estado com justificativa, além de um breve resumo da base de código relevante para a issue. Aguarde orientação.
-
Reproduza (apenas bugs). Antes de qualquer questionamento, tente reproduzir: leia as etapas do relator, trace o código relevante, execute testes ou comandos. Relate o que aconteceu — reprodução bem-sucedida com o caminho do código, reprodução falha ou detalhes insuficientes (um forte sinal de
needs-info). Uma reprodução confirmada produz um brief de agente muito mais forte. -
Questione (se necessário). Se a issue precisar ser refinada, execute as skills
/grillinge/domain-modelingjuntas — questione a issue até dar forma, uma pergunta de cada vez, refinando os termos de domínio e atualizandoCONTEXT.md/ADRs inline conforme as decisões são tomadas. -
Aplique o resultado:
ready-for-agent— publique um comentário de brief de agente (AGENT-BRIEF.md).ready-for-human— mesma estrutura de um brief de agente, mas observe por que não pode ser delegado (julgamentos, acesso externo, decisões de design, testes manuais).needs-info— publique notas de triagem (modelo abaixo).wontfix(bug) — explicação educada e feche.wontfix(enhancement) — escreva em.out-of-scope/, vincule a partir de um comentário e feche (OUT-OF-SCOPE.md).needs-triage— aplique a função. Comentário opcional se houver progresso parcial.
Substituição rápida de estado
Se o mantenedor disser "mova a #42 para ready-for-agent", confie nele e aplique a função diretamente. Confirme o que está prestes a fazer (mudanças de função, comentário, fechar) e aja. Pule o questionamento. Se mover para ready-for-agent sem uma sessão de questionamento, pergunte se deseja escrever um brief de agente.
Modelo de Needs-info
## Notas de Triagem
**O que estabelecemos até agora:**
- ponto 1
- ponto 2
**O que ainda precisamos de você (@reporter):**
- pergunta 1
- pergunta 2
Capture tudo resolvido durante o questionamento em "estabelecido até agora" para que o trabalho não seja perdido. As perguntas devem ser específicas e acionáveis, não "forneça mais informações".
Retomando uma sessão anterior
Se houver notas de triagem anteriores na issue, leia-as, verifique se o relator respondeu a alguma pergunta pendente e apresente um quadro atualizado antes de continuar. Não refaça perguntas já respondidas.