Outils - Sprints

Les sprints représentent des périodes de travail délimitées au sein d'un board. Lors de la clôture d'un sprint, les work items terminés sont archivés et un changelog ainsi qu'un rapport visuel sont générés automatiquement.

---

list_sprints

Liste tous les sprints d'un board. Le sprint ouvert apparaît en premier, suivi des sprints clôturés classés par date (les plus récents en premier).

Paramètres :

Nom	Type	Obligatoire	Description
boardId	string (UUID)	Oui	ID du board

Exemple :

{
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}

Réponse :

[
  {
    "id": "sprint-001",
    "name": "Sprint 12",
    "status": "open",
    "startDate": "2025-02-10T00:00:00.000Z",
    "endDate": "2025-02-24T00:00:00.000Z",
    "boardId": "b1234567-...",
    "workItemCount": 0,
    "createdAt": "2025-02-10T09:00:00.000Z"
  },
  {
    "id": "sprint-000",
    "name": "Sprint 11",
    "status": "closed",
    "startDate": "2025-01-27T00:00:00.000Z",
    "endDate": "2025-02-09T00:00:00.000Z",
    "boardId": "b1234567-...",
    "workItemCount": 18,
    "createdAt": "2025-01-27T09:00:00.000Z"
  }
]

---

get_sprint

Obtient un sprint par son ID, y compris le nombre de work items.

Paramètres :

Nom	Type	Obligatoire	Description
id	string (UUID)	Oui	ID du sprint

Exemple :

{
  "id": "sprint-001"
}

---

get_active_sprint

Obtient le sprint actuellement ouvert d'un board. Renvoie null s'il n'y a aucun sprint ouvert.

Paramètres :

Nom	Type	Obligatoire	Description
boardId	string (UUID)	Oui	ID du board

Exemple :

{
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}

Réponse :

{
  "id": "sprint-001",
  "name": "Sprint 12",
  "status": "open",
  "startDate": "2025-02-10T00:00:00.000Z",
  "endDate": "2025-02-24T00:00:00.000Z",
  "boardId": "b1234567-...",
  "workItemCount": 0
}

---

create_sprint

Crée un nouveau sprint dans un board. Il ne peut y avoir qu'un seul sprint ouvert à la fois par board.

Paramètres :

Nom	Type	Obligatoire	Description
boardId	string (UUID)	Oui	ID du board
name	string	Oui	Nom du sprint
startDate	string	Non	Date de début au format ISO 8601
endDate	string	Non	Date de fin au format ISO 8601

Exemple :

{
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef",
  "name": "Sprint 13",
  "startDate": "2025-02-24",
  "endDate": "2025-03-10"
}

---

close_sprint

Clôture un sprint ouvert. Archive tous les work items dans les colonnes "done" et les enregistre comme work items du sprint. Filtre éventuellement par plage de dates. Lors de la clôture, un rapport visuel et un changelog sont générés automatiquement.

Paramètres :

Nom	Type	Obligatoire	Description
sprintId	string (UUID)	Oui	ID du sprint à clôturer
boardId	string (UUID)	Oui	ID du board du sprint
startDate	string	Non	Date de début ISO 8601 pour filtrer les items par finishedAt >= startDate
endDate	string	Non	Date de fin ISO 8601 pour filtrer les items par finishedAt <= endDate

Exemple :

{
  "sprintId": "sprint-001",
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}

---

close_sprint_adhoc

Crée et clôture un sprint en une seule transaction. Utile pour enregistrer rétrospectivement un sprint déjà terminé. Filtre éventuellement les items par plage de dates.

Paramètres :

Nom	Type	Obligatoire	Description
boardId	string (UUID)	Oui	ID du board
name	string	Oui	Nom du sprint
startDate	string	Non	Date de début ISO 8601 pour filtrer les items
endDate	string	Non	Date de fin ISO 8601 pour filtrer les items

Exemple :

{
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef",
  "name": "Sprint 10 (retroactivo)",
  "startDate": "2025-01-13",
  "endDate": "2025-01-26"
}

---

close_sprint_by_date

Crée et clôture un sprint avec des dates de début et de fin explicites en une seule transaction. Archive tous les work items actuellement dans les colonnes "done". Les dates de début et de fin sont obligatoires.

Paramètres :

Nom	Type	Obligatoire	Description
boardId	string (UUID)	Oui	ID du board
name	string	Oui	Nom du sprint
startDate	string	Oui	Date de début ISO 8601 (ex. : 2025-01-01)
endDate	string	Oui	Date de fin ISO 8601 (ex. : 2025-01-14)

Exemple :

{
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef",
  "name": "Sprint 9",
  "startDate": "2025-01-01",
  "endDate": "2025-01-14"
}

---

get_sprint_work_items

Liste tous les work items terminés et archivés dans un sprint spécifié.

Paramètres :

Nom	Type	Obligatoire	Description
sprintId	string (UUID)	Oui	ID du sprint

Exemple :

{
  "sprintId": "sprint-000"
}

---

preview_done_items

Prévisualise les work items dans les colonnes "done" qui seraient archivés lors de la clôture d'un sprint. Utile pour vérifier avant d'exécuter close_sprint.

Paramètres :

Nom	Type	Obligatoire	Description
boardId	string (UUID)	Oui	ID du board

Exemple :

{
  "boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}

Réponse :

[
  {
    "id": "wi-001",
    "taskId": "A-T-37",
    "title": "Implementar login",
    "type": "task",
    "columnName": "Done",
    "finishedAt": "2025-02-20T15:30:00.000Z"
  },
  {
    "id": "wi-002",
    "taskId": "A-T-38",
    "title": "Tests de integracion auth",
    "type": "task",
    "columnName": "Done",
    "finishedAt": "2025-02-21T10:00:00.000Z"
  }
]

Flux recommandé

Avant de clôturer un sprint, exécutez preview_done_items pour vérifier que les bons items vont être archivés. Exécutez ensuite close_sprint ou close_sprint_adhoc.

---

regenerate_sprint_changelog

Régénère le document de changelog pour un sprint clôturé. Utile pour régénérer après des améliorations des prompts ou pour des sprints anciens qui n'ont pas de changelog.

Paramètres :

Nom	Type	Obligatoire	Description
sprintId	string (UUID)	Oui	ID du sprint (doit être clôturé)
fallbackStrategy	string	Non	Stratégie pour les items sans documentation IA : list-only (par défaut, liste sans résumé), ai-analyze (génère des résumés IA à la volée), skip (omet les items sans documentation)

Exemple :

{
  "sprintId": "sprint-000",
  "fallbackStrategy": "ai-analyze"
}

Réponse :

{
  "message": "Changelog generated successfully for sprint 'Sprint 11'",
  "documentId": "doc-uuid-001"
}