ComposioHQ/Shortcut-Automation

Shortcut Automation

Automatisieren Sie Ihre Shortcut-Projektmanagement-Operationen direkt aus Claude Code. Erstellen und listen Sie Stories auf, fügen Sie Aufgaben und Kommentare hinzu, erstellen Sie Stories im Batch und navigieren Sie durch Workflows – alles ohne Ihr Terminal zu verlassen.

Toolkit-Dokumentation: composio.dev/toolkits/shortcut

---

Einrichtung

1. Fügen Sie den Rube MCP-Server mit der URL https://rube.app/mcp zu Ihrer Claude Code-Konfiguration hinzu.
2. Authentifizieren Sie Ihr Shortcut-Konto über den bereitgestellten Verbindungslink, wenn Sie dazu aufgefordert werden.
3. Beginnen Sie, Ihre Projektmanagement-Workflows mit natürlicher Sprache zu automatisieren.

---

Kern-Workflows

1. Stories erstellen

Fügen Sie neue Stories zu Ihrem Shortcut-Arbeitsbereich mit vollständiger Konfiguration hinzu.

Tool: SHORTCUT_CREATE_STORY

Erstelle eine Feature-Story mit dem Namen „Dark Mode Support hinzufügen" im Workflow-Status 500000001 mit einer Schätzung von 5 und dem Label „frontend"

Wichtige Parameter für SHORTCUT_CREATE_STORY:

• name (erforderlich) – der Story-Titel
• workflow_state_id – der Workflow-Status, in dem die Story platziert werden soll (empfohlen gegenüber project_id)
• story_type – "feature", "bug" oder "chore"
• description – Story-Text/Beschreibung
• estimate – numerischer Punkte-Schätzwert (oder null für ungeschätzt)
• epic_id – Verknüpfung mit einem Epic
• iteration_id – Verknüpfung mit einer Iteration
• labels – Array von Label-Objekten mit name (und optional color, description)
• owner_ids – Array von Mitglieds-UUIDs zur Zuweisung
• deadline – Fälligkeitsdatum im ISO-8601-Format
• tasks – Inline-Aufgaben-Array mit description und optional complete, owner_ids
• comments – Inline-Kommentar-Array mit text
• story_links – Verknüpfung von Stories mit verb ("blocks", "duplicates", "relates to")

Wichtig: Es muss entweder workflow_state_id oder project_id angegeben werden, aber nicht beide. workflow_state_id wird empfohlen, da Projekte in Shortcut auslaufen.

2. Stories im Batch erstellen

Erstellen Sie mehrere Stories in einem einzigen API-Aufruf.

Tool: SHORTCUT_CREATE_MULTIPLE_STORIES

Erstelle 3 Bug-Stories: „Login-Seite 500-Fehler", „Probleme mit der Warenkorb-Summenrundung" und „Suche zeigt leeren Zustand"

• Erfordert ein stories-Array, bei dem jedes Element dem gleichen Schema wie SHORTCUT_CREATE_STORY folgt.
• Jede Story im Array benötigt name.
• Effizient für Bulk-Importe, Sprint-Planung oder template-basierte Story-Erstellung.

3. Stories in einem Projekt auflisten

Rufen Sie alle Stories innerhalb eines bestimmten Projekts ab.

Tool: SHORTCUT_LIST_STORIES

Liste alle Stories in Projekt 42 mit ihren Beschreibungen auf

• Erfordert project__public__id (ganzzahlige Projekt-ID).
• Optional includes_description: true, um Story-Beschreibungen in die Antwort aufzunehmen.
• Gibt alle Stories mit ihren Attributen zurück (Status, Typ, Schätzwert usw.).

4. Story-Aufgaben verwalten

Erstellen Sie Aufgaben (Checklisten) in Stories zur Nachverfolgung von Unteraufgaben.

Tool: SHORTCUT_CREATE_TASK

Füge eine Aufgabe „Unit-Tests für Dark Mode Toggle schreiben" zu Story 12345 hinzu

Wichtige Parameter:

• story__public__id (erforderlich) – die übergeordnete Story-ID
• description (erforderlich) – die Aufgabenbeschreibung
• complete – boolesch, standardmäßig false
• owner_ids – Array von Mitglieds-UUIDs zur Zuweisung der Aufgabe
• external_id – ID aus einem externen Tool, falls importiert

5. Story-Kommentare hinzufügen

Posten Sie Kommentare zu Stories für Diskussion und Dokumentation.

Tool: SHORTCUT_CREATE_STORY_COMMENT

Füge einen Kommentar zu Story 12345 hinzu: „Implementierung überprüft – sieht gut aus, aber benötigt Accessibility-Tests"

Wichtige Parameter:

• story__public__id (erforderlich) – die Story-ID
• text (erforderlich) – der Kommentartext
• author_id – Mitglieds-UUID (standardmäßig der API-Token-Inhaber)
• parent_id – ID des übergeordneten Kommentars für Thread-Antworten

6. Workflow- und Projekt-Erkundung

Listen Sie Workflows und Projekte auf, um IDs für die Story-Erstellung zu ermitteln.

Tools: SHORTCUT_LIST_WORKFLOWS, SHORTCUT_LIST_PROJECTS

Zeige mir alle Workflows in unserem Shortcut-Arbeitsbereich, damit ich die richtige Workflow-Status-ID finde

• SHORTCUT_LIST_WORKFLOWS gibt alle Workflows mit ihren Status zurück (IDs, Namen, Typen).
• SHORTCUT_LIST_PROJECTS gibt alle Projekte mit ihren Attributen zurück.
• Verwenden Sie diese, um gültige workflow_state_id- und project_id-Werte zu ermitteln, bevor Sie Stories erstellen.

---

Bekannte Fallstricke

• workflow_state_id vs. project_id: SHORTCUT_CREATE_STORY benötigt genau einen dieser Werte. Die Angabe beider oder keiner führt zur Ablehnung. Bevorzugen Sie workflow_state_id, da Projekte auslaufen.
• Projekte laufen aus: Shortcut stellt Projekte zugunsten einer workflow-basierten Organisation ein. Verwenden Sie workflow_state_id für neue Stories.
• Label-Erstellung erfolgt inline: Labels im labels-Array werden bei Bedarf spontan erstellt, falls sie nicht existieren. Das Feld name ist für jedes Label-Objekt erforderlich.
• Standard-Story-Typ: Wenn story_type weggelassen wird, wird standardmäßig "feature" verwendet. Setzen Sie es für Bugs und Chores immer explizit.
• Batch-Limits: SHORTCUT_CREATE_MULTIPLE_STORIES verarbeitet alle Stories in einer einzigen Anfrage. Sehr große Batches können zu Zeitüberschreitungen führen – halten Sie Batches unter 25 Stories.
• Ganzzahlige IDs für Stories/Projekte: Story- und Projekt-IDs sind Ganzzahlen, keine UUIDs. Mitglieds- und Gruppen-IDs sind UUIDs. Das Mischen dieser Formate verursacht Fehler.
• move_to-Positionierung: Das Feld move_to ("first" oder "last") verschiebt die Story innerhalb ihres Workflow-Status, nicht zwischen Status.

---

Kurzreferenz

Tool-Slug	Beschreibung
SHORTCUT_CREATE_STORY	Eine einzelne Story erstellen (erfordert name + workflow_state_id oder project_id)
SHORTCUT_CREATE_MULTIPLE_STORIES	Mehrere Stories im Batch erstellen (erfordert stories-Array)
SHORTCUT_LIST_STORIES	Stories in einem Projekt auflisten (erfordert project__public__id)
SHORTCUT_CREATE_TASK	Eine Aufgabe in einer Story erstellen (erfordert story__public__id, description)
SHORTCUT_CREATE_STORY_COMMENT	Einen Kommentar zu einer Story hinzufügen (erfordert story__public__id, text)
SHORTCUT_CREATE_STORY_FROM_TEMPLATE	Eine Story aus einer Vorlage erstellen
SHORTCUT_LIST_WORKFLOWS	Alle Workflows und ihre Status auflisten
SHORTCUT_LIST_PROJECTS	Alle Projekte auflisten

---

Bereitgestellt von Composio