ComposioHQ/linear

Was macht linear?

Übersicht

Dieser Skill bietet einen strukturierten Workflow für die Verwaltung von Issues, Projekten und Team-Workflows in Linear. Er stellt eine konsistente Integration mit dem Linear MCP-Server sicher, der eine natürlichsprachliche Projektverwaltung für Issues, Projekte, Dokumentation und Teamzusammenarbeit ermöglicht.

Voraussetzungen

• Der Linear MCP-Server muss verbunden und über OAuth zugänglich sein
• Bestätige den Zugriff auf den relevanten Linear-Arbeitsbereich, Teams und Projekte

Erforderlicher Workflow

Befolge diese Schritte in der angegebenen Reihenfolge. Überspringe keine Schritte.

Schritt 0: Linear MCP einrichten (falls noch nicht konfiguriert)

Wenn ein MCP-Aufruf fehlschlägt, weil Linear MCP nicht verbunden ist, pausiere und richte es ein:

1. Füge das Linear MCP hinzu:
   • codex mcp add linear --url https://mcp.linear.app/mcp
2. Aktiviere den entfernten MCP-Client:
   • Setze [features] rmcp_client = true in config.toml oder führe codex --enable rmcp_client aus
3. Melde dich mit OAuth an:
   • codex mcp login linear

Nach erfolgreichem Login muss der Benutzer Codex neu starten. Du solltest deine Antwort beenden und ihnen mitteilen, dass sie beim nächsten Versuch mit Schritt 1 fortfahren können.

Hinweis für Windows/WSL: Wenn unter Windows Verbindungsfehler auftreten, versuche, das Linear MCP über WSL zu konfigurieren:

{"mcpServers": {"linear": {"command": "wsl", "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]}}}

Schritt 1

Kläre das Ziel und den Umfang des Benutzers (z.B. Issue-Triage, Sprintplanung, Dokumentationsaudit, Arbeitsauslastung). Bestätige nach Bedarf Team/Projekt, Priorität, Labels, Zyklus und Fälligkeitsdaten.

Schritt 2

Wähle den geeigneten Workflow aus (siehe Praktische Workflows unten) und identifiziere die benötigten Linear MCP-Tools. Bestätige erforderliche Identifikatoren (Issue-ID, Projekt-ID, Team-Schlüssel), bevor du Tools aufrufst.

Schritt 3

Führe Linear MCP-Toolaufrufe in logischen Batches aus:

• Lese zuerst (list/get/search), um Kontext aufzubauen.
• Erstelle oder aktualisiere als Nächstes (Issues, Projekte, Labels, Kommentare) mit allen erforderlichen Feldern.
• Erkläre bei Bulk-Operationen die Gruppierungslogik, bevor du Änderungen vornimmst.

Schritt 4

Fasse Ergebnisse zusammen, weise auf verbleibende Lücken oder Blockaden hin und schlage nächste Aktionen vor (zusätzliche Issues, Labeländerungen, Zuweisungen oder Folgekommentare).

Verfügbare Tools

Issue-Verwaltung: list_issues, get_issue, create_issue, update_issue, list_my_issues, list_issue_statuses, list_issue_labels, create_issue_label

Projekt & Team: list_projects, get_project, create_project, update_project, list_teams, get_team, list_users

Dokumentation & Zusammenarbeit: list_documents, get_document, search_documentation, list_comments, create_comment, list_cycles

Praktische Workflows

• Sprintplanung: Überprüfe offene Issues für ein Zielteam, wähle die wichtigsten nach Priorität aus und erstelle einen neuen Zyklus (z.B. "Q1 Performance Sprint") mit Zuweisungen.
• Bug-Triage: Liste kritische/hochpriorisierte Bugs auf, ordne sie nach Benutzerauswirkung und verschiebe die wichtigsten zu "In Bearbeitung".
• Dokumentationsaudit: Durchsuche die Dokumentation (z.B. API-Auth), öffne dann mit "Dokumentation" gekennzeichnete Issues für Lücken oder veraltete Abschnitte mit detaillierten Korrekturen.
• Team-Arbeitsauslastung ausgleichen: Gruppiere aktive Issues nach Bearbeiter, markiere Personen mit hoher Auslastung und schlage Umverteilungen vor oder wende sie an.
• Release-Planung: Erstelle ein Projekt (z.B. "v2.0 Release") mit Meilensteinen (Feature-Freeze, Beta, Docs, Launch) und generiere Issues mit Schätzungen.
• Projektübergreifende Abhängigkeiten: Finde alle "blockierten" Issues, identifiziere Blocker und erstelle bei Bedarf verknüpfte Issues.
• Automatisierte Statusaktualisierungen: Finde deine Issues mit veralteten Updates und füge Statuskommentare basierend auf dem aktuellen Stand/Blockern hinzu.
• Intelligente Beschriftung: Analysiere unbeschriftete Issues, schlage Labels vor oder wende sie an und erstelle fehlende Labelkategorien.
• Sprint-Retrospektiven: Erstelle einen Bericht für den letzten abgeschlossenen Zyklus, notiere abgeschlossene vs. verschobene Arbeiten und öffne Diskussions-Issues für Muster.

Tipps für maximale Produktivität

• Batch-Operationen für zusammenhängende Änderungen; erwäge intelligente Vorlagen für wiederkehrende Issue-Strukturen.
• Verwende nach Möglichkeit natürliche Abfragen ("Zeig mir, woran John diese Woche arbeitet").
• Nutze Kontext: Verweise in neuen Anfragen auf frühere Issues.
• Zerlege große Updates in kleinere Batches, um Ratenbegrenzungen zu vermeiden; verwende beim häufigen Auflisten zwischengespeicherte oder wiederverwendete Filter.

Fehlerbehebung

• Authentifizierung: Browser-Cookies löschen, OAuth erneut ausführen, Arbeitsbereichsberechtigungen überprüfen, sicherstellen, dass der API-Zugriff aktiviert ist.
• Fehler beim Tool-Aufruf: Bestätige, dass das Modell mehrere Tool-Aufrufe unterstützt, gib alle erforderlichen Felder an und teile komplexe Anfragen auf.
• Fehlende Daten: Token aktualisieren, Arbeitsbereichszugriff überprüfen, nach archivierten Projekten suchen und korrekte Teamauswahl bestätigen.
• Leistung: Denke an die Linear-API-Ratenbegrenzungen; führe Bulk-Operationen in Batches durch, verwende spezifische Filter oder zwischenspeichere häufige Abfragen.