GitScrum / Docs

Types de tâches

Gestion des types de tâches via MCP. Configurez et assignez des types de tâches comme Bug, Feature et Improvement pour catégoriser les éléments de travail.

Open Source — GitScrum MCP Server est open source sous la licence MIT. Disponible sur npm et sur GitHub. Serveur Model Context Protocol pour GitScrum — Claude, GitHub Copilot, Cursor et tout client compatible MCP disposent d'un accès opérationnel complet à votre stack de gestion de projets.

L'outil task_type fournit 4 actions pour gérer les types de tâches — le système de classification structurelle qui définit le type de travail que chaque tâche représente. Les types de tâches comme Bug, Feature, Improvement et Technical Debt offrent à votre équipe un moyen cohérent de catégoriser les éléments de travail, permettant un reporting précis, une analyse des sprints et des insights sur la répartition de la charge de travail.

Les types de tâches dans GitScrum sont au niveau du projet, ce qui signifie que chaque projet maintient son propre ensemble de types disponibles. Cela permet à différents projets d'avoir des taxonomies différentes — un projet d'API backend pourrait utiliser "Endpoint", "Migration" et "Bug", tandis qu'un projet de design utilise "Mockup", "Prototype" et "Review". Le serveur MCP permet à votre assistant IA de découvrir les types disponibles, d'en créer de nouveaux et de les assigner lors de la création ou la mise à jour de tâches.


Aperçu des actions

ActionObjectifParamètres requis
listLister tous les types de tâches disponibles dans un projetcompanyslug, projectslug
getObtenir les détails complets d'un type de tâche spécifiqueuuid, companyslug, projectslug
createCréer un nouveau type de tâchecompanyslug, projectslug, title
updateModifier un type de tâche existantuuid, companyslug, projectslug

Lister les types de tâches

L'action list retourne tous les types de tâches configurés pour un projet spécifique. Chaque type dans la réponse inclut son id, titre et couleur. Le champ id est ce que vous passez comme type_id lors de la création ou mise à jour de tâches via l'outil task.

C'est typiquement le premier appel que fait votre assistant IA lorsqu'il a besoin de créer une tâche avec un type spécifique — il récupère les types disponibles, identifie le bon id et l'utilise dans l'appel de création de tâche.

Paramètres requis

ParamètreTypeDescription
company_slugstringIdentifiant du workspace (depuis l'outil workspace)
project_slugstringIdentifiant du projet (depuis l'outil project)

Exemples de prompts

Vous :  "Liste les types de tâches disponibles dans le projet Backend"
IA :    Appelle task_type action=list → retourne tous les types avec identifiants, titres et couleurs

Vous :  "Quels types de tâches puis-je utiliser ?"
IA :    Appelle task_type action=list → présente les options de types disponibles

Vous :  "Montre-moi la configuration des types du projet Frontend"
IA :    Appelle task_type action=list → affiche la taxonomie des types du projet

Obtenir les détails d'un type de tâche

L'action get retourne les détails complets d'un type de tâche spécifique, incluant son titre, couleur et toutes les métadonnées supplémentaires. C'est utile quand vous devez inspecter la configuration d'un type ou vérifier ses propriétés avant de faire des modifications.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID du type de tâche (depuis la réponse list)
company_slugstringIdentifiant du workspace
project_slugstringIdentifiant du projet

Exemples de prompts

Vous :  "Montre-moi les détails du type de tâche Bug"
IA :    Trouve le type via list → appelle task_type action=get → retourne les détails complets

Vous :  "Quelle couleur est le type Feature ?"
IA :    Appelle task_type action=get → extrait et présente la valeur de couleur

Créer des types de tâches

L'action create construit un nouveau type de tâche pour le projet. Les types de tâches ont besoin d'un titre et peuvent optionnellement inclure une couleur pour l'identification visuelle. Une fois créé, le type devient disponible pour l'assignation à n'importe quelle tâche du projet.

Paramètres requis

ParamètreTypeDescription
company_slugstringIdentifiant du workspace (depuis l'outil workspace)
project_slugstringIdentifiant du projet (depuis l'outil project)
titlestringNom du type (ex. "Bug", "Feature", "Technical Debt", "Research")

Paramètres optionnels

ParamètreTypeDescription
colorstringCode couleur hexadécimal sans le préfixe # (ex. EF4444, 3B82F6) pour l'identification visuelle

Taxonomie de types recommandée

Bien que chaque équipe puisse définir ses propres types, voici les schémas courants alignés sur les bonnes pratiques agiles :

TypeObjectifCouleur suggérée
BugDéfauts et comportements inattendusEF4444 (rouge)
FeatureNouvelles capacités et fonctionnalités3B82F6 (bleu)
ImprovementAméliorations de fonctionnalités existantes10B981 (vert)
Technical DebtQualité du code, refactoring, performance8B5CF6 (violet)
ResearchInvestigation, spikes et preuves de conceptF59E0B (ambre)
ChoreMaintenance, mises à jour de dépendances, configuration6B7280 (gris)
DocumentationDocs, README, références API06B6D4 (cyan)

Exemples de prompts

Vous :  "Crée un nouveau type de tâche 'Technical Debt' avec la couleur violette"
IA :    Appelle task_type action=create avec title="Technical Debt", color="8B5CF6"

Vous :  "Ajoute un type de tâche 'Research' pour le projet Backend"
IA :    Appelle task_type action=create avec title="Research", company_slug, project_slug

Vous :  "Configure les types de tâches pour un nouveau projet : Bug (rouge), Feature (bleu),
         Improvement (vert) et Chore (gris)"
IA :    Appelle task_type action=create quatre fois avec des titres et couleurs distincts

Vous :  "Crée un type 'Documentation' en cyan"
IA :    Appelle task_type action=create avec title="Documentation", color="06B6D4"

Mettre à jour les types de tâches

L'action update modifie le titre ou la couleur d'un type de tâche existant. Seuls les champs que vous spécifiez sont modifiés. C'est utile pour renommer les types au fur et à mesure que le vocabulaire de votre équipe évolue ou ajuster les couleurs pour une cohérence visuelle.

Paramètres requis

ParamètreTypeDescription
uuidstringUUID du type de tâche (depuis la réponse list ou get)
company_slugstringIdentifiant du workspace
project_slugstringIdentifiant du projet

Paramètres optionnels

ParamètreTypeDescription
titlestringNouveau titre du type
colorstringNouveau code couleur hexadécimal sans #

Exemples de prompts

Vous :  "Renomme le type 'Bug' en 'Defect'"
IA :    Trouve le type via list → appelle task_type action=update avec title="Defect"

Vous :  "Change la couleur du type Feature en bleu foncé"
IA :    Appelle task_type action=update avec color="1D4ED8"

Vous :  "Mets à jour le type Chore en 'Maintenance' avec une couleur ardoise"
IA :    Appelle task_type action=update avec title="Maintenance", color="64748B"

Utiliser les types de tâches lors de la création de tâches

Les types de tâches s'intègrent directement avec l'outil task. Lors de la création d'une tâche, vous pouvez passer le paramètre type_id pour assigner un type. L'assistant IA gère la résolution automatiquement — vous mentionnez le type par nom, et l'assistant le résout en identifiant numérique correct.

Comment fonctionne la résolution de type

  1. Vous dites : "Crée une tâche bug 'La connexion échoue sur Safari'"
  2. L'assistant IA appelle task_type action=list pour récupérer les types disponibles
  3. Il trouve le type "Bug" et extrait son id
  4. Il appelle task action=create avec type_id défini sur l'ID du type Bug

Cette résolution se fait en coulisses. En pratique, vous mentionnez simplement le type par nom dans votre prompt, et le serveur MCP gère le reste.

Exemples de prompts

Vous :  "Crée un bug 'Fuite mémoire dans le widget du tableau de bord'"
IA :    Liste les types → trouve l'ID Bug → crée la tâche avec type_id

Vous :  "Ajoute une tâche feature 'Support du mode sombre' au projet Frontend"
IA :    Liste les types → trouve l'ID Feature → crée la tâche avec type_id

Vous :  "Crée une tâche de dette technique pour refactorer le module d'authentification"
IA :    Liste les types → trouve l'ID Technical Debt → crée la tâche avec type_id

Vous :  "Enregistre une tâche research 'Évaluer les bibliothèques WebSocket' avec une estimation de 4 heures"
IA :    Liste les types → trouve l'ID Research → crée la tâche avec type_id et estimated_minutes=240

Reporting par type de tâche

Les types de tâches alimentent les rapports de distribution par type dans les analyses de sprint. Lorsque vous demandez des rapports de sprint via l'action reports de l'outil sprint avec resource="types", la réponse ventile les tâches par type assigné. Cela révèle comment l'effort de votre équipe est réparti entre les différents types de travail.

Vous :  "Quel pourcentage de notre sprint est en corrections de bugs vs fonctionnalités ?"
IA :    Appelle sprint action=reports avec resource="types"
        → retourne la distribution par type avec pourcentages

Vous :  "Montre-moi la ventilation par type du sprint en cours"
IA :    Appelle sprint action=reports avec resource="task_type_distribution"
        → retourne la distribution détaillée par type avec le statut de complétion

Ces données sont précieuses pour les rétrospectives — si 60 % du travail du sprint était de la correction de bugs, l'équipe pourrait avoir besoin d'investir davantage dans les tests ou la revue de code pour réduire le taux de défauts dans les sprints futurs.


Résolution automatique du contexte

L'outil task type supporte la résolution automatique du contexte. Si l'assistant IA connaît déjà votre workspace et projet depuis un appel précédent dans la conversation, il transporte ce contexte. Cela signifie que vous n'avez pas besoin de répéter les identifiants de projet pour chaque opération de type.


Prochaines étapes

  • Tâches : Créez des tâches avec des types spécifiques en utilisant le paramètre type_id.
  • Labels : Combinez les types de tâches avec les labels pour une catégorisation multidimensionnelle.
  • Sprints : Analysez la distribution par type à travers les sprints.
  • Workflows : Configurez les colonnes Kanban que les tâches traversent.
  • Démarrage rapide : Configurez le serveur MCP si ce n'est pas déjà fait.