Linear Project Tracker

## Für Wen Ist Dies

Entwickler und Projektleiter, die Linear zur Verwaltung von Sprints, Issues und Meilensteinen verwenden. Dieses Plugin ermöglicht es Ihnen, Tickets zu erstellen, Projekt-Meilensteine zu aktualisieren, Bulk-Automationen auszuführen und Team-Workflows zu verfolgen — alles aus einer Chat-Nachricht heraus, ohne die Linear-App zu öffnen.

## 3-Schrittiger Quickstart

1. **Ein Issue erstellen** — fragen Sie: `"Use 0xsero-linear to create a bug ticket in project Mobile App: 'Login button unresponsive on iOS 17', priority High, assign to @alice"`. Das Skill ruft die Linear GraphQL API auf und gibt die neue Issue-ID und URL zurück.
2. **Meilensteine aktualisieren** — fragen Sie: `"Use bind-linear-milestones-write to add a milestone 'Beta Release v2.0' to project Mobile App, due 2026-03-31"`. Sie erhalten eine Bestätigung mit der Meilenstein-ID.
3. **Bulk-Updates automatisieren** — fragen Sie: `"Use sickn33-linear-automation to move all issues labeled 'blocked' in the current cycle to the next cycle"`. Die Automation wird über das Composio Linear Toolkit ausgeführt und meldet, wie viele Issues verschoben wurden.

## Schritt → Skill → Eingabe → Ausgabe

| Schritt | Skill | Was Sie bereitstellen | Was Sie erhalten |
|------|-------|------------------|--------------|
| Issues erstellen / aktualisieren | 0xsero-linear | Projektname + Issue-Details | Issue-URL + ID |
| CLI Issue-Verwaltung | 0xbigboss-linear | Team / Projekt + Aktion | Issue-Liste oder Aktionsbestätigung |
| Tickets lesen & schreiben | davila7-linear | Ticket-ID oder Suchanfrage | Ticket-Details oder aktualisiertes Ticket |
| Meilensteine erstellen | bind-linear-milestones-write | Projekt + Meilensteinname + Fälligkeitsdatum | Meilenstein-ID + Bestätigung |
| Bulk-Automation | sickn33-linear-automation | Filterkriterien + Aktion | Anzahl der aktualisierten Issues |

## Häufige Fehler & Lösungen

- **0xsero-linear gibt "project not found" zurück** → Projektnamen sind in Linear groß-/kleinschreibsensitiv. Kopieren Sie den exakten Namen aus Ihrer Linear Workspace-Seitenleiste.
- **bind-linear-milestones-write schlägt fehl mit "permission denied"** → Meilensteine erfordern Editor-Zugriff. Stellen Sie sicher, dass Ihr Linear API-Schreibberechtigungen hat.
- **sickn33-linear-automation verschiebt 0 Issues** → Überprüfen Sie, ob Ihr Filter mit existierenden Issues übereinstimmt. Versuchen Sie zuerst eine einfachere Abfrage: `"list all blocked issues in current cycle"`.

## Erfolgskriterien

Sie wissen, dass es funktioniert hat, wenn:
- 0xsero-linear oder davila7-linear einen `linear.app`-Link zum erstellten/aktualisierten Issue zurückgibt
- bind-linear-milestones-write den Meilenstein mit einer ID bestätigt
- sickn33-linear-automation die Anzahl der verarbeiteten Issues meldet (auch wenn 0 — das bedeutet, der Filter hat nichts gefunden, kein Fehler)