Ticket Fetcher
Nur Abruf – keine Analyse, Anforderungen oder Planung. Die Ausgabe ist eine eigenständige .TICKET.md.
Quelle & Zugriff
Identifiziere den Tracker anhand der Eingabe (URL-Host oder ID-Form) und rufe das passende MCP ab – z.B. Azure DevOps MCP für ADO-Workitems, Atlassian MCP für Jira-Issues, GitHub MCP / gh für GitHub-Issues. Verwende die jeweils angeschlossenen äquivalenten Tools; die Toolnamen-Präfixe variieren je nach Konfiguration. Erkenne einmalig alle benötigten Daten (z.B. Atlassian cloudId, ADO Projekt) und verwende sie erneut. Falls die Eingabe mehrdeutig ist, frage den Benutzer – rate nicht. Wenn kein passendes MCP verbunden ist: Ein öffentliches Ticket kann ggf. über seine URL gescrapt werden (du kannst trotzdem vorschlagen, das passende MCP zu installieren, wenn es die bessere Lösung wäre); ein privates Ticket kann nicht gescrapt werden – die URL liefert nur eine Login-Seite, nicht das Ticket – also brich ab und sage dem Benutzer, er solle das passende MCP installieren und authentifizieren, dann erneut ausführen.
Deine Aufgabe
- Eingabe auflösen. Akzeptiere eine vollständige Ticket-URL oder eine nackte ID; extrahiere die Kennung. Wenn der Tracker ein Schlüsselpräfix verwendet (z.B.
XX-1234), behalte es; ansonsten verwende die nackte Nummer. Falls die Eingabe nicht erkennbar ist, frage nach. - Ticket abrufen. Hole das Workitem/Issue mit seinem vollständigen Feldsatz, Inline-Kommentaren und erweiterten Relationen/Links ab. Erfasse alles, was das Ticket enthält – filtere nicht auf einen festen Satz von Feldern vor. Konvertiere das erhaltene Rich-Text-Format (HTML, ADF, …) in sauberes Markdown.
- Slug wählen. Kurzer Kebab-Case-Slug, 3–5 Wörter, aus dem Titel/der Zusammenfassung – grep-fähig, nicht zu viel nachdenken.
- Ausgabeverzeichnis festlegen. Ein Projekt-relatives
<id>-<slug>/-Unterverzeichnis innerhalb des Planungsverzeichnisses des Projekts (z.B..claude/plans/) – folge der Konvention des Projekts/Benutzers, wo Pläne abgelegt werden; falls nichts definiert ist, frage den Benutzer. Rate niemals. Falls es bereits existiert, schlage<id>-<slug>-v2,-v3usw. vor – überschreibe niemals ein bestehendes Planungsverzeichnis; der Verlauf pro erneutem Abruf wird absichtlich beibehalten. - Ticket-Datei schreiben unter
<output-dir>/<id>-<slug>.TICKET.md. - Anhänge herunterladen in das Ausgabeverzeichnis; warne bei fehlgeschlagenen (siehe Anhänge).
- Ergebnis ausgeben – Projekt-relative Pfade und die nächste Zeile (siehe Nächster Schritt).
Aufbau der Ticket-Datei
Muss eigenständig sein: eine vollständige, lesbare Version des Tickets mit ausreichend Metadaten, sodass eine neue Sitzung die Quelle ohne erneuten Abruf identifizieren kann.
Kopfzeile
Plain-Markdown-Kopf mit Quell-Metadaten; lasse jede Zeile weg, deren Wert fehlt. Nimm alles auf, was der Tracker bereitstellt. Beispiel:
# <Titel / Zusammenfassung>
> **Quelle** [<ID>](<URL>)
> **Typ** {typ}
> **Status** {status}
> **Zugewiesen an** {Anzeigename oder „—“}
> **Ersteller** {Anzeigename}
> **Labels / Tags** {verbunden oder „—“}
> **Abgerufen am** {heute YYYY-MM-DD}
Abschnitte des Rumpfs
In dieser Reihenfolge ausgeben, nur wenn vorhanden und nicht leer:
## Beschreibung## Akzeptanzkriterien– wenn der Tracker ein dediziertes AC-Feld befüllt hat## <Andere Felder>– ein Abschnitt pro anderem befüllten Feld mit echtem Inhalt (technische Notizen, benutzerdefinierte Felder, …), mit dem Anzeigenamen des Feldes als Überschrift. Erfasse alles, was das Ticket enthält.## Kommentare– älteste zuerst, jedes### <Autor> — <Datum>dann der Text. Nach bestem Wissen: Wenn Kommentare nicht zurückgegeben werden, notiere es kurz oder lasse den Abschnitt weg.## Verwandte Tickets– siehe unten## Anhänge– siehe unten## Design-Referenzen– siehe unten
Behalte die Überschriftenhierarchie, Aufzählungsstruktur, Hervorhebungen und Codeblöcke bei; ordne untergeordnete Überschriften im Feld #### zu. Leere Abschnitte weglassen. Zitiere benutzernahe Zeichenfolgen, Code-Identifikatoren, Dateipfade, i18n-Schlüssel und URLs wortgetreu – ändere oder übersetze sie niemals.
Verwandte Tickets
Aus den Links/Relationen der Antwort (und etwaigen Remote-Link-Tools) für jedes eindeutig verlinkte Ticket (außer diesem) hole nur Titel + Status + Typ über einen günstigen Aufruf ab – nicht den vollständigen Text. Das Hauptziel ist, eine Spur aller verwandten Tickets zu haben, damit sie bei Bedarf später abgerufen werden können. Ein Aufzählungspunkt pro Ticket, mit der Beziehung falls verfügbar:
- [<ID>](<URL>) — (<Typ>, <Status>) <Titel>
Für Nicht-Ticket-Remote-Links (z.B. eine Wiki-/Confluence-Seite) gib den Titel und die URL als einfachen Aufzählungspunkt aus. Wenn ein Abruf fehlschlägt, liste den Link mit (konnte nicht abgerufen werden) auf, anstatt den gesamten Lauf fehlschlagen zu lassen.
Anhänge
Identifiziere jeden Anhang und jedes Inline-Bild, auf das in der Beschreibung/den Feldern verwiesen wird, nummeriert als attachment-<N>.<ext> in der Reihenfolge des ersten Auftretens, unter Beibehaltung der ursprünglichen Erweiterung. <N> läuft über beide kombiniert.
Versuche immer abzurufen – über jeden verbundenen MCP. Über tracker-gehostete Anhänge hinaus kann das Ticket auf externe Ressourcen verlinken (z.B. eine Confluence/ADO-Ressource – für Design-Tool-Links wie Figma oder Zeplin siehe Design-Referenzen unten), die über ihren eigenen MCP erreichbar sind, einschließlich Spezifikations-/Dokumentationsdateien in einem verknüpften Git-Repository (hole deren Inhalt über Git oder den Repo-MCP ab, speichere im Ausgabeverzeichnis unter ihrem eigenen Dateinamen). Verwende den MCP, der zur Quelle passt, um sie herunterzuladen; erkläre nicht vorab einen Link als nicht abrufbar. Wenn ein passender MCP verbunden ist, aber nicht authentifiziert, überspringe ihn nicht stillschweigend – führe proaktiv seinen Authentifizierungsablauf aus (zeige die Login-URL, schließe den Handshake ab), ohne darauf zu warten, gefragt zu werden, und rufe dann ab. Wenn unklar ist, ob ein Asset heruntergeladen werden kann oder sollte, frage den Benutzer.
Lade jedes direkt auf die Festplatte herunter – curl -fSL <URL> -o attachment-<N>.<ext>, oder die Save-to-Path-Variante des MCP-Anhang-Tools. Leite niemals einen Anhang als Inline-Base64 durch das Modell und gib ihn erneut aus: Die Ausgabebegrenzung (~100k Zeichen) kürzt ihn stillschweigend – gültiger Header, fehlender Abschluss, wird nicht geöffnet. Einige MCP-Anhang-Tools geben nur Base64 ohne Save-to-Path-Option zurück (z.B. ADO wit_get_work_item_attachment) – verwende sie nicht für Binärdateien; rufe stattdessen von der REST-API des Trackers direkt auf die Festplatte mit einem Bearer-Token ab (ADO: az account get-access-token --resource 499b84ac-1321-427f-aa17-267ca6975798 --query accessToken -o tsv, dann curl -H "Authorization: Bearer <token>" "<attachmentUrl>" -o attachment-<N>.<ext>). (Inhalts-URLs teilen oft die Authentifizierung des MCP; bei 401 wiederhole mit dem Bearer-Token des Trackers, falls erhältlich.)
Überprüfe Integrität, nicht nur Übertragung – nicht leer; stimmt mit Content-Length überein, falls gesendet; Typ-Abschluss vorhanden (PNG IEND, JPEG FFD9, PDF %%EOF). Eine Größe, die ein exaktes Vielfaches von 3 nahe einer runden Zeichengrenze ist, signalisiert Base64-Kürzung. Bei Fehler lade erneut auf die Festplatte herunter; falls immer noch fehlerhaft, behandle als nicht heruntergeladen und warne – verweise niemals auf eine korrupte Datei. Dann, pro Datei:
- Heruntergeladen → verweise auf die lokale Datei.
- Nicht heruntergeladen (kein passender MCP/Anhang-Tool, nicht abschließbare Authentifizierung usw.) → verweise trotzdem auf die lokale Datei und die Quell-URL, und füge sie zur Warnliste hinzu. Blockiere nicht – das Ticket ist so oder so nutzbar.
Bild → einbetten; Nicht-Bild (PDF, .docx, …) → stattdessen verlinken:
### Anhang 1

_Originaldateiname: image.png_
### Anhang 2
[attachment-2.pdf](attachment-2.pdf) — _Originaldateiname: design-spec.pdf_
Für eine Datei, die nicht heruntergeladen werden konnte, hänge ihre Quelle an, damit der Benutzer sie manuell abrufen kann: — nicht heruntergeladen; von <URL> holen und hier als attachment-<N>.<ext> speichern.
Design-Referenzen
Für Design-Tool-Links (Figma, Zeplin, Sketch, Adobe XD, …) in der Beschreibung/Kommentaren, nummeriere sie nicht als attachment-<N> – es sind lebende Referenzen, keine angehängten Dateien. Erfasse jeden referenzierten Frame/Bildschirm über den MCP dieses Tools (z.B. Figma MCP get_screenshot), lade die zurückgegebene kurzlebige URL direkt auf die Festplatte herunter als <tool>-<id>-<slug>.png (authentifiziere zuerst den MCP, falls nötig – siehe Anhänge). Wenn kein MCP für dieses Tool verbunden ist, notiere den Eintrag trotzdem mit seinem Namen und der Quell-URL und füge ihn zur Warnliste hinzu – genau wie einen nicht heruntergeladenen Anhang. Nimm einen Eintrag pro Link auf, mit der lokalen Vorschau plus den Kennungen, die benötigt werden, um ihn in diesem Tool wieder zu öffnen:
### <Designname>

_Figma · Datei `<fileKey>` · Knoten `<nodeId>` · [Quelle](<URL>)_
Grenzen
- Analysiere, plane oder durchsuche die Codebasis nicht – dies befreit nicht Dateien, die das Ticket explizit verlinkt; diese rufst du trotzdem ab (siehe Anhänge).
- Ändere das Ticket nicht in seinem Tracker – Abrufen ist schreibgeschützt (keine Kommentare, Übergänge, Bearbeitungen, Arbeitsaufzeichnungen).
- Die einzigen Dateien, die du erstellst: die
.TICKET.md, ihre Anhänge und alle verlinkten Dokumente, die du abgerufen hast.
Nächster Schritt
Sage klar Bescheid, wenn fertig, unter Verwendung Projekt-relativer Pfade (niemals absolut): das Ausgabeverzeichnis, die Ticket-Datei und etwaige Anhänge. Wenn ein Anhang nicht heruntergeladen werden konnte, gib zuerst eine klare Warnung aus, die jedes fehlende attachment-<N>.<ext> und seine Quell-URL auflistet, und weise den Benutzer an, es herunterzuladen und unter genau diesem Namen zu speichern, damit die Einbettungen aufgelöst werden. Übergib dann die nächste Phase als einen einzigen kopierbaren Startbefehl – Sitzungsname und Aufforderung kombiniert, sodass ein Einfügen die Sitzung startet. Verwende die Startsyntax des verwendeten Agent-Tools (herstellerneutral – claude unten ist nur das Beispiel), benenne die Sitzung refine-<slug>:
claude --name refine-<slug> "/refine-ticket <output-dir>/<id>-<slug>.TICKET.md"
Biete dann die Alternative an – die aktuelle Sitzung stattdessen löschen (herstellerneutral – /clear unten ist nur das Beispiel; verwende den Löschbefehl des verwendeten Agent-Tools):
ODER /clear und ausführen:
/refine-ticket <output-dir>/<id>-<slug>.TICKET.md

