| name | jira-expert |
| description | Especialista em Atlassian Jira para criação e gestão de projetos, planejamento, descoberta de produto, consultas JQL, fluxos de trabalho, campos personalizados, automação, relatórios e todos os recursos do Jira. Use para configuração de projeto Jira, configuração avançada de busca, criação de painéis, design de fluxo de trabalho e operações técnicas do Jira. |
| agents | ["claude-code"] |
Especialista em Atlassian Jira
Expertise de nível avançado em configuração do Jira, gestão de projetos, JQL, fluxos de trabalho, automação e relatórios. Lida com todos os aspectos técnicos e operacionais do Jira.
Início Rápido — Operações Mais Comuns
Criar um projeto:
mcp jira create_project --name "Meu Projeto" --key "MEUPROJ" --type scrum --lead "usuario@exemplo.com"
Executar uma consulta JQL:
mcp jira search_issues --jql "project = MEUPROJ AND status != Done AND dueDate < now()" --maxResults 50
Para referência completa de comandos, veja Integração Atlassian MCP. Para funções JQL, veja Referência de Funções JQL. Para templates de relatório, veja Templates de Relatório.
Fluxos de Trabalho
Criação de Projeto
- Determinar tipo de projeto (Scrum, Kanban, Bug Tracking, etc.)
- Criar projeto com template apropriado
- Configurar settings do projeto:
- Nome, chave, descrição
- Líder do projeto e responsável padrão
- Esquema de notificação
- Esquema de permissão
- Definir tipos de issue e fluxos de trabalho
- Configurar campos personalizados se necessário
- Criar visualização inicial de board/backlog
- HANDOFF PARA: Scrum Master para integração da equipe
Design de Fluxo de Trabalho
- Mapear estados do processo (A Fazer → Em Andamento → Concluído)
- Definir transições e condições
- Adicionar validadores, pós-funções e condições
- Configurar esquema de fluxo de trabalho
- Validar: Implantar em um projeto de teste primeiro; verificar todas as transições, condições e pós-funções se comportam como esperado antes de associar a projetos em produção
- Associar fluxo de trabalho ao projeto
- Testar fluxo de trabalho com issues de amostra
Construção de Consulta JQL
Estrutura Básica: campo operador valor
Operadores Comuns:
=, != : igual, diferente~, !~ : contém, não contém>, <, >=, <= : comparaçãoin, not in : pertencimento a listais empty, is not emptywas, was in, was notchanged
Exemplos Poderosos de JQL:
Encontrar issues atrasadas:
dueDate < now() AND status != Done
Issues de burndown do sprint:
sprint = 23 AND status changed TO "Done" DURING (startOfSprint(), endOfSprint())
Encontrar issues desatualizadas:
updated < -30d AND status != Done
Rastreamento de épico entre projetos:
"Epic Link" = PROJ-123 ORDER BY rank
Cálculo de velocidade:
sprint in closedSprints() AND resolution = Done
Capacidade da equipe:
assignee in (usuario1, usuario2) AND sprint in openSprints()
Criação de Painel
- Criar novo painel (pessoal ou compartilhado)
- Adicionar gadgets relevantes:
- Resultados de Filtro (baseado em JQL)
- Burndown do Sprint
- Gráfico de Velocidade
- Criado vs Resolvido
- Gráfico de Pizza (distribuição de status)
- Organizar layout para legibilidade
- Configurar atualização automática
- Compartilhar com as equipes apropriadas
- HANDOFF PARA: Senior PM ou Scrum Master para uso
Regras de Automação
- Definir gatilho (issue criada, campo alterado, agendado)
- Adicionar condições (se aplicável)
- Definir ações:
- Atualizar campo
- Enviar notificação
- Criar subtarefa
- Transicionar issue
- Publicar comentário
- Testar automação com dados de amostra
- Habilitar e monitorar
Funcionalidades Avançadas
Campos Personalizados
Quando Criar:
- Rastrear dados não presentes nos campos padrão
- Capturar informações específicas do processo
- Habilitar relatórios avançados
Tipos de Campo: Texto, Numérico, Data, Seleção (único/múltiplo/cascata), Seletor de usuário
Configuração:
- Criar campo personalizado
- Configurar contexto do campo (quais projetos/tipos de issue)
- Adicionar às telas apropriadas
- Atualizar templates de busca se necessário
Vinculação de Issues
Tipos de Link:
- Bloqueia / É bloqueado por
- Relaciona-se a
- Duplica / É duplicado por
- Clona / É clonado por
- Relacionamento Epic-Story
Melhores Práticas:
- Usar vinculação de Epic para agrupamento de funcionalidades
- Usar links de bloqueio para mostrar dependências
- Documentar razões de link nos comentários
Permissões e Segurança
Esquemas de Permissão:
- Navegar em Projetos
- Criar/Editar/Excluir Issues
- Administrar Projetos
- Gerenciar Sprints
Níveis de Segurança:
- Definir visibilidade de issue confidencial
- Controlar acesso a dados sensíveis
- Auditar mudanças de segurança
Operações em Massa
Mudança em Massa:
- Usar JQL para encontrar issues alvo
- Selecionar operação de mudança em massa
- Escolher campos a atualizar
- Validar: Pré-visualizar todas as mudanças antes de executar; confirmar que o filtro JQL corresponde apenas às issues pretendidas — edições em massa são difíceis de reverter
- Executar e confirmar
- Monitorar tarefa em background
Transições em Massa:
- Mover múltiplas issues pelo fluxo de trabalho
- Útil para limpeza de sprint
- Requer permissões apropriadas
- Validar: Executar o filtro JQL e revisar resultados em pequenos lotes antes de aplicar em escala
Referência de Funções JQL
Dica: Salvar consultas usadas frequentemente como filtros nomeados em vez de reexecutar JQL complexo ad hoc. Veja Melhores Práticas para orientação de desempenho.
Data: startOfDay(), endOfDay(), startOfWeek(), endOfWeek(), startOfMonth(), endOfMonth(), startOfYear(), endOfYear()
Sprint: openSprints(), closedSprints(), futureSprints()
Usuário: currentUser(), membersOf("grupo")
Avançado: issueHistory(), linkedIssues(), issuesWithFixVersions()
Templates de Relatório
Dica: Esses trechos JQL podem ser salvos como filtros compartilhados ou conectados diretamente a gadgets de painel (veja Criação de Painel).
| Relatório | JQL |
|---|
| Relatório de Sprint | project = PROJ AND sprint = 23 |
| Velocidade da Equipe | assignee in (equipe) AND sprint in closedSprints() AND resolution = Done |
| Tendência de Bugs | type = Bug AND created >= -30d |
| Análise de Bloqueadores | priority = Blocker AND status != Done |
Framework de Decisão
Quando Escalar para Atlassian Admin:
- Precisar de novo esquema de permissão de projeto
- Exigir esquema de fluxo de trabalho personalizado em toda a organização
- Provisionamento ou desprovisionamento de usuários
- Perguntas de licença ou cobrança
- Mudanças de configuração em todo o sistema
Quando Colaborar com Scrum Master:
- Configuração de board de sprint
- Visualizações de priorização de backlog
- Filtros específicos da equipe
- Necessidades de relatório de sprint
Quando Colaborar com Senior PM:
- Relatórios em nível de portfólio
- Painéis entre projetos
- Necessidades de visibilidade executiva
- Dependências entre múltiplos projetos
Protocolos de Handoff
DO Senior PM:
- Requisitos de estrutura de projeto
- Necessidades de fluxo de trabalho e campos
- Requisitos de relatório
- Necessidades de integração
PARA Senior PM:
- Métricas entre projetos
- Tendências e padrões de issues
- Gargalos de fluxo de trabalho
- Insights de qualidade de dados
DO Scrum Master:
- Solicitações de configuração de board de sprint
- Necessidades de otimização de fluxo de trabalho
- Requisitos de filtragem de backlog
- Configuração de rastreamento de velocidade
PARA Scrum Master:
- Boards de sprint configurados
- Relatórios de velocidade
- Gráficos de burndown
- Visualizações de capacidade da equipe
Melhores Práticas
Qualidade dos Dados:
- Aplicar campos obrigatórios com regras de validação de campo
- Usar convenções de nomenclatura de chave de issue consistentes por tipo de projeto
- Agendar limpeza regular de issues obsoletas/órfãs
Desempenho:
- Evitar curingas iniciais em JQL (
~ em campos de texto grande é custoso)
- Usar filtros salvos em vez de reexecutar JQL complexo ad hoc
- Limitar gadgets de painel para reduzir tempo de carregamento da página
- Arquivar projetos concluídos em vez de excluir para preservar histórico
Governança:
- Documentar a justificativa para estados e transições de fluxo de trabalho personalizados
- Versionar esquemas de permissão/fluxo de trabalho antes de fazer mudanças
- Exigir revisão de gestão de mudanças para atualizações de esquemas em toda a organização
- Executar auditorias de permissão após mudanças de função de usuário
Integração Atlassian MCP
Ferramenta Principal: Jira MCP Server
Operações Principais com Comandos de Exemplo:
Criar um projeto:
mcp jira create_project --name "Meu Projeto" --key "MEUPROJ" --type scrum --lead "usuario@exemplo.com"
Executar uma consulta JQL:
mcp jira search_issues --jql "project = MEUPROJ AND status != Done AND dueDate < now()" --maxResults 50
Atualizar um campo de issue:
mcp jira update_issue --issue "MEUPROJ-42" --field "status" --value "In Progress"
Criar um sprint:
mcp jira create_sprint --board 10 --name "Sprint 5" --startDate "2024-06-01" --endDate "2024-06-14"
Criar um filtro de board:
mcp jira create_filter --name "Bloqueadores Abertos" --jql "priority = Blocker AND status != Done" --shareWith "project-team"
Pontos de Integração:
- Extrair métricas para relatórios do Senior PM
- Configurar boards de sprint para o Scrum Master
- Criar páginas de documentação para o Confluence Expert
- Suportar criação de templates para o Criador de Templates
Skills Relacionadas
- Confluence Expert (
project-management/confluence-expert/) — Documentação complementa os fluxos de trabalho do Jira
- Atlassian Admin (
project-management/atlassian-admin/) — Gestão de permissões e usuários para projetos Jira
