Todos

Todos sind leichte persönliche Aufgaben, mit denen du schnell Dinge erfassen kannst, die kein vollständiges Work Item benötigen. Während Work Items für strukturierte Arbeit innerhalb von Boards mit Kanban-Workflows ausgelegt sind, bieten Todos eine agilere Möglichkeit, persönliche Aufgaben und Erinnerungen zu verwalten.

Unterschied zu Work Items

Aspekt	Todos	Work Items
Zweck	Schnelles Erfassen persönlicher Aufgaben	Strukturierte Teamarbeit
Ort	Persönliche Liste, optional einem Projekt zugeordnet	Spalten eines Boards
Status	Direktes Feld (pending, in_progress, done, blocked)	Aus der Board-Spalte abgeleitet
Hierarchie	Keine Hierarchie	Epic > Feature > Story > Task
Zuweisungen	Ein einzelner Eigentümer	Mehrere Zugewiesene mit Rollen
Planung	Keine Sprints	Sprints zugeordnet

Wann du welches verwendest

• Todo: "Juans E-Mail prüfen", "Lieferanten anrufen", "Bibliothek X untersuchen".
• Work Item: "Authentifizierungsendpunkt implementieren", "Login-Bildschirm entwerfen".

Status

Todos haben ein explizites Statusfeld mit vier möglichen Werten:

Status	Beschreibung
pending	Ausstehend, noch nicht begonnen
in_progress	In Bearbeitung
done	Abgeschlossen
blocked	Aus irgendeinem Grund blockiert

Wenn du ein Todo als done markierst, erfasst das System automatisch das Abschlussdatum in completedAt.

Priorität

Wie Work Items unterstützen Todos Prioritätsstufen:

Priorität	Empfohlene Verwendung
urgent	Erfordert sofortige Aufmerksamkeit
high	Wichtig, sollte bald erledigt werden
medium	Normale Priorität
low	Kann warten, nicht dringend

Todo erstellen

Es gibt mehrere Möglichkeiten, ein Todo zu erstellen:

1. Über die Todos-Seite -- Öffne /todos und nutze die Schaltfläche zum Erstellen eines neuen Todos.
2. Über MCP -- Verwende das Tool create_todo_item, um Todos programmatisch zu erstellen.

Felder beim Erstellen

Feld	Typ	Beschreibung	Erforderlich
title	string	Aussagekräftiger Titel des Todos	Ja
description	string	Zusätzliche Beschreibung, akzeptiert Markdown	Nein
priority	enum	Priorität: urgent, high, medium, low	Nein
projectId	uuid	Zugehöriges Projekt (optional)	Nein
dueDate	date	Fälligkeitsdatum	Nein
ownerUserId	uuid	Eigentümer des Todos	Nein
metadata	object	Zusätzliche Metadaten	Nein

Globale vs. projektzugeordnete Todos

Todos können auf zwei Arten existieren:

• Global (ohne Projekt): Persönliche Aufgaben, die zu keinem bestimmten Projekt gehören. Sie erscheinen in der allgemeinen Todo-Ansicht.
• Projektzugeordnet: Aufgaben, die mit einem Projekt verknüpft sind. Sie erscheinen sowohl in der allgemeinen Ansicht als auch nach Projekt gefiltert.

So kannst du Todos für allgemeine persönliche Aufgaben und für Erinnerungen zu einem bestimmten Projekt verwenden, ohne ein formelles Work Item erstellen zu müssen.

Kommentare

Todos unterstützen Kommentare zum Hinzufügen von Notizen oder Updates:

• Füge Kommentare in der Detailansicht des Todos hinzu.
• Kommentare können mit dem MCP-Tool list_todo_comments aufgelistet werden.
• Der Kommentarzähler (commentCount) ist in der Listenansicht verfügbar.

Operationen

Status ändern

Du kannst den Status eines Todos auf verschiedene Arten ändern:

• Über die Oberfläche -- Verwende die Status-Steuerelemente in der Listen- oder Detailansicht.
• Über MCP -- Verwende das Tool set_todo_item_status, um den Status programmatisch zu ändern.

Fälligkeitsdatum festlegen

• Über die Oberfläche -- Bearbeite das Datumsfeld in der Todo-Detailansicht.
• Über MCP -- Verwende das Tool set_todo_item_due_date.

Eigentümer zuweisen

Standardmäßig ist der Ersteller des Todos sein Eigentümer. Du kannst ein Todo einem anderen Benutzer zuweisen:

• Über die Oberfläche -- Wähle den neuen Eigentümer in der Todo-Detailansicht.
• Über MCP -- Verwende das Tool assign_todo_item_owner.

Löschen

Im Unterschied zu Work Items, die archiviert werden, können Todos dauerhaft gelöscht werden, wenn sie nicht mehr benötigt werden.

Für Entwickler

Für Entwickler

MCP-Tools

Grundlegende Verwaltung

Tool	Beschreibung	Wichtigste Parameter
create_todo_item	Erstellt ein neues Todo	title, description, priority, projectId, dueDate, ownerUserId
get_todo_item	Ruft die Details eines Todos ab	todoItemId
list_todo_items	Listet Todos mit Filtern auf	projectId, status, priority, ownerUserId
update_todo_item	Aktualisiert Felder eines Todos	todoItemId, zu aktualisierende Felder
delete_todo_item	Löscht ein Todo	todoItemId

Spezifische Operationen

Tool	Beschreibung	Wichtigste Parameter
set_todo_item_status	Ändert den Status eines Todos	todoItemId, status
set_todo_item_due_date	Legt das Fälligkeitsdatum fest oder ändert es	todoItemId, dueDate
assign_todo_item_owner	Weist dem Todo einen neuen Eigentümer zu	todoItemId, ownerUserId

Kommentare

Tool	Beschreibung	Wichtigste Parameter
add_todo_comment	Fügt einem Todo einen Kommentar hinzu	todoItemId, content
list_todo_comments	Listet die Kommentare eines Todos auf	todoItemId

Beispiel: Todo erstellen

Tool: create_todo_item
Parameter:
  title: "Kundenvorschlag prüfen"
  description: "Den per E-Mail gesendeten Vorschlag lesen und beantworten"
  priority: "high"
  dueDate: "2026-03-25"

Beispiel: Als abgeschlossen markieren

Tool: set_todo_item_status
Parameter:
  todoItemId: "uuid-del-todo"
  status: "done"

Beispiel: Ausstehende Todos eines Projekts auflisten

Tool: list_todo_items
Parameter:
  projectId: "uuid-del-proyecto"
  status: "pending"

Beispiel: Kommentar hinzufügen

Tool: add_todo_comment
Parameter:
  todoItemId: "uuid-del-todo"
  content: "Der Kunde hat bestätigt, dass er morgen eine überarbeitete Version senden wird"