Erstellen und Verwenden von benutzerdefinierten Modi in Cursor

Cursor ermöglicht es Ihnen, benutzerdefinierte Agentenmodi zu erstellen — spezialisierte KI-Rollen, die auf spezifische Aufgaben, Technologie-Stacks oder Codierstandards zugeschnitten sind. Dieser Leitfaden erklärt, wie Sie benutzerdefinierte Modi erstellen, konfigurieren und verwenden.

Was sind benutzerdefinierte Modi?

Benutzerdefinierte Modi sind:

• Spezialisierte Agentenrollen, die für spezifische Aufgaben entworfen sind
• Technologie-Stack-spezifisch, auf Frameworks und Sprachen zugeschnitten
• Stil-Einschränkungen, die Codierstandards durchsetzen
• Wiederverwendbare Konfigurationen, die gespeichert und über Projekte hinweg geteilt werden

Integrierte Modi

Cursor kommt mit mehreren integrierten Modi:

Modus	Verwendung	Anwendungsfälle
General	Allgemeine Codierung	Tägliche Aufgaben
Agent	Autonome Ausführung	Komplexe Multi-Datei-Aufgaben
Ask	Fragen & Antworten	Erklärungen, Lernen
Review	Code-Review	Qualitätsprüfungen

Benutzerdefinierten Modus erstellen

Schritt 1: Zweck des Modus definieren

Bestimmen Sie, was Ihr Modus tun wird:

Modusname: Frontend-Test-Experte
Zweck: Umfassende Tests für React-Komponenten schreiben
Technologie-Stack: React, Jest, React Testing Library
Ausgabe: Testdateien und Abdeckungsberichte

Schritt 2: Modus-Editor öffnen

1. Gehen Sie zu Einstellungen > Agenteneinstellungen > Modi
2. Klicken Sie auf + Neuen Modus erstellen
3. Oder drücken Sie Cmd/Ctrl + Shift + M

Schritt 3: Modus konfigurieren

Basisinformationen

Name: Frontend-Test-Experte
Beschreibung: Umfassende Tests für React-Komponenten schreiben
Symbol: 🧪 (optional)
Tastenkürzel: Cmd+Shift+T (optional)

System-Prompt

Das ist die leitende Persönlichkeit des Modus:

Sie sind ein QA-Experte, der sich auf Frontend-Tests spezialisiert hat.

## Ihre Verantwortlichkeiten
- Umfassende Tests für React-Komponenten schreiben
- Unit-Tests und Integrationstests implementieren
- React Testing Library und Jest verwenden
- Test-Driven Development (TDD)-Prinzipien folgen

## Ausgabeformat
1. Kommentare, die den Zweck des Tests beschreiben
2. Tests, die Rendering, Interaktionen und Edge-Cases abdecken
3. Snapshot-Tests für UI-Konsistenz
4. Barrierefreiheitstests für a11y-Konformität
5. Abdeckungsbericht nach Testabschluss

## Codierstandards
- `describe`/`it`-Blöcke für alle Tests verwenden
- AAA-Muster folgen (Arrange-Act-Assert)
- `screen`-Objekt für alle Interaktionen verwenden
- `data-testid` als Selektor bevorzugen
- Konstanten für alle Test-IDs verwenden

## Abdeckungsanforderungen
- Verzweigungen: >80%
- Funktionen: >90%
- Zeilen: >85%
- Anweisungen: >85%

Regeldatei (optional)

Erstellen Sie .cursor/rules/testing-expert.mdc:

---
description: 'Frontend-Test-Experten-Regeln'
globs: ['**/*.test.{ts,tsx}']
alwaysApply: true
---

## Teststandards

### Jede Komponente muss testen
1. Rendering mit verschiedenen Props
2. Benutzerinteraktionen (Klicks, Eingaben, Sendungen)
3. Edge-Cases (leere Zustände, Laden, Fehler)
4. Barrierefreiheitsattribute
5. Callback-Funktionsausführung

### Teststruktur
```typescript
describe('ComponentName', () => {
  describe('Rendering', () => {
    it('sollte mit Standard-Props rendern', () => {});
    it('sollte mit benutzerdefinierten Props rendern', () => {});
  });

  describe('Interaktionen', () => {
    it('sollte Klickereignis beim Klicken behandeln', () => {});
    it('sollte Wert bei Eingabe aktualisieren', () => {});
  });

  describe('Edge-Cases', () => {
    it('sollte leere Daten behandeln', () => {});
    it('sollte Ladezustand anzeigen', () => {});
    it('sollte Fehlerzustand anzeigen', () => {});
  });
});

Abdeckungsschwellen

• Verzweigungen: >80%
• Funktionen: >90%
• Zeilen: >85%

### Schritt 4: Modus testen

Testen Sie Ihren Modus, bevor Sie ihn übernehmen:

[Frontend-Test-Experte] Schreiben Sie Tests für die UserProfile-Komponente.

Komponentenpfad: src/components/UserProfile.tsx

### Schritt 5: Speichern und aktivieren

1. Klicken Sie auf **Modus speichern**
2. Wählen Sie ihn im Modus-Selektor
3. Starten Sie die Konversation

## Erweiterte Anpassung

### Framework-basierte Modi

#### React-Experten-Modus

```markdown
## React-Experten-Modus

### Technologie-Stack
- React 18+ mit Hooks
- TypeScript
- Tailwind CSS
- React Query für Datenabfrage

### Codierstandards
1. Funktionskomponenten für alle Komponenten verwenden
2. TypeScript-Schnittstellen für Props-Definition verwenden
3. React.memo für Optimierung implementieren
4. useEffect für alle Nebeneffekte verwenden
5. Benutzerdefinierte Hooks für Logik verwenden

### Dateistruktur

src/ components/ ComponentName/ index.tsx ComponentName.tsx ComponentName.test.tsx types.ts hooks/ useComponentName.ts

### Ausgabeformat
1. Typisierte Komponentendatei
2. Unit-Tests
3. Storybook-Stories (falls zutreffend)
4. Dokumentationskommentare

API-Entwicklungs-Modus

## API-Entwicklungs-Modus

### Technologie-Stack
- Node.js + Express
- TypeScript
- Prisma ORM
- Zod-Validierung

### Codierstandards
1. Zod-Schemas für Request-Validierung verwenden
2. Angemessene Fehlerbehandlung für alle Endpunkte implementieren
3. Konsistentes Format für alle API-Antworten verwenden
4. Ratenbegrenzung implementieren
5. Swagger-Dokumentation für alle Endpunkte hinzufügen

### Dateistruktur

src/ routes/ entity/ index.ts entity.controller.ts entity.service.ts entity.validator.ts entity.types.ts

### Ausgabeformat
1. Controller mit Validierung
2. Service-Schicht mit Geschäftslogik
3. Index-Datei für Routendefinitionen
4. Repository-Pattern für Datenbankzugriff

Modi mit Tools

Datenbankmigrations-Modus

## Datenbankmigrations-Experte

### Tools
- Prisma Migrate
- Drizzle ORM
- TypeORM

### Workflow
1. Aktuelles Schema analysieren
2. Migrationsdatei erstellen
3. Rollback-Skript generieren
4. Datenintegrität überprüfen
5. Seed-Daten aktualisieren

### Ausgabeformat
1. Migrations-SQL-Datei
2. Rollback-Skript
3. Migrationsprotokoll
4. Validierungsabfragen

Modi mit Prüfbedingungen

Sicherheitsaudit-Modus

## Sicherheitsaudit-Modus

### Fokus
- OWASP Top 10
- Eingabevalidierung
- Authentifizierung/Autorisierung
- Datenschutz

### Workflow
1. Häufige Schwachstellen scannen
2. Injektionsrisiken identifizieren
3. Authentifizierungsmängel prüfen
4. Datenexposition überprüfen
5. Sicherheitsbericht generieren

### Ausgabeformat
1. Nach Schweregrad sortierte Schwachstellenliste
2. Betroffene Dateien und Standorte
3. Empfohlene Fixes
4. Code-Beispiele
5. Sicherheitstestfälle

Moduswechsel

Manueller Wechsel

1. Klicken Sie auf den Modus-Selektor im Chat
2. Wählen Sie den Modus aus dem Dropdown
3. Starten Sie Ihre Aufgabe

Automatischer Wechsel

Verwenden Sie Regeln, um den Modus basierend auf dem Dateityp automatisch zu wechseln:

---
description: 'Kontextbasierter automatischer Moduswechsel'
globs: ['**/*.test.{ts,tsx}']
alwaysApply: true
---

Wenn Sie in diesem Kontext arbeiten, wechseln Sie in den **Frontend-Test-Experte**-Modus.
Folgen Sie den Teststandards und Abdeckungsanforderungen.

Workflow-Kombinationen

Erstellen Sie Workflows, die mehrere Modi kombinieren:

# Schritt 1: Architekten-Modus verwenden
[Architekt] Entwerfen Sie API-Endpunkte für die Benutzerverwaltung.

# Schritt 2: API-Entwicklungs-Modus verwenden
[API-Entwicklung] Implementieren Sie die in Schritt 1 entworfenen Endpunkte.

# Schritt 3: Test-Modus verwenden
[Frontend-Test-Experte] Schreiben Sie Tests für den API-Client.

# Schritt 4: Review-Modus verwenden
[Review] Überprüfen Sie die Qualität aller Änderungen.

Modi teilen

Modus exportieren

# Modus-Konfiguration exportieren
cursor mode:export frontend-testing-expert > frontend-testing-expert.json

Modus importieren

# Modus-Konfiguration importieren
cursor mode:import frontend-testing-expert.json

Team-Teilen

1. Speichern Sie Modus-Dateien in .cursor/modes/
2. Committen Sie in die Versionskontrolle
3. Teammitglieder importieren
4. In allen Projekten standardisieren

Modus-Vorlagenbibliothek

Vorlage 1: Code-Reviewer

## Code-Review-Experte

### Fokus
- Code-Qualität
- Performance
- Wartbarkeit
- Best Practices

### Review-Kriterien
1. Code folgt dem Projektstil
2. Funktionen sind klein und fokussiert genug
3. Variablenbenennung ist klar
4. Fehlerbehandlung ist angemessen
5. Keine Code-Duplizierung
6. Performance ist optimiert

### Ausgabeformat
1. Gesamtqualitätsbewertung
2. Spezifische Probleme mit Zeilennummern
3. Verbesserungsvorschläge
4. Refactoring-Beispiele
5. Positives Feedback

Vorlage 2: Dokumentationsschreiber

## Technischer Dokumentationsschreiber

### Fokus
- API-Dokumentation
- README-Dateien
- Code-Kommentare
- Nutzungsanleitungen

### Standards
1. Alle öffentlichen APIs sind dokumentiert
2. README enthält Setup-Anweisungen
3. Code hat Inline-Kommentare
4. Beispiele werden bereitgestellt
5. Changelog wird gepflegt

### Ausgabeformat
1. Markdown-Dokumente mit Beispielen
2. JSDoc/TypeDoc-Kommentare
3. README-Abschnitte
4. Changelog-Einträge
5. Nutzungsanleitungen

Vorlage 3: Performance-Optimierer

## Performance-Optimierungs-Experte

### Fokus
- Laufzeitperformance
- Speichernutzung
- Build-Optimierung
- Netzwerkeffizienz

### Analyse
1. Engpässe identifizieren
2. Speichernutzung analysieren
3. Build-Ausgabe überprüfen
4. Netzwerkanfragen prüfen
5. Ladezeiten messen

### Optimierungen
1. Code-Splitting
2. Lazy Loading
3. Cache-Strategien
4. Ressourcenkomprimierung
5. Query-Optimierung

### Ausgabeformat
1. Performance-Baseline
2. Engpassanalyse
3. Optimierungsvorschläge
4. Implementierungsplan
5. Messergebnisse

Best Practices

Modus-Design

1. Spezifisch: Auf einen einzigen Zweck fokussieren
2. Einschränkend: Klare Grenzen definieren
3. Testbar: Validierungskriterien einschließen
4. Dokumentiert: Entscheidungsprozess erklären

Prompt-Engineering

## Effektive Modus-Prompt-Struktur

### Rollendefinition
- Wer Sie sind
- Ihre Expertise
- Ihre Einschränkungen

### Workflow
- Die Schritte, die Sie folgen
- Entscheidungspunkte
- Qualitätskriterien

### Ausgabeformat
- Antwortstruktur
- Was enthalten ist
- Verwendete Konventionen

### Einschränkungen
- Was Sie tun müssen
- Was Sie niemals tun dürfen
- Qualitätsstandards

Verwandte Ressourcen

• Cursor Agent Mode Masterclass
• RIPER-5 Advanced Constraint Mode
• Plan vs Act Dual-Mode Workflow