Was macht Replicate?
Machen Sie Genauigkeit zu einer evidenzgesteuerten Implementierungsschleife. Inspizieren Sie die Referenz, erfassen Sie ihre Details, implementieren Sie, vergleichen Sie, korrigieren Sie und verifizieren Sie. Ein überzeugender erster Eindruck ist noch keine Fertigstellung: Bewahren Sie die kleinen Beziehungen und Verhaltensweisen, die die Referenz auszeichnen.
Beginnen Sie mit der Referenz des Benutzers
- Leiten Sie Ziel, Umfang, Plattform und beabsichtigte Abweichungen aus dem Gespräch ab. Dieser Skill funktioniert für einen Screenshot, eine Design-Datei, eine Komponente, eine bestehende Implementierung, eine App, eine Website oder einen Service. Verlangen Sie kein interaktives Original, wenn der Benutzer ein statisches Design geliefert hat.
- Inspizieren Sie die tatsächliche Referenz, bevor Sie codieren. Bevorzugen Sie die vom Benutzer angegebene Quelle; verwenden Sie installierte Software für das Verhalten, Design-Dateien für explizite Designspezifikationen und hochauflösende Bilder für die gerenderte Darstellung. Wenn Quellen widersprüchlich sind, notieren Sie die Diskrepanz und wenden Sie die vom Benutzer angegebene Priorität an, anstatt sie stillschweigend zu mischen.
- Inspizieren Sie die bestehende Implementierung und die Projektanweisungen. Bewahren Sie funktionierende Funktionen und Benutzeränderungen. Wenn die Aufgabe eine Genauigkeitskorrektur ist, korrigieren Sie das bestehende Design, anstatt eine neue Richtung zu erfinden.
- Fragen Sie nur nach fehlenden Informationen, die einen sinnvollen Fortschritt behindern. Wenn der Zugriff auf das Original nicht möglich ist, fahren Sie mit den verfügbaren Beweisen fort und geben Sie an, was nicht verifiziert werden kann. Erfinden Sie niemals Beobachtungen.
- Legen Sie eine begrenzte Menge an Abläufen oder Zuständen sowie Akzeptanzkriterien fest. Interpretieren Sie „replizieren“ nicht als Autorisierung zum Kaufen, Veröffentlichen, Kontaktieren anderer, Kopieren von Anmeldeinformationen oder Ändern nicht zusammenhängender Servicedaten.
Inspizieren Sie, bevor Sie vereinfachen
Erstellen Sie ein kompaktes Referenzinventar mit evidence-template.md. Für eine kleine Komponente kann dies ein paar Zeilen sein; machen Sie aus einer kleinen Bearbeitung kein großes Dokumentationsprojekt.
Inspizieren Sie die gesamte Referenz, dann einzelne Bereiche. Erfassen Sie beobachtete Fakten, Messungen, Schätzungen und Unbekannte separat. Ersetzen Sie ungewöhnliche Details nicht durch vertraute Standardwerte, nur weil sie einfacher zu implementieren sind.
Inspizieren Sie anwendbare Details:
- Layout: Ausrichtung, Containment, Raster, Ränder, Abstände, Lücken, Proportionen, Schichtung, Beschneidung, sichere Bereiche und fixierte/sticky Elemente.
- Typografie: Schriftfamilie, -gewicht, -größe, Zeilenhöhe, Laufweite, Grundlinie, Zeilenumbruch, Abschneiden und Ausrichtung. Textlänge und echter Inhalt sind Teil des Layouts.
- Oberflächen: abgetastete Farben, Verläufe, Transparenz, Materialien, Rahmen, Eckenbehandlung, Schatten, Bildausschnitt, Symbolform/-gewicht und optische Ausrichtung.
- Zustände: ausgewählt, fokussiert, gedrückt, laden, leer, Fehler, deaktiviert, erweitert, gescrollt und Tastatur sichtbar; Hell/Dunkel- oder responsive Varianten, wenn im Umfang enthalten.
- Verhalten: Trefferbereiche, Navigation, Zurück-Verhalten, Zustandserhaltung, Suchbereich, Menüs, Scrollen, Überscrollen, Scrubbing und unterbrochene Gesten.
- Bewegung: Auslöser, Verzögerung, Dauer, Easing/Feder, Verschiebung, Überschwingen, Ausblenden, Skalierung, Verankerung, Unterbrechung und Rückkehr zur Ruhe.
- Service-Workflows: Ein-/Ausgabeverträge, Reihenfolge, Persistenz, Wiederholungen, Fehler, Latenz und für den Benutzer sichtbare Nebeneffekte. Visuelle Ähnlichkeit allein reproduziert keinen Service.
Passen Sie bei statischen Referenzen zuerst das beobachtbare Erscheinungsbild an. Markieren Sie nicht gezeigte Interaktionen und responsives Verhalten als abgeleitet; wählen Sie sinnvolles Verhalten, ohne zu behaupten, es sei beobachtet worden. Erkunden Sie bei interaktiven Referenzen vollständige Übergänge, nicht nur deren Endpunkte. Beziehen Sie schnelle wiederholte Eingaben und teilweise/abgebrochene Gesten ein, wo relevant.
Wählen Sie Werkzeuge für die Beweise
Verwenden Sie verfügbare Werkzeuge, nicht angenommene Werkzeugnamen oder Fähigkeiten. Lesen Sie die entsprechenden Werkzeug-/Skill-Anweisungen, bevor Sie sie verwenden.
- Design-Dateien: Verwenden Sie die entsprechende Design-Integration, um Knoten, Stile, Assets und Constraints sowie gerenderte Vorschauen zu inspizieren. Exportieren Sie, wenn möglich, tatsächliche autorisierte Assets, anstatt sie anzunähern.
- Apps: Verwenden Sie Argent/Device-Werkzeuge für Bedienung, Screenshots, Accessibility-Frames und wiederholbare Routen. Standardmäßig ein verbundenes physisches USB-Telefon verwenden, bevor Sie einen Simulator in Betracht ziehen. Wenden Sie bei Bedarf Plattform-Setup-/Interaktions-Skills an.
- Websites: Verwenden Sie die verfügbaren Browser-Tools für Screenshots, Viewport-Zustände, Interaktionen und Layout-Inspektion. Testen Sie die relevanten responsiven Breiten und Eingabemodi.
- Screenshots: Inspizieren Sie in voller Auflösung und beschneiden Sie Bereiche zur Analyse. Messen Sie in logischen Einheiten, wenn die Geräteskalierung bekannt ist; verwechseln Sie Screenshot-Pixel nicht mit Layout-Punkten.
- Bewegung: Nehmen Sie Videos mit unterstützten Aufnahmewerkzeugen auf und inspizieren Sie Einzelbilder/Kontaktabzüge. Messen Sie die Position gegen die Zeit, einschließlich der finalen Einpendelbilder. Verwenden Sie Aufnahmen zur Untersuchung von Bewegungen, nicht um eine Bildwiederholrate zu behaupten, die sie nicht feststellen können.
- Leistung: Verwenden Sie native Profiler/Instruments für native Apps oder Browser-Leistungstools für Web-Apps. Lesen Sie relevante Profiling-Skills. Animations-/UI-Polish-Skills ergänzen Referenzbeweise; ihre allgemeinen Präferenzen dürfen das angeforderte Design nicht überschreiben.
- Dienste: Verwenden Sie dokumentierte APIs, verfügbare Konnektoren und kontrollierte Testdaten, um beobachtbare Verträge zu vergleichen. Vermeiden Sie zerstörende Sonden und unnötige kostenpflichtige Anfragen.
Verwenden Sie kleine Messskripte, wenn sie Unsicherheiten beseitigen. Bevorzugen Sie reproduzierbare Stichproben gegenüber einer geratenen Farbe, Schriftart, Abstand oder Feder. Installieren Sie keine große Toolchain für einen kleinen Vergleich, wenn vorhandene Werkzeuge ausreichen.
Implementieren Sie einen vollständigen Slice
- Reproduzieren Sie einen vollständigen repräsentativen Ablauf oder eine Komponente mit echtem Inhalt, bevor Sie erweitern. Wählen Sie einen, der die wichtigen Layout- und Zustandsübergänge trainiert.
- Kodieren Sie gemeinsam genutzte gemessene Werte konsistent. Halten Sie die Komponentenidentität, den Navigationszustand und das Layout über Übergänge hinweg stabil.
- Verwenden Sie native/plattformspezifische Mechanismen, wo sie mit der Referenz übereinstimmen. Verwenden Sie Implementierungen auf niedrigerer Ebene nur, wenn Beobachtung oder Tests eine Abweichung zeigen. Gehen Sie nicht davon aus, dass ein Standard-Blatt, -Menü oder eine Standard-Feder übereinstimmt, nur weil es nativ aussieht.
- Bewahren Sie Text, Assets, Reihenfolge und markante visuelle Details. Fügen Sie keine Verläufe, Dekorationen, Platzhalterabschnitte, Textänderungen oder „Verbesserungen“ hinzu, die in der Referenz fehlen, es sei denn, sie wurden angefordert.
- Halten Sie das funktionale Verhalten korrekt, während Sie das Erscheinungsbild anpassen. Laden, Vorverarbeitung oder Animationen sollten nicht unnötig eine Aktion blockieren, die bereits fortgesetzt werden kann.
Vergleichen und korrigieren
Führen Sie diese Schleife nach jedem sinnvollen Slice aus:
- Versetzen Sie Referenz und Implementierung in vergleichbare Zustände: gleicher Inhalt, Viewport/Gerät, Skalierung, Design, Scrollposition, Tastatur und relevanter Daten-/Wiedergabezustand.
- Erfassen Sie beide. Vergleichen Sie die gesamte Komposition und dann Bereiche. Verwenden Sie Overlays/Diffs, wenn nützlich, und inspizieren Sie die tatsächlichen Bilder, nicht nur einen Wert. Halten Sie Ausschlussmasken explizit und auf wirklich variable Bereiche beschränkt.
- Erfassen Sie konkrete Diskrepanzen, deren Beweise und Schweregrad. Beheben Sie zuerst die größten strukturellen Unterschiede, dann Typografie/Oberflächen, dann Bewegung und kleine Interaktionsdetails. Überprüfen Sie die Struktur, wenn spätere Beobachtungen ihr widersprechen.
- Vergleichen Sie bei Bewegung den gesamten Übergang, einschließlich des ersten Bilds, Abbruch, Überschwingen, sicheren Bereichsabdeckung und endgültigem Einpendeln. Achten Sie auf Blitze, späte Hintergrundänderungen, verschwindende Balken, Symbolneuskalierung und Inhaltsneuerstellung.
- Wiederholen Sie die betroffenen Prüfungen nach den Korrekturen, plus relevante Verhaltensregressionen. Wiederholen Sie breite Tests nicht ständig, wenn sie ohne neue Beweise, die dies rechtfertigen, bestanden werden.
Behandeln Sie Pixelabweichungen nicht als universelles Ähnlichkeitsmaß. Geben Sie den genauen Zustand, das Gerät/Viewport, den Schwellenwert und die Masken hinter quantitativen Behauptungen an. Die Übereinstimmung eines Screenshots begründet keine Produktgleichheit. Rendering-/Schriftunterschiede können legitime Einschränkungen sein; identifizieren Sie sie, anstatt sie hinter breiten Schwellenwerten zu verstecken.
Wenn es richtig aussieht, sich aber falsch anfühlt
Trennen Sie Bewegungsdesign von Ausführungsleistung. Profilen Sie, bevor Sie willkürlich Dauern oder Federn ändern.
- Wiederholen Sie die gleiche repräsentative Arbeitslast vor und nach der Änderung mit vergleichbarem Beobachtungsaufwand.
- Vermeiden Sie Screenshots/Accessibility-Abfragen pro Frame während zeitkritischer Messungen. Erfassen Sie visuelle Beweise separat, wenn Instrumentierung die Arbeitslast verändert.
- Untersuchen Sie wiederholte Datentransformationen, übermäßige Zustandsinvalidierung, Ansichtsneubau, synchrone I/O, Dekodierung, Layoutarbeit und doppelte Gesten-Callbacks.
- Ändern Sie den nachgewiesenen Engpass und verifizieren Sie dann sowohl Leistung als auch Erscheinungsbild. Das Beibehalten von Ansichten/Caches tauscht Speicher gegen Geschwindigkeit: Begrenzen Sie sie und behandeln Sie Invalidierung/Lebenszyklus korrekt.
- Berichten Sie, was gemessen wurde, und dessen Einschränkungen. Videoneuberechnung ist nicht die Bildwiederholrate des Displays; unterschiedliche Arbeitslasten sind keine gültige numerische Basislinie.
Abschluss mit Beweisen
Schließen Sie die autorisierte Implementierung und Verifikation ab, nicht nur ein Audit oder einen Plan, es sei denn, der Benutzer hat nur Recherche angefordert.
Bevor Sie die Arbeit als erledigt bezeichnen:
- Jedes im Umfang enthaltene Akzeptanzkriterium hat einen Implementierungs- und Verifikationsnachweis oder eine explizite nicht gelöste Einschränkung.
- Wichtige statische Zustände wurden mit der Referenz verglichen; wichtige Übergänge wurden, wenn beobachtbar, durchgeführt.
- Funktionale Prüfungen decken das Verhalten ab, das die Änderung brechen könnte. Verwenden Sie für umfangreiche Abläufe wiederholbare Routen; vermeiden Sie Tests, die lediglich triviale Styling-Codes wiederholen.
- Bekannte beabsichtigte Abweichungen sind von Mängeln und Unbekannten unterschieden.
- Der Abschlussbericht gibt an, was geändert wurde, was tatsächlich getestet wurde und welche verbleibenden Unterschiede bestehen. Verlinken Sie nützliche Vergleichsbeweise; behaupten Sie nicht „pixelgenau“ oder „exaktes Verhalten“ über das Verifizierte hinaus.
Beachten Sie die Ressourcenlimits des Hosts. Serialisieren Sie schwere Builds/Profiling auf eingeschränkten Rechnern. Schließen Sie nur Fenster, Apps, Geräte und Dienste, die für diese Aufgabe gestartet wurden und nicht mehr benötigt werden. Bewahren Sie vorhandene Benutzerarbeit und erforderliche Dienste. Halten Sie Geheimnisse und persönliche Sitzungsdaten aus Beweisen und Quellcodeverwaltung heraus. Löschen Sie Referenzbeweise nicht ohne Autorisierung; behalten Sie nützliche finale Aufnahmen und Messungen.
Aufrufbeispiele
/replicate Gleichen Sie diesen Screenshot in der bestehenden Seite ab. Achten Sie auf Typografie und Abstände./replicate Implementieren Sie diese Design-Datei, einschließlich ihrer mobilen Varianten. Bewahren Sie das bestehende Checkout-Verhalten./replicate Erstellen Sie die Player- und Suchabläufe dieser App neu. Vergleichen Sie beide Apps auf dem verbundenen Telefon./replicate Die aktuelle Implementierung hat Details aus diesem Design übersehen. Inspizieren Sie beide und schließen Sie die Genauigkeitskorrektur ab./replicate Reproduzieren Sie den Import-Workflow dieses Dienstes mit unserem Backend, einschließlich Fortschritts-, Wiederholungs- und Fehlerzuständen.