Tools - Sprints
Sprints stehen für abgegrenzte Arbeitszeiträume innerhalb eines Boards. Beim Schließen eines Sprints werden die abgeschlossenen Work Items archiviert und automatisch ein Changelog sowie ein visueller Bericht erstellt.
list_sprints
Listet alle Sprints eines Boards auf. Der offene Sprint wird zuerst angezeigt, gefolgt von den geschlossenen Sprints, nach Datum sortiert (die neuesten zuerst).
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| boardId | string (UUID) | Ja | ID des Boards |
Beispiel:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}
Antwort:
[
{
"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
Ruft einen Sprint anhand seiner ID ab, einschließlich der Anzahl der Work Items.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| id | string (UUID) | Ja | ID des Sprints |
Beispiel:
{
"id": "sprint-001"
}
get_active_sprint
Ruft den derzeit offenen Sprint eines Boards ab. Gibt null zurück, wenn kein Sprint geöffnet ist.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| boardId | string (UUID) | Ja | ID des Boards |
Beispiel:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}
Antwort:
{
"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
Erstellt einen neuen Sprint in einem Board. Pro Board kann jeweils nur ein Sprint geöffnet sein.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| boardId | string (UUID) | Ja | ID des Boards |
| name | string | Ja | Name des Sprints |
| startDate | string | Nein | Startdatum im Format ISO 8601 |
| endDate | string | Nein | Enddatum im Format ISO 8601 |
Beispiel:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef",
"name": "Sprint 13",
"startDate": "2025-02-24",
"endDate": "2025-03-10"
}
close_sprint
Schließt einen offenen Sprint. Archiviert alle Work Items in Spalten mit dem Status „done“ und erfasst sie als Work Items des Sprints. Optional kann nach Datumsbereich gefiltert werden. Beim Schließen werden automatisch ein visueller Bericht und ein Changelog erstellt.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| sprintId | string (UUID) | Ja | ID des zu schließenden Sprints |
| boardId | string (UUID) | Ja | ID des Sprint-Boards |
| startDate | string | Nein | Startdatum nach ISO 8601, um Elemente nach finishedAt >= startDate zu filtern |
| endDate | string | Nein | Enddatum nach ISO 8601, um Elemente nach finishedAt <= endDate zu filtern |
Beispiel:
{
"sprintId": "sprint-001",
"boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}
close_sprint_adhoc
Erstellt und schließt einen Sprint in einer einzigen Transaktion. Hilfreich, um einen bereits abgeschlossenen Sprint rückwirkend zu erfassen. Optional können Elemente nach Datumsbereich gefiltert werden.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| boardId | string (UUID) | Ja | ID des Boards |
| name | string | Ja | Name des Sprints |
| startDate | string | Nein | Startdatum nach ISO 8601, um Elemente zu filtern |
| endDate | string | Nein | Enddatum nach ISO 8601, um Elemente zu filtern |
Beispiel:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef",
"name": "Sprint 10 (retroactivo)",
"startDate": "2025-01-13",
"endDate": "2025-01-26"
}
close_sprint_by_date
Erstellt und schließt einen Sprint mit explizitem Start- und Enddatum in einer einzigen Transaktion. Archiviert alle Work Items, die sich derzeit in Spalten mit dem Status „done“ befinden. Start- und Enddatum sind erforderlich.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| boardId | string (UUID) | Ja | ID des Boards |
| name | string | Ja | Name des Sprints |
| startDate | string | Ja | Startdatum nach ISO 8601 (z. B. 2025-01-01) |
| endDate | string | Ja | Enddatum nach ISO 8601 (z. B. 2025-01-14) |
Beispiel:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef",
"name": "Sprint 9",
"startDate": "2025-01-01",
"endDate": "2025-01-14"
}
get_sprint_work_items
Listet alle abgeschlossenen und in einem bestimmten Sprint archivierten Work Items auf.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| sprintId | string (UUID) | Ja | ID des Sprints |
Beispiel:
{
"sprintId": "sprint-000"
}
preview_done_items
Zeigt eine Vorschau der Work Items in Spalten mit dem Status „done“, die beim Schließen eines Sprints archiviert würden. Hilfreich für die Prüfung vor dem Ausführen von close_sprint.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| boardId | string (UUID) | Ja | ID des Boards |
Beispiel:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}
Antwort:
[
{
"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"
}
]
Führe vor dem Schließen eines Sprints preview_done_items aus, um zu prüfen, dass die richtigen Elemente archiviert werden. Führe anschließend close_sprint oder close_sprint_adhoc aus.
regenerate_sprint_changelog
Erstellt das Changelog-Dokument für einen geschlossenen Sprint erneut. Hilfreich für die Neuerstellung nach Verbesserungen an den Prompts oder für alte Sprints ohne Changelog.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| sprintId | string (UUID) | Ja | ID des Sprints (muss geschlossen sein) |
| fallbackStrategy | string | Nein | Strategie für Elemente ohne KI-Dokumentation: list-only (Standard, listet ohne Zusammenfassung auf), ai-analyze (erstellt KI-Zusammenfassungen spontan), skip (lässt Elemente ohne Dokumentation aus) |
Beispiel:
{
"sprintId": "sprint-000",
"fallbackStrategy": "ai-analyze"
}
Antwort:
{
"message": "Changelog generated successfully for sprint 'Sprint 11'",
"documentId": "doc-uuid-001"
}