estimativa-tres-pontos-jira

name

estimativa-tres-pontos-jira

description

Calcular estimativa de três pontos para itens do Jira usando cenários otimista, mais provável e pessimista, converter o resultado PERT para horas e minutos e atualizar o campo Original Estimate da issue. Usar quando o usuário fornecer uma User Story do Jira e três estimativas em horas, ou quando for necessário coletar os valores faltantes, calcular a estimativa final e gravar o resultado no Jira com segurança.

Estimativa Três Pontos Jira

Executar estimativa de três pontos para uma issue do Jira, calcular o valor esperado pela fórmula PERT e atualizar o campo Original Estimate.

Trabalhar em português durante todo o fluxo.

Fluxo

1. Identificar a issue do Jira.
2. Coletar três valores em horas:

• otimista
• mais provável
• pessimista

3. Validar os valores recebidos.
4. Calcular a estimativa PERT.
5. Converter o resultado para horas e minutos.
6. Informar o cálculo ao usuário de forma transparente.
7. Atualizar o Original Estimate da issue no Jira.
8. Confirmar a atualização realizada.

Coleta Dos Dados

Solicitar ao usuário, no mínimo:

• chave ou identificador da User Story no Jira
• horas do cenário otimista
• horas do cenário mais provável
• horas do cenário pessimista

Aceitar valores decimais em horas, como 1.5, 2, 6.25.

Se algum dado estiver ausente, pedir apenas o que falta.

Validação

Antes de calcular:

• verificar se os três valores são numéricos
• verificar se os três valores são maiores ou iguais a zero
• tratar entradas inválidas antes de prosseguir
• se a issue não puder ser localizada no Jira, interromper a atualização e explicar o motivo

Se houver ambiguidade sobre a issue, confirmar a issue correta antes de editar.

Cálculo

Calcular a estimativa final com esta fórmula:

(otimista + mais provavel * 4 + pessimista) / 6

Interpretar o resultado como horas.

Converter para minutos totais com arredondamento para o minuto mais próximo:

1. multiplicar o resultado em horas por 60
2. arredondar para o inteiro mais próximo
3. separar em horas e minutos

Usar:

• horas = minutos_totais // 60
• minutos = minutos_totais % 60

Formatar o texto final preferencialmente como:

• Xh Ym quando houver horas e minutos
• Xh quando os minutos forem zero
• Ym quando o total for menor que uma hora

Comunicação Com O Usuário

Antes de atualizar o Jira, apresentar de forma objetiva:

• issue identificada
• valores informados para otimista, mais provável e pessimista
• resultado da fórmula em horas decimais, quando útil
• resultado final formatado em horas e minutos

Exemplo de resposta intermediária:

Estimativa calculada para ABC-123: (2 + 4*4 + 10) / 6 = 4.67h, arredondado para 4h 40m. Vou atualizar o Original Estimate com esse valor.

Atualização No Jira

Usar a ferramenta disponível de Jira para atualizar o campo Original Estimate da issue.

Preferir atualizar o campo de time tracking de forma nativa. Quando a ferramenta exigir payload estruturado, usar o formato compatível com o Jira para timetracking.originalEstimate, por exemplo com valores como 4h 40m.

Após a atualização:

• confirmar que a operação foi concluída
• informar explicitamente o valor gravado no Jira
• se a atualização falhar, não fingir sucesso; explicar o erro e o próximo passo recomendado

Regras De Execução

• Responder sempre em português.
• Fazer a conta explicitamente, sem pular etapas importantes.
• Não atualizar o Jira sem ter os três valores necessários.
• Não substituir valores inválidos por suposições silenciosas.
• Se o usuário já fornecer a issue e os três valores, executar o fluxo completo sem pedir confirmação desnecessária.
• Se o usuário pedir apenas o cálculo, calcular e apresentar o resultado sem editar o Jira.

Exemplo De Disparo

• Calcule a estimativa de três pontos da US ABC-123 com 2h otimista, 4h mais provável e 10h pessimista e atualize o Jira.
• Atualize o Original Estimate da story PAY-88 usando 1.5h, 3h e 6h na estimativa de três pontos.