Tipos de Tarea

Código Abierto — GitScrum MCP Server es código abierto bajo la licencia MIT. Disponible en npm y en GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor y cualquier cliente compatible con MCP tienen acceso operacional completo a tu stack de gestión de proyectos.

La herramienta task_type proporciona 4 acciones para gestionar tipos de tarea — el sistema de clasificación estructural que define qué tipo de trabajo representa cada tarea. Tipos de tarea como Bug, Feature, Improvement y Technical Debt le dan a tu equipo una forma consistente de categorizar elementos de trabajo, permitiendo reportes precisos, análisis de sprint y perspectivas sobre la distribución de la carga de trabajo.

Los tipos de tarea en GitScrum tienen alcance de proyecto, lo que significa que cada proyecto mantiene su propio conjunto de tipos disponibles. Esto permite que diferentes proyectos tengan diferentes taxonomías de tipos — un proyecto de API backend podría usar "Endpoint", "Migration" y "Bug", mientras que un proyecto de diseño usa "Mockup", "Prototype" y "Review". El MCP Server permite a tu asistente de IA descubrir tipos disponibles, crear nuevos y asignarlos al crear o actualizar tareas.

Resumen de acciones

Listar tipos de tarea

La acción list devuelve todos los tipos de tarea configurados para un proyecto específico. Cada tipo en la respuesta incluye su id, título y color. El campo id es lo que pasas como type_id al crear o actualizar tareas a través de la herramienta task.

Esta es típicamente la primera llamada que tu asistente de IA hace cuando necesita crear una tarea con un tipo específico — obtiene los tipos disponibles, identifica el id correcto y lo usa en la llamada de creación de tarea.

Parámetros requeridos

Ejemplos de prompts

Tú:   "Lista los tipos de tarea disponibles en el proyecto Backend"
IA:   Llama a task_type action=list → devuelve todos los tipos con IDs, títulos y colores

Tú:   "¿Qué tipos de tarea puedo usar?"
IA:   Llama a task_type action=list → presenta las opciones de tipo disponibles

Tú:   "Muéstrame la configuración de tipos del proyecto Frontend"
IA:   Llama a task_type action=list → muestra la taxonomía de tipos del proyecto

Obtener detalles del tipo de tarea

La acción get devuelve los detalles completos de un tipo de tarea específico, incluyendo su título, color y cualquier metadato adicional. Esto es útil cuando necesitas inspeccionar la configuración de un tipo o verificar sus propiedades antes de hacer actualizaciones.

Parámetros requeridos

Ejemplos de prompts

Tú:   "Muéstrame los detalles del tipo de tarea Bug"
IA:   Encuentra el tipo via list → llama a task_type action=get → devuelve detalles completos

Tú:   "¿Qué color tiene el tipo Feature?"
IA:   Llama a task_type action=get → extrae y presenta el valor del color

Crear tipos de tarea

La acción create construye un nuevo tipo de tarea para el proyecto. Los tipos de tarea necesitan un título y opcionalmente pueden incluir un color para identificación visual. Una vez creado, el tipo queda disponible para asignación a cualquier tarea del proyecto.

Parámetros requeridos

Parámetros opcionales

Taxonomía de tipos recomendada

Aunque cada equipo puede definir sus propios tipos, estos son patrones comunes que se alinean con las mejores prácticas ágiles:

Ejemplos de prompts

Tú:   "Crea un nuevo tipo de tarea 'Technical Debt' con color púrpura"
IA:   Llama a task_type action=create con title="Technical Debt", color="8B5CF6"

Tú:   "Agrega un tipo de tarea 'Research' al proyecto Backend"
IA:   Llama a task_type action=create con title="Research", company_slug, project_slug

Tú:   "Configura tipos de tarea para un nuevo proyecto: Bug (rojo), Feature (azul),
       Improvement (verde) y Chore (gris)"
IA:   Llama a task_type action=create cuatro veces con títulos y colores distintos

Tú:   "Crea un tipo 'Documentation' en cyan"
IA:   Llama a task_type action=create con title="Documentation", color="06B6D4"

Actualizar tipos de tarea

La acción update modifica el título o color de un tipo de tarea existente. Solo los campos que especifiques se cambian. Esto es útil para renombrar tipos a medida que el vocabulario de tu equipo evoluciona o ajustar colores para consistencia visual.

Parámetros requeridos

Parámetros opcionales

Ejemplos de prompts

Tú:   "Renombra el tipo 'Bug' a 'Defect'"
IA:   Encuentra el tipo via list → llama a task_type action=update con title="Defect"

Tú:   "Cambia el color del tipo Feature a azul oscuro"
IA:   Llama a task_type action=update con color="1D4ED8"

Tú:   "Actualiza el tipo Chore a 'Maintenance' con color slate"
IA:   Llama a task_type action=update con title="Maintenance", color="64748B"

Usar tipos de tarea al crear tareas

Los tipos de tarea se integran directamente con la herramienta task. Al crear una tarea, puedes pasar el parámetro type_id para asignar un tipo. El asistente de IA maneja la búsqueda automáticamente — tú mencionas el tipo por nombre, y el asistente lo resuelve al ID numérico correcto.

Cómo funciona la resolución de tipos

1. Tú dices: "Crea una tarea de tipo bug 'El login falla en Safari'"
2. El asistente de IA llama a task_type action=list para obtener los tipos disponibles
3. Encuentra el tipo "Bug" y extrae su id
4. Llama a task action=create con type_id establecido al ID del tipo Bug

Esta resolución sucede internamente. En la práctica, simplemente mencionas el tipo por nombre en tu prompt, y el servidor MCP se encarga del resto.

Ejemplos de prompts

Tú:   "Crea un bug 'Fuga de memoria en widget del dashboard'"
IA:   Lista tipos → encuentra ID de Bug → crea tarea con type_id

Tú:   "Agrega una tarea feature 'Soporte de modo oscuro' al proyecto Frontend"
IA:   Lista tipos → encuentra ID de Feature → crea tarea con type_id

Tú:   "Crea una tarea de deuda técnica para refactorizar el módulo de autenticación"
IA:   Lista tipos → encuentra ID de Technical Debt → crea tarea con type_id

Tú:   "Registra una tarea de investigación 'Evaluar librerías WebSocket' con estimación de 4 horas"
IA:   Lista tipos → encuentra ID de Research → crea tarea con type_id y estimated_minutes=240

Reportes por tipo de tarea

Los tipos de tarea alimentan los informes de distribución de tipos en las analíticas de sprint. Cuando solicitas informes de sprint a través de la acción reports de la herramienta sprint con resource="types", la respuesta desglosa las tareas por su tipo asignado. Esto revela cómo se distribuye el esfuerzo de tu equipo entre diferentes tipos de trabajo.

Tú:   "¿Qué porcentaje de nuestro sprint es corrección de bugs vs features?"
IA:   Llama a sprint action=reports con resource="types"
      → devuelve distribución de tipos con porcentajes

Tú:   "Muéstrame el desglose por tipo del sprint actual"
IA:   Llama a sprint action=reports con resource="task_type_distribution"
      → devuelve distribución detallada de tipos con estado de completado

Estos datos son invaluables para retrospectivas — si el 60% del trabajo del sprint fue corrección de bugs, el equipo podría necesitar invertir más en testing o revisiones de código para reducir las tasas de defectos en sprints futuros.

Auto-resolución de contexto

La herramienta task type soporta resolución automática de contexto. Si el asistente de IA ya conoce tu workspace y proyecto de una llamada previa en la conversación, lleva ese contexto hacia adelante. Esto significa que no necesitas repetir los identificadores del proyecto para cada operación de tipo.

Próximos pasos

• Tareas: Crea tareas con tipos específicos usando el parámetro type_id.
• Etiquetas: Combina tipos de tarea con etiquetas para categorización multidimensional.
• Sprints: Analiza la distribución de tipos entre sprints.
• Flujos de Trabajo: Configura las columnas Kanban por las que se mueven las tareas.
• Inicio Rápido: Configura el servidor MCP si aún no lo has hecho.