Communitygithub.com

Demo-Review-Flow

Verwendung, wenn jemand etwas hinzufügen, ändern oder neu gestalten möchte, das Benutzer in einer Benutzeroberfläche sehen oder bedienen – Layout, Position eines Steuerelements, Interaktion, Tastenkürzel, Styling, Animation – einschließlich „kleiner“ Anpassungen und Anfragen unter Zeitdruck; wenn eine Sitzung UI-Arbeit mit einem Review-Board fortsetzt; oder wenn Tests und Code-Review bestanden sind, der Benutzer die UI aber weiterhin als falsch empfindet.

Was ist Demo-Review-Flow?

Dieser Skill definiert einen strengen, benutzerzentrierten Workflow für UI-Änderungen, bei dem Designentscheidungen durch funktionierende Demos validiert werden, bevor Produktcode geschrieben wird. Er stellt sicher, dass Look-and-Operate-Änderungen (Layout, Steuerelemente, Interaktionen, Animationen) nicht nur durch Tests und Code-Reviews, sondern durch die tatsächliche Benutzerakzeptanz abgesichert werden. Der Skill unterstützt Plattformen wie Claude Code, Cursor und Codex und verwendet ein Review-Board (eine Artifact-Seite mit einer gemeinsamen Datenbank), um jede Funktion durch sechs Status zu verfolgen: erstellt, in Überprüfung, genehmigt, portiert, ausgeliefert und verifiziert. Entwickler werden angeleitet, zuerst Referenz-Apps zu studieren, die reale UI zu messen, ein Demo-Feature zu bauen, das wirklich funktioniert (Klicks, Tasten, Bewegungen, Hell/Dunkel, schmale Breite), und dann die Überprüfung zu übergeben, ohne bereits Produktcode zu schreiben. Erst nach der Genehmigung wird portiert, und die Auslieferung erfordert Live-Nachweise. Der Skill enthält auch Sicherheitsregeln für Live-Umgebungen mit echten Daten und widerlegt typische Rationalisierungen, die den Workflow umgehen wollen. Rote Flaggen warnen vor häufigen Fehlern wie dem Starten von Produktcode ohne Demo oder dem Verifizieren ohne Benutzerbestätigung.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/whats2000/demo-review-skills/tree/HEAD/skills/demo-review-flow

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Demo-Review-Flow?

Tests und Code-Review beweisen den Mechanismus. Sie können nicht sagen, dass das Menü an der falschen Stelle ist, der Schließbutton flackert oder das Icon 2 px zu tief sitzt – nur der Benutzer kann das. Daher wird eine Look-and-Operate-Änderung als funktionierende Demo entworfen, die der Benutzer pro Funktion genehmigt, bevor Produktcode geschrieben wird, und sie wird erst abgeschlossen, wenn der Benutzer sie in der echten App akzeptiert. Ein Review-Board (eine Artifact-Seite mit einer gemeinsamen Datenbank) verfolgt jede Funktion durch sechs Status.

Projektkonfiguration: .claude/demo-board.md (Board-URL, Referenz-Apps pro Bereich, zu prüfende Breiten, Live-App + ob sie echte Daten enthält, Workspace-Kopie-Ports, Gate-Befehle, Spezifikationsdatei). Fehlt → zuerst das Board erstellen: references/board-setup.md.

Welcher Pfad

  • Ändert, wie etwas aussieht, wo es sitzt oder wie es bedient wird → dieser Flow. Keine Ausnahme für Größe oder Deadline.
  • Stellt ein Verhalten wieder her, das die Spezifikation oder eine genehmigte Demo bereits definiert (Absturz, falsche Daten, Überlauf, Regression) → direkt mit TDD beheben, keine Demo. Dem Benutzer mitteilen, welchen Pfad du gewählt hast.
  • Ein Fehler, der für ein ausgeliefertes Board-Element gemeldet wurde → zurück zu porting, beheben, Live-Check, shipped. Eine Korrektur, die das Aussehen ändert → neue Demo-Runde.

Der Flow

  1. Zuerst Referenzen. Für den Bereich die Apps suchen, die Benutzer bereits kennen (die Konfiguration listet sie auf). Festhalten, wo das Steuerelement sitzt, jede Taste, die Bewegung inkl. Ausgänge. Nur mit einer begründeten Aussage abweichen. Eine Umfrage unter simulierten Benutzern wählt zwischen Optionen; sie ersetzt nie die Referenz.
  2. Messe die echte UI. Screenshot der ausgelieferten Bildschirme, die die Änderung betrifft, bei den Breiten des Benutzers, schreibgeschützt, und messe Abstände, Größen, Ausrichtung. Auf diesem Layout entwerfen.
  3. Baue die Demo als einen feat()-Eintrag, der wirklich funktioniert: Klicks, Tasten, Bewegung inkl. Ausgänge, Hell + Dunkel, schmale Breite. → references/add-feature.md
  4. Erfasse sie: eine changes-Zeile und features/<id> → review.
  5. Übergeben und anhalten. Link + worauf zu achten ist. Kein Produktcode für dieses Element, bis es approved ist. „Mach ruhig weiter, es sei denn, du widersprichst“ ist keine Genehmigung. Wenn die Genehmigung nicht vor einer Deadline eingehen kann, dem Benutzer das anbieten, was bereits dafür ausgeliefert wird – niemals vorausbauen.
  6. Entscheidungen aufnehmen zu Beginn jeder UI-Sitzung und immer, wenn der Benutzer sagt, er habe überprüft: features lesen. approved → 7. changes → der note ist die Anfrage → 3. Benutzer sagt, er habe genehmigt, aber die DB widerspricht → der Klick wurde nicht gespeichert: das sagen, für ihn setzen.
  7. Sofort portieren – der Benutzer überprüft keine Pläne; sein Maßstab ist Schritt 9. porting setzen; kurze Anleitung pro references/port-brief.md. Ein Portierungs-Agent pro Dateibereich. Migrationen auf einer Workspace-Kopie ausführen; auf Live-Daten nur mit ausdrücklicher Genehmigung und einem Backup.
  8. Ausliefern nur mit Live-Nachweisen (Maße, Bewegungen pro Frame, beide Designs, die Breiten des Benutzers): shipped + eine changes-Zeile + was zu prüfen ist.
  9. Verifiziert ist die Entscheidung des Benutzers – sein Accept-Klick oder er sagt im Chat, dass dieses Element akzeptiert ist (dann setzt du es). Ein vages „sieht gut aus“ → nachfragen, welche Elemente. Niemals nach eigenem Ermessen.

Status, wer sie setzt, das DB-Schema, Schreibvorgänge → references/lifecycle.md. Übergaben mit Brainstorming, Pläne schreiben, Subagenten-gesteuerte Entwicklung, Verifikation und Branch-Abschluss → references/superpowers-integration.md.

Live-Check-Sicherheit

Auf einer Live-App mit echten Daten: schreibgeschützt durchsuchen, nur exakte Labels klicken, niemals löschen/entfernen/bearbeiten dort – jeder Check, der Daten ändert, läuft auf einer Workspace-Kopie.

Rationalisierungen

GedankeRealität
„Es ist klein / leicht rückgängig zu machen“Größe ist nicht der Test; Look-and-Operate ist es. Kleine UI-Änderungen sind genau da, wo die Platzierung schiefgeht.
„Morgen ist Deadline“Eine Demo-Runde dauert Minuten; eine falsche Platzierung, die in der Demo ausgeliefert wird, kostet mehr. Die Reihenfolge einhalten, den Zeitplan nennen.
„Ich zeige Screenshots und mache weiter, es sei denn, sie widersprechen“Schweigen ist keine Genehmigung, und ein Screenshot eines fertigen Builds ist keine Demo, die sie bedienen können.
„Die richtige Stelle ist aus ersten Prinzipien offensichtlich“Nenne die Referenz-App. „Wo Benutzer hinschauen“ ist, wie der nicht auffindbare Schalter ausgeliefert wurde.
„Tests, Review und Build sind grün, also ist es fertig“Das ist porting abgeschlossen. shipped braucht Live-Nachweise; verified braucht den Benutzer.
„‚Sieht gut aus, schätze ich‘ bedeutet akzeptiert“Akzeptanz ist pro Element. Frage nach, welche.
„Sie werden sowieso genehmigen; ich baue für die Deadline vor“Nicht genehmigter Code ist die verschwendete Art. Weise sie auf das hin, was heute ausgeliefert wird; portiere in dem Moment, in dem sie genehmigen.
„Ich erfinde einen klareren Status“Nur sechs Status; die Seite und der Benutzer lesen diese.
„Port und Demo zusammen, um Zeit zu sparen“Nur approved-Elemente erhalten Produktcode.

Rote Flaggen – anhalten

  • Öffnen einer Produktkomponente, bevor die Demo das Design zeigt.
  • Ein Design ohne benannte Referenz-App oder ohne Messung der echten UI.
  • shipped ohne Live-Nachweise; verified ohne die Aussage des Benutzers zu diesem Element.
  • Klicken von Löschen/Entfernen/Speichern in einer App, die echte Daten enthält.
  • Zwei Portierungs-Agents auf denselben Dateien; Ausführen einer Migration auf Live-Daten.

Verwandte Skills