Tipos de Tarefa

Código Aberto — O GitScrum MCP Server é código aberto sob a licença MIT. Disponível no npm e no GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor e qualquer cliente compatível com MCP têm acesso operacional completo à sua stack de gerenciamento de projetos.

A ferramenta task_type fornece 4 ações para gerenciar tipos de tarefa — o sistema de classificação estrutural que define que tipo de trabalho cada tarefa representa. Tipos de tarefa como Bug, Feature, Improvement e Technical Debt dão à sua equipe uma forma consistente de categorizar itens de trabalho, permitindo relatórios precisos, análise de sprint e insights de distribuição de carga de trabalho.

Tipos de tarefa no GitScrum têm escopo de projeto, o que significa que cada projeto mantém seu próprio conjunto de tipos disponíveis. Isso permite que diferentes projetos tenham taxonomias de tipos diferentes — um projeto de API backend pode usar "Endpoint", "Migration" e "Bug", enquanto um projeto de design usa "Mockup", "Prototype" e "Review". O MCP Server permite que seu assistente de IA descubra tipos disponíveis, crie novos e os atribua ao criar ou atualizar tarefas.

Visão Geral das Ações

Listando Tipos de Tarefa

A ação list retorna todos os tipos de tarefa configurados para um projeto específico. Cada tipo na resposta inclui seu id, título e cor. O campo id é o que você passa como type_id ao criar ou atualizar tarefas pela ferramenta task.

Esta é tipicamente a primeira chamada que seu assistente de IA faz quando precisa criar uma tarefa com um tipo específico — ele busca os tipos disponíveis, identifica o id correto e o usa na chamada de criação de tarefa.

Parâmetros Obrigatórios

Exemplos de Prompts

Você:  "Listar tipos de tarefa disponíveis no projeto Backend"
IA:    Chama task_type action=list → retorna todos os tipos com IDs, títulos e cores

Você:  "Quais tipos de tarefa posso usar?"
IA:    Chama task_type action=list → apresenta as opções de tipos disponíveis

Você:  "Mostrar a configuração de tipos do projeto Frontend"
IA:    Chama task_type action=list → exibe a taxonomia de tipos do projeto

Obtendo Detalhes do Tipo de Tarefa

A ação get retorna os detalhes completos de um tipo de tarefa específico, incluindo título, cor e metadados adicionais. Isso é útil quando você precisa inspecionar a configuração de um tipo ou verificar suas propriedades antes de fazer atualizações.

Parâmetros Obrigatórios

Exemplos de Prompts

Você:  "Mostrar detalhes do tipo de tarefa Bug"
IA:    Encontra o tipo via list → chama task_type action=get → retorna detalhes completos

Você:  "Qual é a cor do tipo Feature?"
IA:    Chama task_type action=get → extrai e apresenta o valor da cor

Criando Tipos de Tarefa

A ação create constrói um novo tipo de tarefa para o projeto. Tipos de tarefa precisam de um título e podem opcionalmente incluir uma cor para identificação visual. Uma vez criado, o tipo fica disponível para atribuição a qualquer tarefa no projeto.

Parâmetros Obrigatórios

Parâmetros Opcionais

Taxonomia de Tipos Recomendada

Embora cada equipe possa definir seus próprios tipos, estes são padrões comuns alinhados com boas práticas ágeis:

Exemplos de Prompts

Você:  "Criar um novo tipo de tarefa 'Technical Debt' com cor roxa"
IA:    Chama task_type action=create com title="Technical Debt", color="8B5CF6"

Você:  "Adicionar um tipo de tarefa 'Research' ao projeto Backend"
IA:    Chama task_type action=create com title="Research", company_slug, project_slug

Você:  "Configurar tipos de tarefa para um novo projeto: Bug (vermelho), Feature (azul),
       Improvement (verde) e Chore (cinza)"
IA:    Chama task_type action=create quatro vezes com títulos e cores distintos

Você:  "Criar um tipo 'Documentation' em ciano"
IA:    Chama task_type action=create com title="Documentation", color="06B6D4"

Atualizando Tipos de Tarefa

A ação update modifica o título ou cor de um tipo de tarefa existente. Apenas os campos que você especifica são alterados. Isso é útil para renomear tipos conforme o vocabulário da equipe evolui ou ajustar cores para consistência visual.

Parâmetros Obrigatórios

Parâmetros Opcionais

Exemplos de Prompts

Você:  "Renomear o tipo 'Bug' para 'Defect'"
IA:    Encontra o tipo via list → chama task_type action=update com title="Defect"

Você:  "Mudar a cor do tipo Feature para azul escuro"
IA:    Chama task_type action=update com color="1D4ED8"

Você:  "Atualizar o tipo Chore para 'Maintenance' com cor slate"
IA:    Chama task_type action=update com title="Maintenance", color="64748B"

Usando Tipos de Tarefa ao Criar Tarefas

Tipos de tarefa se integram diretamente com a ferramenta task. Ao criar uma tarefa, você pode passar o parâmetro type_id para atribuir um tipo. O assistente de IA lida com a busca automaticamente — você menciona o tipo por nome, e o assistente resolve para o ID numérico correto.

Como a Resolução de Tipos Funciona

1. Você diz: "Criar uma tarefa de bug 'Login falha no Safari'"
2. O assistente de IA chama task_type action=list para buscar tipos disponíveis
3. Ele encontra o tipo "Bug" e extrai seu id
4. Ele chama task action=create com type_id definido para o ID do tipo Bug

Esta resolução acontece nos bastidores. Na prática, você simplesmente menciona o tipo por nome no seu prompt, e o servidor MCP cuida do resto.

Exemplos de Prompts

Você:  "Criar um bug 'Vazamento de memória no widget do dashboard'"
IA:    Lista tipos → encontra ID do Bug → cria tarefa com type_id

Você:  "Adicionar uma tarefa de feature 'Suporte a modo escuro' ao projeto Frontend"
IA:    Lista tipos → encontra ID do Feature → cria tarefa com type_id

Você:  "Criar uma tarefa de tech debt para refatorar o módulo de autenticação"
IA:    Lista tipos → encontra ID do Technical Debt → cria tarefa com type_id

Você:  "Registrar uma tarefa de research 'Avaliar bibliotecas WebSocket' com estimativa de 4 horas"
IA:    Lista tipos → encontra ID do Research → cria tarefa com type_id e estimated_minutes=240

Relatórios por Tipo de Tarefa

Tipos de tarefa alimentam os relatórios de distribuição por tipo nos analytics de sprint. Quando você solicita relatórios de sprint pela ação reports da ferramenta sprint com resource="types", a resposta detalha tarefas por tipo atribuído. Isso revela como o esforço da sua equipe está distribuído entre diferentes tipos de trabalho.

Você:  "Qual porcentagem do nosso sprint é correção de bugs vs features?"
IA:    Chama sprint action=reports com resource="types"
      → retorna distribuição por tipo com porcentagens

Você:  "Mostrar a divisão por tipo do sprint atual"
IA:    Chama sprint action=reports com resource="task_type_distribution"
      → retorna distribuição detalhada por tipo com status de conclusão

Esses dados são valiosos para retrospectivas — se 60% do trabalho do sprint foi correção de bugs, a equipe pode precisar investir mais em testes ou code review para reduzir taxas de defeitos em sprints futuros.

Resolução Automática de Contexto

A ferramenta de tipos de tarefa suporta resolução automática de contexto. Se o assistente de IA já conhece seu workspace e projeto de uma chamada anterior na conversa, ele mantém esse contexto. Isso significa que você não precisa repetir identificadores de projeto para cada operação de tipo.

Próximos Passos

• Tarefas: Crie tarefas com tipos específicos usando o parâmetro type_id.
• Labels: Combine tipos de tarefa com labels para categorização multidimensional.
• Sprints: Analise distribuição por tipo em sprints.
• Workflows: Configure as colunas Kanban pelas quais as tarefas se movem.
• Início Rápido: Configure o servidor MCP se ainda não o fez.