Communitygithub.com

Schritt- & Fortschritts-System

Entwerfen und implementieren Sie strukturierte Fortschrittsanzeigen und mehrstufige Sequenzen, die Benutzer durch komplexe Aufgaben führen und klares Feedback zu ihrer aktuellen Position und dem verbleibenden Aufwand geben.

Was ist Schritt- & Fortschritts-System?

Das Schritt- & Fortschritts-System-Skill bietet eine standardisierte Methodik zum Entwerfen und Dokumentieren von Multi-Step-Prozessen in Benutzeroberflächen. Es hilft Entwicklern und Designern, komplexe Workflows wie Checkouts, Onboarding oder mehrstufige Formulare in überschaubare Schritte zu unterteilen und den Benutzerfortschritt visuell darzustellen. Das Skill unterstützt verschiedene Fortschrittskomponenten wie horizontale und vertikale Stepper, Fortschrittsbalken und -kreise und definiert klare Regeln für Zustände (Ausstehend, Aktiv, Abgeschlossen, Fehler), Barrierefreiheit (ARIA-Rollen, Kontraste) und responsives Design. Es eignet sich besonders für lineare und nicht-lineare Prozesse und vermeidet häufige Fallstricke wie unklaren Fortschritt, fehlende Beschriftungen oder überladene mobile Ansichten. Das Skill ist für alle UI-Frameworks und Plattformen geeignet, da es plattformagnostische Prinzipien beschreibt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/step-progress-system

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Schritt- & Fortschritts-System?

Zweck

Das Schritt- & Fortschritts-System-Skill bietet eine Methodik zum Entwerfen und Dokumentieren, wie Benutzer durch mehrstufige Prozesse navigieren oder auf Hintergrundaufgaben warten. Es stellt sicher, dass komplexe Workflows (wie Checkouts oder Onboarding) in überschaubare Abschnitte unterteilt werden, wodurch die kognitive Belastung reduziert wird, indem dem Benutzer mitgeteilt wird, wo er sich befindet, was er abgeschlossen hat und was noch zu tun ist.

Anwendungsfälle

  • E-Commerce-Checkouts: Führen der Benutzer durch Versand, Zahlung und Überprüfung.
  • Mehrstufige Formulare: Aufteilung langer Dateneingabeaufgaben in logische Abschnitte.
  • Benutzer-Onboarding: Visualisierung des Einrichtungsprozesses für ein neues Konto.
  • Lade-/Hochlade-Zustände: Kommunikation des Status langlaufender Operationen.
  • Lernpfade: Anzeigen des Fortschritts durch einen Kurs oder Lehrplan.

Wann NICHT zu verwenden

  • Einzelansicht-Aufgaben: Wenn eine Aufgabe in einer einzigen Ansicht ohne Kontextwechsel abgeschlossen werden kann, fügt ein Fortschrittssystem unnötiges Rauschen hinzu.
  • Unendliche Feeds: Scrollen durch Inhalte, bei denen es kein definiertes „Ende“ des Fortschritts gibt.
  • Kritische Hochgeschwindigkeits-Interaktionen: Bei denen die Verzögerung durch die Anzeige von Fortschrittsindikatoren eine zeitkritische Aufgabe behindern würde (z.B. Echtzeit-Gaming-UI).

Eingaben

  1. Schritt-Inventar: Eine Liste der diskreten Stufen, die zur Erledigung der Aufgabe erforderlich sind.
  2. Aufgabentyp: Handelt es sich um eine benutzergesteuerte Sequenz (Stepper) oder einen systemgesteuerten Prozess (Fortschrittsbalken)?
  3. Linearität: Müssen die Schritte der Reihe nach abgeschlossen werden, oder kann der Benutzer zwischen ihnen springen?
  4. Inhaltsbeschränkungen: Beschriftungen, Beschreibungen und Symbole für jeden Schritt.

Ausgaben

  1. Fortschritts-Framework: Eine Definition des Komponententyps (Horizontal, Vertikal oder Kreisförmig).
  2. Zustandsmatrix: Visuelle Spezifikationen für die Zustände Ausstehend, Aktiv, Abgeschlossen und Fehler.
  3. Responsive Strategie: Wie sich der Indikator an mobile Viewports anpasst (z.B. Ausblenden von Beschriftungen, Wechseln zu numerisch).
  4. Barrierefreiheits-Spezifikationen: ARIA-Rollen, Live-Regionen und Tastatur-Interaktionsregeln.

Arbeitsablauf

1. Kategorisieren des Fortschrittstyps

Bestimmen Sie das am besten geeignete visuelle Muster:

  • Horizontaler Stepper: Am besten für lineare Prozesse mit 3–5 Schritten auf dem Desktop.
  • Vertikaler Stepper: Am besten für nicht-lineare Prozesse, Schritte mit unterschiedlichen Inhaltslängen oder Mobile-First-Abläufe.
  • Kontinuierlicher Fortschrittsbalken: Am besten für systemgesteuerte Aufgaben (Uploads, Laden) oder Prozesse mit einer hohen Anzahl von Mikroschritten.
  • Fortschrittskreis: Am besten für Dashboard-Widgets oder wenn der Platz extrem begrenzt ist.

2. Definieren der Schritte-Hierarchie und Beschriftungen

  • Primäre Beschriftung: Prägnanter Name des Schritts (z.B. „Versand“).
  • Sekundäre Beschriftung (optional): Kurze Beschreibung oder Status (z.B. „In Bearbeitung“).
  • Visueller Indikator: Zahlen (für die Reihenfolge), Symbole (für den Kontext) oder Punkte (für minimalistisches Design).

3. Festlegen der Zustandsvisualisierung

Definieren Sie klare visuelle Unterscheidungen für jeden Zustand:

  • Ausstehend: Niedriger Kontrast, normalerweise ausgegraut.
  • Aktiv: Hoher Kontrast, oft unter Verwendung der primären Markenfarbe oder eines „Glow“-Effekts.
  • Abgeschlossen: Verwenden Sie ein „Häkchen“-Symbol und eine auffällige Farbe (oft Grün oder eine abgeschwächte Version der aktiven Farbe).
  • Fehler: Verwenden Sie ein „Warnungs“-Symbol und eine semantische Fehlerfarbe (Rot).

4. Entwerfen für Bewegung und Feedback

  • Übergänge: Verwenden Sie subtile Animationen beim Wechsel zwischen Schritten, um den Fortschritt zu verstärken.
  • Anklickbarkeit: Bestimmen Sie, ob Benutzer auf vorherige Schritte klicken können, um zurückzugehen.
  • Validierung: Visualisieren Sie, dass ein Schritt gültig/vollständig ist, bevor Sie den Fortschritt ermöglichen.

5. Planen von responsiven Anpassungen

Mehrstufige Indikatoren sind dafür bekannt, auf mobilen Geräten zu versagen:

  • Beschriftungsreduktion: Auf Mobilgeräten Textbeschriftungen ausblenden und nur Zahlen oder Symbole anzeigen.
  • Übergang zu „Schritt X von Y“: Ersetzen Sie die vollständige visuelle Leiste durch eine einfache textuelle oder numerische Zusammenfassung.
  • Vertikale Verschiebung: Konvertieren Sie horizontale Balken auf kleinen Bildschirmen in vertikale Listen.

Entscheidungsregeln

  • Die 5-Schritt-Regel: Wenn ein horizontaler Stepper mehr als 5 Schritte hat, wechseln Sie zu einem vertikalen Stepper oder einem einfachen „Schritt X von Y“-Textindikator, um Unordnung zu vermeiden.
  • Symbol vs. Zahl: Verwenden Sie Zahlen, wenn die Reihenfolge der Sequenz kritisch ist; verwenden Sie Symbole nur, wenn sie einen unmittelbaren semantischen Wert bieten (z.B. ein „Kreditkarten“-Symbol für die Zahlung).
  • Linearität: Wenn Benutzer Schritte in der Reihenfolge abschließen müssen, deaktivieren Sie Klicks auf „zukünftige“ Schritte. Handelt es sich um ein flexibles Setup, erlauben Sie das Springen.
  • Kontexterhaltung: Zeigen Sie immer die Beschriftungen des aktuellen, vorherigen und nächsten Schritts an. Andere können bei Bedarf abgeschnitten werden.

Einschränkungen

  • Barrierefreiheit:
    • Verwenden Sie role="progressbar" mit aria-valuenow, aria-valuemin, aria-valuemax und einem menschenlesbaren aria-valuetext (z.B. „Schritt 2 von 4: Zahlung“) für kontinuierliche Balken.
    • Verwenden Sie aria-current="step", um den aktiven Schritt in einer Sequenz zu identifizieren.
    • Stellen Sie sicher, dass die Kontrastverhältnisse für aktive vs. inaktive Schritte WCAG AA (4,5:1) erfüllen.
    • Wenn Schritte anklickbar sind, müssen ihre Ziele WCAG 2.2 SC 2.5.8 (mindestens 24x24 Pixel, 44 Pixel bevorzugt) erfüllen und sichtbare :focus-visible-Zustände anzeigen.
  • Hierarchie: Der Fortschrittsindikator sollte ein Leitfaden sein, nicht der Hauptfokus. Er befindet sich normalerweise oben (horizontal) oder links (vertikal) des Inhalts.
  • Responsivität: Darf keinen horizontalen Überlauf verursachen.

Häufige Fehlermuster

  • Der „Geheimnisvolle Fortschritt“: Anzeigen eines Balkens ohne Beschriftung oder Prozentsatz, sodass der Benutzer sich fragt: „Wie viel noch?“
  • Unzugängliche Zustände: Nur Verwendung von Farbe (z.B. Grün vs. Grau), um den Abschluss anzuzeigen, ohne Symbole oder Text.
  • Überfüllte Horizontale: Erzwingen zu vieler Schritte in einem horizontalen Layout, was zu überlappendem Text oder winzigen Berührungszielen auf mobilen Geräten führt.
  • Mangelnde Beständigkeit: Ausblenden des Fortschrittsindikators auf einigen Seiten eines mehrstufigen Ablaufs, sodass Benutzer ihren Orientierungssinn verlieren.

Validierungskriterien

  • Der aktuelle Schritt ist deutlich von abgeschlossenen und kommenden Schritten unterschieden.
  • Abgeschlossene Schritte verwenden einen nicht-farblichen Indikator (wie ein Häkchen).
  • Die mobile Ansicht ist funktionsfähig und läuft nicht über oder ist überladen.
  • ARIA-Rollen und aria-current sind korrekt angewendet.
  • Das System behandelt „Fehler“-Zustände für einzelne Schritte.
  • Der Indikator wird konsistent über alle Schritte des Ablaufs hinweg platziert.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Verwandte Skills