MCP-Tools: Sprints

Sechs Werkzeuge für Sprints. Ein Sprint ist ein Zeitfenster einer Serie; die Serie gibt den Takt vor, die Sprints sind ihre nummerierten Wiederholungen.

Tool	Rolle	Zweck
list_sprint_series	user	Serien, in denen der Aufrufer Mitglied ist
list_sprints	user	Sprints einer Serie rund um den laufenden
get_sprint	user	Ein Sprint: Name, Ziel, Zeitraum, Status
list_sprint_items	user	Die Aufgaben in einem Sprint
add_item_to_sprint	user	Eine Aufgabe zuordnen
remove_item_from_sprint	user	Eine Aufgabe herausnehmen

Wie ein Sprint adressiert wird

Überall dort, wo sprint steht, sind zwei Formen erlaubt:

• der Schlüssel "17.7" – Seriennummer und laufende Nummer
• die symbolischen Werte "current", "next", "previous" (Vorgabe: "current")

series akzeptiert UUID, Seriennummer oder Name. Nötig ist der Parameter nur bei den symbolischen Werten, und auch dort nur, wenn es mehr als eine Serie gibt.

Nicht materialisierte Sprints sind trotzdem echt

list_sprints liefert Fenster, in denen noch nie eine Aufgabe lag, mit materialized: false. Sie existieren als Zeitraum und lassen sich ansprechen – sie haben nur noch keine Zeile in der Datenbank. Während eines Cooldowns ist running null; das heißt „gerade kein Sprint", nicht „Fehler".

list_sprint_items

Parameter	Typ	Beschreibung
sprint	string	Schlüssel oder current/next/previous
series	string	UUID, Nummer oder Name
assignees	string[] (max 50)	Nur Aufgaben mit mindestens einem dieser Zuständigen (ODER)

Die Antwort enthält neben den Zeilen ein Feld hidden: die Anzahl der Aufgaben im Sprint, die in Listen liegen, auf die der Aufrufer keinen Zugriff hat. Mitgliedschaft in einer Serie gibt keinen Zugriff auf Aufgaben — dieses Feld erklärt, warum eine Zählung nicht zum Board passt.

add_item_to_sprint

Parameter	Typ	Beschreibung
item	string (erforderlich)	Item-ID (UUID)
sprint	string	Schlüssel oder current/next/previous
series	string	UUID, Nummer oder Name

Der einzige Weg, einen Sprint zu setzen

create_list_item und update_list_item haben kein Sprint-Feld, und eine Unteraufgabe erbt den Sprint ihrer Hauptaufgabe nicht. Wer einen Sprint zuordnen will, muss dieses Werkzeug benutzen.

Das Zuordnen ist idempotent und ersetzt einen früheren Sprint derselben Serie – eine Aufgabe kann nicht in zwei Sprints eines Takts liegen. Sprints anderer Serien bleiben unberührt. In einen abgeschlossenen Sprint lässt sich nichts mehr legen.

remove_item_from_sprint nimmt die Aufgabe nur aus dem Takt; sie bleibt bestehen, behält ihren Status und liegt wieder im Backlog.