> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflows

> Erstellen Sie wiederverwendbare Cascade-Workflows als Markdown-Dateien, um wiederkehrende Aufgaben wie Deployments, PR-Reviews und Code-Formatierung mit Slash-Befehlen zu automatisieren.

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.

<div id="how-it-works">
  ## Funktionsweise
</div>

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.

<Frame>
  <img style={{ maxHeight: "400px" }} src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/use-workflow-pr.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=753d27e7c9e49d1feca84a2b8272f8e6" width="718" height="510" data-path="assets/windsurf/cascade/use-workflow-pr.png" />
</Frame>

Um einen Workflow auszuführen, rufen Nutzer ihn einfach in Cascade mit dem Befehl `/[workflow-name]` auf.

<Tip>Sie können andere Workflows innerhalb eines Workflows aufrufen! <br /><br />Beispielsweise kann /workflow-1 Anweisungen wie „Rufe /workflow-2 auf“ und „Rufe /workflow-3 auf“ enthalten.</Tip>

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.

<div id="how-to-create-a-workflow">
  ## So erstellen Sie einen Workflow
</div>

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.

<div id="workflow-discovery">
  ## Workflow-Erkennung
</div>

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

<div id="workflow-storage-locations">
  ### Speicherorte für Workflows
</div>

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.

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/create-workflow.mp4?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=d79db41f1ecd46f1fcdf07476bf2aaf1" data-path="assets/windsurf/cascade/create-workflow.mp4" />

<div id="generate-a-workflow-with-cascade">
  ### Einen Workflow mit Cascade erstellen
</div>

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.

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/create-workflow-with-cascade.mp4?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=f4d4dc32f319a356a776e03d355907a5" data-path="assets/windsurf/cascade/create-workflow-with-cascade.mp4" />

<div id="example-workflows">
  ## Beispiel-Workflows
</div>

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

<Card title="/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.
  ```
</Card>

<Card title="/git-workflows">
  Committe mit vordefinierten Formaten und erstelle Pull Requests mit standardisiertem Titel und standardisierten Beschreibungen über die entsprechenden CLI-Befehle.
</Card>

<Card title="/dependency-management">
  Automatisiere die Installation oder Aktualisierung von Projektabhängigkeiten auf Basis einer Konfigurationsdatei (z. B. requirements.txt, package.json).
</Card>

<Card title="/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.
</Card>

<Card title="/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.
</Card>

<Card title="/deployment">
  Automatisiere die Schritte zum Deployment deiner Anwendung in verschiedene Umgebungen (Development, Staging, Production), einschließlich erforderlicher Vorabprüfungen und nachgelagerter Verifikationen.
</Card>

<Card title="/security-scan">
  Integriere Sicherheits-Scans auf Schwachstellen in deinem Codebestand und triggere sie im Rahmen der CI/CD-Pipeline oder bei Bedarf.
</Card>

<div id="system-level-workflows-enterprise">
  ## Systemweite Workflows (Enterprise)
</div>

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.

<div id="workflow-precedence">
  ### Vorrang von Workflows
</div>

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.

<Note>
  **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.
</Note>