/design-handoff
Wenn dir unbekannte Platzhalter auffallen oder du prüfen möchtest, welche Tools verbunden sind, siehe CONNECTORS.md.
Erstelle eine umfassende Entwicklungs-Übergabedokumentation aus einem Design.
Verwendung
/design-handoff $ARGUMENTE
Erstelle Übergabespezifikationen für: @$1
Wenn eine Figma-URL angegeben wird, ziehe das Design aus Figma. Ansonsten arbeite mit der bereitgestellten Beschreibung oder dem Screenshot.
Was zu dokumentieren ist
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, Beschleunigung)
- Gestenunterstützung (Wischen, Ziehen, langes Drücken)
Inhaltsspezifikationen
- Zeichenbegrenzungen
- Abschneideverhalten (Truncation)
- Leere Zustände (Empty States)
- Ladezustände (Loading States)
- Fehlerzustände (Error States)
Randfälle
- Minimale/maximale Inhalte
- Internationaler Text (längere Zeichenketten)
- Langsame Verbindungen
- Fehlende Daten
Barrierefreiheit
- Fokus-Reihenfolge
- ARIA-Labels und -Rollen
- Tastaturinteraktionen
- Screenreader-Ansagen
Prinzipien
- Nichts annehmen — Wenn etwas nicht spezifiziert ist, wird der Entwickler raten. Spezifiziere alles.
- Tokens verwenden, nicht Werte — Referenziere
spacing-md, nicht16px. - Alle Zustände zeigen — Standard, Hover, Aktiv, Deaktiviert, Laden, Fehler, Leer.
- Das Warum beschreiben — „Dieses Element klappt auf mobilen Geräten ein, weil Benutzer hauptsächlich einhändig navigieren“ hilft Entwicklern, gute Entscheidungen zu treffen.
Ausgabe
## Übergabe-Spezifikation: [Feature-/Bildschirmname]
### Überblick
[Was dieser Bildschirm/diese Funktion tut, Benutzerkontext]
### Layout
[Gridsystem, 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 | Anmerkungen |
|------------|----------|-------|-------------|
| [Komponente] | [Variante] | [Props] | [Spezielles Verhalten] |
### Zustände und Interaktionen
| Element | Zustand | Verhalten |
|---------|---------|-----------|
| [CTA-Button] | Hover | [Hintergrund 10% abdunkeln] |
| [CTA-Button] | Laden | [Spinner, 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**: [Regeln zum Abschneiden]
- **Laden**: [Skelett oder Spinner]
- **Fehler**: [Aussehen des Fehlerzustands]
### Animation / Bewegung
| Element | Auslöser | Animation | Dauer | Beschleunigung |
|---------|----------|-----------|-------|----------------|
| [Element] | [Auslöser] | [Beschreibung] | [ms] | [Beschleunigung] |
### Barrierefreiheitshinweise
- [Fokus-Reihenfolge]
- [Erforderliche ARIA-Labels]
- [Tastaturinteraktionen]
Wenn Konnektoren verfügbar sind
Falls ~~Designtool verbunden ist:
- Exakte Maße, Tokens und Komponentenspezifikationen aus Figma extrahieren
- Assets exportieren und eine vollständige Spezifikationstabelle generieren
Falls ~~Projektverwaltung verbunden ist:
- Die Übergabe 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 extrahieren.
- Randfälle erwähnen — „Was passiert bei 100 Elementen?“ hilft mir, Grenzfälle zu spezifizieren.
- Den Tech-Stack angeben — „Wir verwenden React + Tailwind“ hilft mir, relevante Implementierungshinweise zu geben.