Memories
ist das System zum Teilen und dauerhaften Speichern von Kontext über Gespräche hinweg.
In Windsurf gibt es dafür zwei Mechanismen: Memories, die automatisch von Cascade erzeugt werden können, und Regeln, die vom Benutzer sowohl lokal als auch global manuell definiert werden.
So verwalten Sie Memories
Customizations
klicken oder über „Windsurf – Settings“ in der rechten unteren Ecke. Um eine bestehende Memory zu bearbeiten, klicken Sie einfach darauf und anschließend auf die Schaltfläche Edit
.
Erinnerungen
Das Erstellen und Verwenden automatisch generierter Erinnerungen verbraucht KEINE Credits
Regeln
global_rules.md
– Regeln, die in allen Workspaces gelten
.windsurf/rules
– Verzeichnis auf Workspace-Ebene mit Regeln, die an Globs oder natürliche Sprachbeschreibungen gebunden sind.
Regelermittlung
- Aktueller Workspace und Unterverzeichnisse: Alle
.windsurf/rules
-Verzeichnisse innerhalb Ihres aktuellen Workspaces und seiner Unterverzeichnisse - Git-Repository-Struktur: Für Git-Repositories durchsucht Windsurf zusätzlich bis zum Git-Root-Verzeichnis, um Regeln in übergeordneten Verzeichnissen zu finden
- Unterstützung mehrerer Workspaces: Wenn mehrere Ordner im selben Workspace geöffnet sind, werden Regeln dedupliziert und mit dem kürzesten relativen Pfad angezeigt
Speicherorte für Regeln
.windsurf/rules
in Ihrem aktuellen Workspace-Verzeichnis.windsurf/rules
in jedem Unterverzeichnis Ihres Workspaces.windsurf/rules
in übergeordneten Verzeichnissen bis zum Git-Root (für Git-Repositories)
.windsurf/rules
Ihres aktuellen Workspaces gespeichert, nicht unbedingt im Git-Root.
Um mit Regeln zu starten, klicken Sie im Schiebemenü oben rechts in Cascade auf das Symbol Customizations
und navigieren Sie anschließend zum Panel Rules
. Dort können Sie auf die Schaltfläche + Global
oder + Workspace
klicken, um neue Regeln entweder auf globaler Ebene oder auf Workspace-Ebene zu erstellen.
Beispielvorlagen für Regeln, kuratiert vom Windsurf-Team, finden Sie unter https://windsurf.com/editor/directory, um den Einstieg zu erleichtern.
Aktivierungsmodi
- Manuell: Diese Regel kann manuell per
@mention
im Eingabefeld von Cascade aktiviert werden. - Immer aktiv: Diese Regel wird immer angewendet.
- Modellentscheidung: Anhand einer natürlichsprachigen Beschreibung der vom Benutzer definierten Regel entscheidet das AI-Modell, ob die Regel angewendet wird.
- Glob: Anhand des vom Benutzer definierten Glob-Musters (z. B. .js, src/**/.ts) wird diese Regel auf alle Dateien angewendet, die dem Muster entsprechen.
Best Practices
- Halten Sie Regeln einfach, prägnant und konkret. Zu lange oder vage Regeln können Cascade verwirren.
- Fügen Sie keine generischen Regeln hinzu (z. B. „schreibe guten Code“), da diese bereits in Cascades Trainingsdaten enthalten sind.
- Formatieren Sie Ihre Regeln mit Aufzählungspunkten, nummerierten Listen und Markdown. Das ist für Cascade einfacher zu befolgen als ein langer Fließtext. Zum Beispiel:
- XML-Tags können eine effektive Möglichkeit sein, um Informationen zu vermitteln und ähnliche Regeln zu gruppieren. Zum Beispiel: