Zum Hauptinhalt springen
Workflows ermöglichen es Nutzerinnen und Nutzern, eine Abfolge von Schritten zu definieren, um Cascade durch wiederkehrende Aufgaben zu führen, etwa beim Deployment eines Dienstes oder beim Beantworten von PR-Kommentaren. Diese Workflows werden als Markdown-Dateien gespeichert und bieten Nutzerinnen, Nutzern und ihren Teams eine einfache, wiederholbare Möglichkeit, zentrale Prozesse auszuführen. Nach dem Speichern 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 persistenten, wiederverwendbaren Kontext bereitstellen. Workflows erweitern dieses Konzept, indem sie auf Trajektorienebene eine strukturierte Abfolge von Schritten oder Prompts vorgeben und das Modell durch eine Reihe miteinander verknüpfter Aufgaben oder Aktionen führen.
Um einen Workflow auszuführen, rufen Nutzer ihn einfach in Cascade mit dem Befehl /[workflow-name] auf.
Sie können andere Workflows innerhalb eines Workflows aufrufen!

Beispielsweise kann /workflow-1 Anweisungen wie „Rufe /workflow-2 auf“ und „Rufe /workflow-3 auf“ enthalten.
Nach dem Aufruf verarbeitet Cascade jeden im Workflow definierten Schritt der Reihe nach und führt dabei die angegebenen Aktionen aus oder generiert entsprechende Antworten.

​
So erstellen Sie einen Workflow

Um mit Workflows zu beginnen, klicken Sie im Cascade-Slider-Menü oben rechts auf das Symbol Customizations und navigieren Sie anschließend zum Panel Workflows. Dort können Sie auf die Schaltfläche + Workflow klicken, um einen neuen Workflow zu erstellen. Workflows werden als Markdown-Dateien in Verzeichnissen unter .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 aus mehreren Quellen, um eine flexible Organisation zu ermöglichen:
  • Aktueller Workspace und Unterverzeichnisse: Alle .windsurf/workflows/-Verzeichnisse innerhalb Ihres aktuellen Workspace und seiner Unterverzeichnisse
  • Git-Repository-Struktur: Bei 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 den folgenden Orten gespeichert werden:
  • .windsurf/workflows/ im Verzeichnis Ihres aktuellen Workspace
  • .windsurf/workflows/ in einem beliebigen 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 zwingend im Git-Root. Workflow-Dateien sind jeweils auf 12 000 Zeichen begrenzt.

​
Einen Workflow mit Cascade erstellen

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

​
Beispiel-Workflows

Es gibt zahlreiche 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 das Folgende tun. Denke daran, jeweils nur einen Kommentar 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 das, 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 erfordern.

/git-workflows

Committe mit vordefinierten Formaten und erstelle Pull Requests mit standardisiertem Titel und standardisierten Beschreibungen über die entsprechenden CLI-Befehle.

/dependency-management

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

/code-formatting

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

/run-tests-and-fix

Führe Unit- oder End-to-End-Tests aus oder füge sie hinzu und behebe Fehler automatisch, um die Codequalität vor dem Committen, Mergen oder Deployen sicherzustellen.

/deployment

Automatisiere die Schritte zum Deployment deiner Anwendung in verschiedene Umgebungen (Development, Staging, Production), einschließlich erforderlicher Vorabprüfungen und nachgelagerter Verifikationen.

/security-scan

Integriere Sicherheits-Scans auf Schwachstellen in deinem Codebestand und triggere sie im Rahmen der CI/CD-Pipeline oder bei Bedarf.

​
Systemweite Workflows (Enterprise)

Enterprise-Organisationen können systemweite Workflows einrichten, die global in allen Workspaces verfügbar sind und von Endnutzern ohne Administratorrechte nicht geändert werden können. Dies ist ideal, um unternehmensweite Entwicklungsprozesse, Deployment-Verfahren und Compliance-Workflows durchzusetzen. Systemweite Workflows werden aus betriebssystemspezifischen Verzeichnissen geladen: macOS: 
/Library/Application Support/Windsurf/workflows/*.md
Linux/WSL: 
/etc/windsurf/workflows/*.md
Windows: 
C:\ProgramData\Windsurf\workflows\*.md
Legen Sie Ihre Workflow-Dateien (als .md-Dateien) in das entsprechende Verzeichnis für Ihr Betriebssystem. Das System lädt automatisch alle .md-Dateien aus diesen Verzeichnissen.

​
Vorrang von Workflows

Wenn Workflows mit demselben Namen auf mehreren Ebenen existieren, haben System-Workflows die höchste Priorität:
  1. System (höchste Priorität) – unternehmensweite Workflows, die von der IT bereitgestellt werden
  2. Workspace – projektspezifische Workflows in .windsurf/workflows/
  3. Global – benutzerdefinierte Workflows
  4. Built-in – Standard-Workflows, die von Windsurf bereitgestellt werden
Das bedeutet, dass, wenn eine Organisation einen System-Workflow mit einem bestimmten Namen bereitstellt, dieser jeden Workspace-, Global- oder Built-in-Workflow mit demselben Namen überschreibt. In der Cascade UI werden System-Workflows mit einem „System“-Label angezeigt und können von Endbenutzern nicht gelöscht werden.
Wichtig: System-Workflows sollten von Ihrem IT- oder Sicherheitsteam verwaltet werden. Stellen Sie sicher, dass Ihre internen Teams Bereitstellung, Updates und Compliance gemäß den Richtlinien Ihres Unternehmens durchführen. Sie können dafür Standard-Tools und -Workflows wie Mobile Device Management (MDM) oder Configuration Management verwenden.