Was macht design-handoff?
Falls dir unbekannte Platzhalter auffallen oder du prüfen möchtest, welche Tools verbunden sind, siehe CONNECTORS.md.
Erstelle eine umfassende Entwickler-Übergabedokumentation (Handoff) aus einem Design.
Verwendung
/design-handoff $ARGUMENTS
Erstelle Übergabespezifikationen für: @$1
Wenn eine Figma-URL angegeben wird, das Design aus Figma abrufen. Andernfalls anhand der bereitgestellten Beschreibung oder des Screenshots arbeiten.
Was enthalten sein soll
Visuelle Spezifikationen
- Exakte Maße (Padding, Abstände, Breiten)
- Design-Token-Referenzen (Farben, Typografie, Abstände)
- Responsive Breakpoints und Verhalten
- Komponentenvarianten und -zustände
Interaktionsspezifikationen
- Klick-/Tippverhalten
- Hover-Zustände
- Übergänge und Animationen (Dauer, Easing)
- Gestenunterstützung (Wischen, Ziehen, langes Drücken)
Inhaltspezifikationen
- Zeichenlimits
- Textkürzungsverhalten
- Leere Zustände
- Ladezustände
- Fehlerzustände
Randfälle
- Minimaler/maximaler Inhalt
- Internationaler Text (längere Zeichenketten)
- Langsame Verbindungen
- Fehlende Daten
Barrierefreiheit
- Fokus-Reihenfolge
- ARIA-Labels und -Rollen
- Tastaturinteraktionen
- Screenreader-Ansagen
Prinzipien
- Nicht raten: Wenn es nicht spezifiziert ist, wird der Entwickler raten. Spezifiziere alles.
- Tokens statt Werte verwenden: Referenziere
spacing-md, nicht16px. - Alle Zustände zeigen: Standard, Hover, Aktiv, Deaktiviert, Laden, Fehler, Leer.
- Das „Warum“ beschreiben: „Dies klappt auf Mobilgeräten ein, weil Nutzer hauptsächlich einhändig bedienen“ hilft Entwicklern, gute Entscheidungen zu treffen.
Ausgabe
## Handoff-Spezifikation: [Funktion/Bildschirmname]
### Überblick
[Was dieser Bildschirm/diese Funktion tut, Nutzungskontext]
### Layout
[Rastersystem, Breakpoints, responsives Verhalten]
### Verwendete Design-Tokens
| Token | Wert | Verwendung |
|-------|------|------------|
| `color-primary` | #[hex] | CTA-Buttons, Links |
| `spacing-md` | [X]px | Zwischen Abschnitten |
| `font-heading-lg` | [Größe/Gewicht/Schriftart] | Seitentitel |
### Komponenten
| Komponente | Variante | Props | Hinweise |
|------------|----------|-------|----------|
| [Komponente] | [Variante] | [Props] | [Besonderes Verhalten] |
### Zustände und Interaktionen
| Element | Zustand | Verhalten |
|---------|---------|-----------|
| [CTA-Button] | Hover | [Hintergrund abdunkeln 10%] |
| [CTA-Button] | Laden | [Ladekreis, deaktiviert] |
| [Formular] | Fehler | [Roter Rand, Fehlermeldung darunter] |
### Responsives Verhalten
| Breakpoint | Änderungen |
|------------|------------|
| Desktop (>1024px) | [Standard-Layout] |
| Tablet (768-1024px) | [Was sich ändert] |
| Mobil (<768px) | [Was sich ändert] |
### Randfälle
- **Leerer Zustand**: [Was anzeigen, wenn keine Daten vorhanden]
- **Langer Text**: [Kürzungsregeln]
- **Laden**: [Skeleton oder Ladekreis]
- **Fehler**: [Darstellung des Fehlerzustands]
### Animation / Bewegung
| Element | Auslöser | Animation | Dauer | Easing |
|---------|----------|-----------|-------|--------|
| [Element] | [Auslöser] | [Beschreibung] | [ms] | [Easing] |
### Barrierefreiheitshinweise
- [Fokus-Reihenfolge]
- [Benötigte ARIA-Labels]
- [Tastaturinteraktionen]
Wenn Konnektoren verfügbar sind
Falls ~~Designtool verbunden ist:
- Exakte Maße, Tokens und Komponentenspezifikationen aus Figma auslesen
- Assets exportieren und vollständiges Spezifikationsblatt generieren
Falls ~~Projektmanagementsystem verbunden ist:
- Den Handoff mit dem Implementierungsticket verknüpfen
- Unteraufgaben für jeden Abschnitt der Spezifikation erstellen
Tipps
- Teile den Figma-Link: Ich kann exakte Maße, Tokens und Komponenteninformationen auslesen.
- Erwähne Randfälle: „Was passiert mit 100 Elementen?“ hilft mir, Grenzbedingungen zu spezifizieren.
- Gib den Tech-Stack an: „Wir verwenden React + Tailwind“ hilft mir, relevante Implementierungshinweise zu geben.