Para combinar Jira e GitHub em um relatório semanal, associe cada pull request à tarefa pela chave do Jira, como PAY-248, que aparece no nome da branch, no título do PR ou na mensagem do commit. Use o mesmo período nas duas ferramentas, agrupe o trabalho por marco e liste as divergências em seção própria. Um assistente de IA pode montar o rascunho, mas você revisa antes de o patrocinador receber.
Por que um relatório só do Jira ou só do GitHub deixa escapar problemas?
Um relatório só do Jira pode mostrar uma tarefa como concluída enquanto o código ainda espera revisão. Um relatório só do GitHub pode mostrar código entregue que o plano nunca previu. O relatório combinado coloca as duas visões lado a lado, para que o patrocinador veja o avanço de cada marco junto com as evidências.
Algumas opções cobrem só uma parte. O jira-weekly-report repository envia por e-mail três listas (Criadas, Resolvidas e Abertas agora) de um projeto do Jira Cloud. Segundo a descrição do projeto, ele usa a API REST do Jira e SMTP, mas confira no README quais fontes ele lê antes de presumir que não toca em pull requests. A Generate Status Report agent skill, da Atlassian é outro ponto de partida, pelo lado do Jira. O SyncHub carrega dados de Jira e GitHub em um data warehouse, mas o relatório você monta por conta própria. Se você só precisa enviar uma atualização semanal, o data warehouse não é necessário.
Como associar pull requests às tarefas do Jira?
Associe pela chave da tarefa, e não pelo texto parecido. Se a chave aparece na branch, no título do PR ou na mensagem do commit, a IA ou a integração consegue ligar o código à tarefa. Se a chave falta, nada se conecta, e essa lacuna vai para o relatório como trabalho sem vínculo.
O guia Jira Alternatives descreve essa convenção, com nomes de branch como PAY-248-checkout-timeout. Combine estas regras com a equipe antes de confiar no relatório:
- Combine que toda branch e todo título de PR começa com a chave da tarefa.
- Defina um único período, de [data e hora inicial] a [data e hora final], em [fuso horário], e use a mesma janela nas duas ferramentas.
- Escolha um único campo do Jira que define o marco, agrupe o relatório só por ele e escreva o nome do campo no prompt, para a IA não adivinhar.
- Decida como tratar trabalho sem chave: ele vai para "Trabalho sem vínculo", e não para uma tarefa escolhida por palpite.
- Decida como tratar um PR que cita várias tarefas: conte-o em cada uma delas e diga isso no relatório.
- Liste todos os repositórios incluídos, para que o patrocinador saiba o que ficou de fora.
Tenha cuidado com automações. O guia Jira Alternatives descreve o risco de mudanças automáticas de status dispararem cedo demais, por exemplo quando um PR é aberto. Antes de confiar em uma tarefa marcada como concluída, veja no histórico dela qual evento a moveu.
Quais divergências o relatório deve sinalizar?
Sinalize todo ponto em que Jira e GitHub discordam, porque cada discordância pode apontar um risco de prazo que o patrocinador precisa conhecer. Tarefa concluída sem PR mesclado significa que o plano está à frente do código. PR aberto contra tarefa bloqueada significa trabalho parado. Código mesclado sem tarefa significa que o plano deixou algo de fora.
Use as mesmas categorias no modelo e no prompt. Toda semana, confira estas quatro dentro de "Divergências para resolver": Concluída, sem código (tarefas resolvidas no período sem PR mesclado vinculado), Aguardando revisão (PRs abertos há mais de [limite combinado] sem revisão), Bloqueada com código aberto (PRs abertos contra tarefas em status de bloqueio) e Parada (tarefas em andamento sem commits nem atividade de PR no período).
Código mesclado sem tarefa vai para a lista separada "Trabalho sem vínculo", para que ninguém adivinhe a qual tarefa ele pertence. Trate cada divergência como uma pergunta para o responsável e registre a resposta antes do envio. Por exemplo (exemplo ilustrativo): se a tarefa PAY-251 aparece como concluída, mas não tem PR mesclado, pergunte ao responsável se o código foi dispensado ou se ainda falta enviar.
Como montar o modelo do relatório semanal?
Use um modelo que agrupa o trabalho por marco e mostra cada item com a tarefa do Jira e os PRs ligados a ela. Coloque no topo as decisões ou o apoio que você precisa do patrocinador. Copie o modelo para o documento, o e-mail ou a página da equipe e preencha os campos entre colchetes.
Status semanal: [nome do projeto], de [data inicial] a [data final]
Geral: [no prazo / em risco / atrasado], porque [motivo em uma frase]
O que precisamos de você
- [Decisão, revisão ou apoio necessário] até [data]. Opções: [A] / [B]. Nossa recomendação: [A], porque [motivo].
Por marco
[Nome do marco], prazo [data], [situação]
Entregue: [CHAVE-DA-TAREFA] [resumo], mesclado em [link do PR]
Em revisão: [CHAVE-DA-TAREFA] [resumo], [link do PR] aberto desde [data]
Bloqueada: [CHAVE-DA-TAREFA] [resumo], bloqueada por [causa], precisa de [quem ou o quê]
Próxima semana: [CHAVE-DA-TAREFA] [resumo], responsável [nome]
Divergências para resolver
- Concluída, sem código: [CHAVE-DA-TAREFA], [explicação do responsável ou "verificando com o responsável"]
- Aguardando revisão: [link do PR] aberto desde [data], revisor [nome ou "não registrado"]
- Bloqueada com código aberto: [link do PR] contra [CHAVE-DA-TAREFA]
- Parada: [CHAVE-DA-TAREFA], [explicação do responsável ou "verificando com o responsável"]
Trabalho sem vínculo (código mesclado, sem tarefa): [link do PR], [tarefa sugerida ou "precisa de tarefa"], ou "nenhum"
PRs compartilhados: [link do PR] listado em [CHAVE] e [CHAVE], ou "nenhum"
Escopo: projeto Jira [chave]; repositórios [lista]; campo de marco [nome do campo]
Faça do pedido uma escolha com recomendação, e não uma pergunta aberta. Assim o patrocinador responde em uma única mensagem.
Qual prompt usar no assistente de IA?
O prompt manda o assistente ler o Jira e o GitHub, unir os dois pela chave da tarefa e agrupar pelo campo de marco combinado. Cole-o em um assistente que consiga ler as duas fontes, com os campos entre colchetes já preenchidos.
Você está redigindo um relatório semanal de status para [nome ou cargo do patrocinador] sobre [nome do projeto].
Fontes: projeto Jira [chave] e repositórios GitHub [lista].
Período: de [data e hora inicial] a [data e hora final], [fuso horário].
Campo de marco: [nome do campo no Jira]. Agrupe apenas por este campo.
1. Liste as tarefas do Jira criadas, movidas ou concluídas no período, com status, responsável e marco exatamente como o Jira registra.
2. Liste os pull requests do GitHub abertos, revisados ou mesclados no período.
3. Associe cada PR a uma tarefa pela chave do Jira no nome da branch, no título do PR ou nas mensagens de commit. Não associe por semelhança de texto.
4. Se um PR citar várias chaves, liste-o em cada tarefa e marque "PR compartilhado".
5. Agrupe o trabalho associado por marco, em Entregue, Em revisão, Bloqueada e Próxima semana.
6. Em "Divergências para resolver", liste:
- Concluída, sem código: tarefas concluídas no período sem PR mesclado.
- Aguardando revisão: PRs abertos há mais de [limite] sem revisão, com o revisor ou "não registrado".
- Bloqueada com código aberto: PRs abertos contra tarefas em status de bloqueio.
- Parada: tarefas em andamento sem commits vinculados nem atividade de PR no período.
7. Liste PRs mesclados sem chave de tarefa em "Trabalho sem vínculo". Não os associe a nenhuma tarefa.
8. Nunca invente data, responsável, estimativa ou causa. Se um campo faltar na fonte, escreva "não registrado".
9. Escreva "O que precisamos de você" somente com bloqueios e decisões registrados no Jira. Se a fonte não trouxer opções, recomendação ou data, escreva "a preencher pelo responsável" nesses campos. Se não houver bloqueio nem decisão, escreva "Nenhum pedido nesta semana".
10. Marque a saída como RASCUNHO PARA REVISÃO DO RESPONSÁVEL. Não envie.
Use o modelo abaixo. [cole o modelo]
Mantenha a regra 8 mesmo que corte o resto do prompt. A regra 9 limita o pedido ao que está registrado no Jira. Opções, recomendação e data normalmente não estão lá, por isso a IA deixa esses campos em aberto, e você, como líder do projeto, os completa antes do envio.
Como transformar um bloqueio em pedido ao patrocinador?
Um bloqueio vira pedido quando o relatório o transforma em uma decisão que o patrocinador pode tomar: o que está parado, o que ele pode fazer, até quando e o que muda se nada acontecer. Coloque esse pedido no topo e mantenha o item bloqueado no marco, para que o patrocinador veja a evidência por trás dele.
A linha de origem, em um exemplo ilustrativo com marcadores no lugar dos dados reais, fica assim:
[Nome do marco], prazo [data], em risco
Bloqueada: [CHAVE-DA-TAREFA] [resumo], bloqueada por [causa], precisa de [aprovação de acesso pelo patrocinador]
Essa linha vira o pedido do topo: "Aprovar o acesso do fornecedor [nome] até [data], para que [CHAVE-DA-TAREFA] possa começar; caso contrário, [marco] passa para [nova data]."
Antes do envio, resolva cada linha "Concluída, sem código" com o responsável. Se ele confirmar que o código não era necessário, registre o motivo na versão da equipe e tire a linha da cópia do patrocinador. Se o código ainda é devido, mova a tarefa para Em revisão ou Próxima semana, conforme o estágio.
Como agendar o relatório?
Rode o relatório em dia e hora fixos, em fuso horário declarado, antes da reunião com o patrocinador. Há três caminhos, e em todos a saída chega para você como rascunho.
Uma tarefa agendada no GitHub Actions é a opção mais automática. O repositório jira-weekly-report mostra um agendamento com GitHub Actions para o relatório só do Jira, e o README traz uma seção sobre agendamento e horário de verão. Confira nele o horário configurado antes de copiar o padrão. Para o relatório combinado, acerte com quem mantém os fluxos do repositório o dia e a hora, o fuso horário, o acesso de leitura tanto ao projeto Jira [chave] quanto aos repositórios [lista], e a entrega somente para você, por e-mail ou canal de chat.
Se preferir um agente de IA agendado, confirme que ele lê o Jira e o GitHub, e não apenas um dos dois. Salve o prompt com o período e o campo de marco preenchidos e marque a execução para o mesmo dia e hora toda semana.
Sem automação, reserve um horário recorrente em [dia], antes da reunião com o patrocinador, cole o prompt no seu assistente e atualize o período.
O que revisar antes do envio ao patrocinador?
Antes do envio, confirme que cada afirmação remete a uma tarefa ou a um PR, e que cada divergência tem resposta do responsável ou um próximo passo claro. Depois, veja se o pedido do topo tem opções, recomendação e data.
- Abra uma amostra dos links e confirme que o status bate com o que aparece.
- Troque cada "não registrado" pelo valor real, ou deixe e diga quem está descobrindo.
- Confira se a situação geral bate com o detalhe dos marcos.
- Veja se o pedido tem opções, recomendação e data.
- Tire os detalhes de engenharia que o patrocinador não precisa, como contagem de commits ou nomes de branch.
Para começar, marque a primeira execução de teste para segunda-feira, 23/11/2026, com o período real da semana anterior. Compare o rascunho, linha por linha, com o Jira e o GitHub, registre o que ele errou e ajuste o prompt antes de enviar qualquer versão ao patrocinador.