Zum Hauptinhalt springen
Workflows ermöglichen es Benutzerinnen und Benutzern, eine Abfolge von Schritten zu definieren, um Cascade durch wiederkehrende Aufgaben zu führen, etwa das Bereitstellen eines Services oder das Beantworten von PR-Kommentaren. Diese Workflows werden als Markdown-Dateien gespeichert und bieten Teams eine einfache, reproduzierbare Möglichkeit, wichtige Prozesse auszuführen. Sobald sie gespeichert sind, können Workflows in Cascade über einen Slash-Befehl im Format /[name-of-workflow] aufgerufen werden.

​
Funktionsweise

Regeln geben großen Sprachmodellen in der Regel Orientierung, indem sie auf Prompt-Ebene einen persistierenden, wiederverwendbaren Kontext bereitstellen. Workflows erweitern dieses Konzept, indem sie auf Trajektorie-Ebene eine strukturierte Abfolge von Schritten oder Prompts bereitstellen und das Modell durch eine Reihe miteinander verknüpfter Aufgaben oder Aktionen leiten.
Um einen Workflow auszuführen, rufen Nutzer ihn in Cascade einfach mit dem Befehl /[workflow-name] auf.
Sie können aus einem Workflow heraus andere Workflows aufrufen!

Zum Beispiel kann /workflow-1 Anweisungen wie „Rufe /workflow-2 auf“ und „Rufe /workflow-3 auf“ enthalten.
Nach dem Aufruf verarbeitet Cascade nacheinander jeden im Workflow definierten Schritt und führt Aktionen aus oder generiert entsprechend Antworten.

​
So erstellen Sie einen Workflow

Um mit Workflows zu starten, klicken Sie im Schiebemenü oben rechts in Cascade auf das Symbol Customizations und öffnen Sie anschließend das Panel Workflows. Dort können Sie über die Schaltfläche + Workflow einen neuen Workflow anlegen. Workflows werden als Markdown-Dateien in den Verzeichnissen .windsurf/workflows/ gespeichert und enthalten einen Titel, eine Beschreibung sowie eine Abfolge von Schritten mit konkreten Anweisungen, denen Cascade folgen soll.

​
Workflow-Erkennung

Windsurf erkennt Workflows automatisch an mehreren Orten, um eine flexible Organisation zu ermöglichen:
  • Aktueller Workspace und Unterverzeichnisse: Alle Verzeichnisse .windsurf/workflows/ innerhalb Ihres aktuellen Workspace und seiner Unterverzeichnisse
  • Git-Repository-Struktur: In Git-Repositories durchsucht Windsurf zusätzlich bis zum Git-Root-Verzeichnis, um Workflows in übergeordneten Verzeichnissen zu finden
  • Unterstützung mehrerer Workspaces: Sind mehrere Ordner im selben Workspace geöffnet, werden Workflows dedupliziert und mit dem kürzesten relativen Pfad angezeigt

​
Speicherorte für Workflows

Workflows können an folgenden Orten gespeichert werden:
  • .windsurf/workflows/ im Verzeichnis Ihres aktuellen Workspace
  • .windsurf/workflows/ in einem Unterverzeichnis Ihres Workspace
  • .windsurf/workflows/ in übergeordneten Verzeichnissen bis zum Git-Root (für Git-Repositories)
Wenn Sie einen neuen Workflow erstellen, wird er im Verzeichnis .windsurf/workflows/ Ihres aktuellen Workspace gespeichert, nicht unbedingt im Git-Root. Workflow-Dateien sind jeweils auf 12.000 Zeichen begrenzt.

​
Einen Workflow mit Cascade generieren

Sie können Cascade auch bitten, Workflows für Sie zu erzeugen! Das funktioniert besonders gut für Workflows, die eine Reihe von Schritten in einem bestimmten CLI-Tool umfassen.

​
Beispiel-Workflows

Es gibt unzählige Anwendungsfälle für Workflows, zum Beispiel:

/address-pr-comments

Dies ist ein Workflow, den unser Team intern verwendet, um PR-Kommentare zu bearbeiten:
1. Checke den PR-Branch aus: `gh pr checkout [id]`

2. Kommentare zum PR abrufen

 bash
 gh api --paginate repos/[owner]/[repo]/pulls/[id]/comments | jq '.[] | {user: .user.login, body, path, line, original_line, created_at, in_reply_to_id, pull_request_review_id, commit_id}'

3. Für JEDEN Kommentar Folgendes tun. Denke daran, immer nur einen Kommentar auf einmal zu bearbeiten.
 a. Gib Folgendes aus: „(index). Von [user] zu [file]:[lines] — [body]”
 b. Analysiere die Datei und den Zeilenbereich.
 c. Wenn du den Kommentar nicht verstehst, nimm keine Änderung vor. Bitte mich stattdessen um Klarstellung oder darum, es selbst umzusetzen.
 d. Wenn du die Änderung vornehmen kannst, tue dies, BEVOR du zum nächsten Kommentar übergehst.

4. Nachdem alle Kommentare bearbeitet wurden, fasse zusammen, was du getan hast und welche Kommentare die AUFMERKSAMKEIT des USERS benötigen.

/git-workflows

Mit vordefinierten Formaten committen und Pull Requests mit standardisiertem Titel und standardisierten Beschreibungen über die passenden CLI-Befehle erstellen.

/dependency-management

Die Installation oder Aktualisierung von Projektabhängigkeiten auf Basis einer Konfigurationsdatei (z. B. requirements.txt, package.json) automatisieren.

/code-formatting

Code-Formatter (wie Prettier, Black) und Linter (wie ESLint, Flake8) automatisch beim Speichern oder vor dem Commit ausführen, um den Codestil zu wahren und Fehler frühzeitig zu erkennen.

/run-tests-and-fix

Unit- oder End-to-End-Tests ausführen oder hinzufügen und Fehler automatisch beheben, um die Codequalität vor dem Committen, Mergen oder Deployen sicherzustellen.

/deployment

Die Schritte zur Bereitstellung Ihrer Anwendung in verschiedenen Umgebungen (Development, Staging, Production) automatisieren, einschließlich erforderlicher Pre-Deployment-Checks oder Post-Deployment-Verifizierungen.

/security-scan

Sicherheitsscans auf Schwachstellen in Ihrer Codebasis als Teil der CI/CD-Pipeline oder bei Bedarf integrieren und auslösen.