Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

Workflows ermöglichen es Nutzern, eine Reihe von Schritten zu definieren, um Cascade durch wiederkehrende Aufgaben zu führen, etwa die Bereitstellung eines Dienstes oder das Reagieren auf PR-Kommentare. Diese Workflows werden als Markdown-Dateien gespeichert und bieten Nutzern und ihren Teams eine einfache, wiederholbare Möglichkeit, wichtige Prozesse auszuführen. Nach dem Speichern können Workflows in Cascade über einen Slash-Befehl im Format /[name-of-workflow] aufgerufen werden.
Workflows sind ausschließlich manuell — Cascade wird einen Workflow niemals automatisch aufrufen. Wenn Cascade einen Ablauf selbstständig aufgreifen soll, verwenden Sie stattdessen ein Skill.

​
Wie es funktioniert

Rules geben großen Sprachmodellen in der Regel Orientierung, indem sie dauerhaften, wiederverwendbaren Kontext auf Prompt-Ebene bereitstellen. Workflows erweitern dieses Konzept, indem sie auf Ablaufebene eine strukturierte Abfolge von Schritten oder Prompts bereitstellen und das Modell durch eine Reihe zusammenhängender Aufgaben oder Aktionen führen.
Um einen Workflow auszuführen, rufen Nutzer ihn in Cascade einfach mit dem Befehl /[workflow-name] auf.
Sie können andere Workflows innerhalb eines Workflows aufrufen!

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

​
So erstellen Sie einen Workflow

Um mit Workflows loszulegen, klicken Sie im Slider-Menü oben rechts in Cascade auf das Symbol Customizations und navigieren Sie dann zum Bereich 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 Reihe von Schritten mit spezifischen Anweisungen für Cascade.

​
Workflow-Erkennung

Devin Desktop 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: Bei Git-Repositories sucht Devin Desktop außerdem bis zum Git-Root-Verzeichnis nach oben, um Workflows in übergeordneten Verzeichnissen zu finden
  • Unterstützung für mehrere Workspaces: Wenn mehrere Ordner im selben Workspace geöffnet sind, werden Workflows dedupliziert und mit dem kürzesten relativen Pfad angezeigt

​
Speicherorte für Workflows

GeltungsbereichSpeicherortHinweise
Workspace.windsurf/workflows/*.mdIn Ihrem aktuellen Workspace, in einem beliebigen Unterverzeichnis oder in einem übergeordneten Verzeichnis bis zum Git-Root. Wird mit Ihrem Repo versioniert.
Global~/.codeium/windsurf/global_workflows/*.mdIn jedem Workspace auf Ihrem Rechner verfügbar. Nicht versioniert.
IntegriertVon Devin Desktop verwaltetMit Devin Desktop ausgelieferte Vorlagen (z. B. /plan).
System (Enterprise)Betriebssystemspezifisch (z. B. /etc/windsurf/workflows/)Von der IT bereitgestellt, für Endnutzer schreibgeschützt.
Wenn Sie über die UI einen neuen Workflow erstellen, wird er im Verzeichnis .windsurf/workflows/ Ihres aktuellen Workspace gespeichert, nicht unbedingt im Git-Root. Um einen globalen Workflow zu erstellen, verwenden Sie die Schaltfläche + Global im Workflows-Bereich oder erstellen Sie die Datei direkt in ~/.codeium/windsurf/global_workflows/. Workflow-Dateien sind jeweils auf 12000 Zeichen begrenzt.

​
Mit Cascade einen Workflow generieren

Sie können sich von Cascade auch Workflows generieren lassen! Das funktioniert besonders gut bei Workflows mit einer Reihe von Schritten in einem bestimmten CLI-Tool.

​
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. Wechsle zum PR-Branch: `gh pr checkout [id]`

2. Rufe die Kommentare zur PR ab

 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. Gehe für JEDEN Kommentar wie folgt vor. Denke daran, immer nur einen Kommentar nach dem anderen 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 einfach um Klarstellung oder darum, ihn selbst umzusetzen.
 d. Wenn du glaubst, die Änderung vornehmen zu können, nimm sie vor, 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 NUTZERS erfordern.

/git-workflows

Führe Commits in vordefinierten Formaten aus und erstelle Pull Requests mit standardisierten Titeln und Beschreibungen mithilfe der entsprechenden CLI-Befehle.

/dependency-management

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

/code-formatting

Führe Code-Formatter (wie Prettier, Black) und Linter (wie ESLint, Flake8) beim Speichern von Dateien oder vor dem Committen automatisch aus, um den Codestil beizubehalten 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 Bereitstellen sicherzustellen.

/deployment

Automatisiere die Schritte zur Bereitstellung deiner Anwendung in verschiedenen Umgebungen (Entwicklung, Staging, Produktion), einschließlich aller erforderlichen Prüfungen vor der Bereitstellung oder Verifizierungen danach.

/security-scan

Integriere und löse Sicherheitslücken-Scans für deine Codebasis als Teil der CI/CD-Pipeline oder bei Bedarf aus.

​
Workflows auf Systemebene (Enterprise)

Enterprise-Organisationen können Workflows auf Systemebene bereitstellen, die global in allen Workspaces verfügbar sind und von Nutzern ohne Administratorrechte nicht geändert werden können. Das ist ideal, um organisationsweite Entwicklungsprozesse, Deployment-Verfahren und Compliance-Workflows durchzusetzen. Workflows auf Systemebene 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) im entsprechenden Verzeichnis für Ihr Betriebssystem ab. Das System lädt automatisch alle .md-Dateien aus diesen Verzeichnissen.

​
Vorrang von Workflows

Wenn Workflows mit demselben Namen auf mehreren Ebenen vorhanden sind, haben Workflows auf Systemebene den höchsten Vorrang:
  1. System (höchste Priorität) - organisationsweite Workflows, die von der IT bereitgestellt werden
  2. Workspace - projektspezifische Workflows in .windsurf/workflows/
  3. Global - nutzerdefinierte Workflows in ~/.codeium/windsurf/global_workflows/
  4. Integriert - Standard-Workflows, die von Devin Desktop bereitgestellt werden
Das bedeutet: Wenn eine Organisation einen Workflow auf Systemebene mit einem bestimmten Namen bereitstellt, überschreibt dieser jeden Workspace-, globalen oder integrierten Workflow mit demselben Namen. In der Devin Desktop UI werden Workflows auf Systemebene mit dem Label „System“ angezeigt und können von Endnutzern nicht gelöscht werden.
Wichtig: Workflows auf Systemebene sollten von Ihrem IT- oder Sicherheitsteam verwaltet werden. Stellen Sie sicher, dass Ihre internen Teams Bereitstellung, Updates und Compliance gemäß den Richtlinien Ihrer Organisation übernehmen. Dazu können Sie Standard-Tools und -Workflows wie Mobile Device Management (MDM) oder Configuration Management verwenden.