Replay to Replica
Übersetze beobachtetes Produktverhalten in einen implementierbaren, unabhängig ausgedrückten Vertrag und verifiziere dann die neue Implementierung, indem dieselben Benutzeraufgaben erneut abgespielt werden. Optimiere für Verhaltensklarheit, nicht für visuelle oder Code-Imitation.
Grenzen
Dieser Skill unterstützt autorisierte Black-Box-Beobachtung und Clean-Room-Übergabe. Er begründet selbst keine rechtliche Compliance. Respektiere Lizenzen, Bedingungen, Patente, Datenschutz und vertragliche Beschränkungen. Nicht:
- Authentifizierung, Zahlung, Ratenbegrenzungen, Verschlüsselung oder technische Kontrollen umgehen;
- auf Daten oder Funktionen zugreifen, auf die der Benutzer nicht autorisiert ist;
- Quellcode, dekompilierten Code, geschützte Assets, Marken, urheberrechtlich geschützte Inhalte, versteckte Identifikatoren oder vertrauliche Daten in das Implementierungspaket kopieren;
- eine strenge rechtliche Clean-Room-Trennung behaupten, wenn dieselbe Person oder derselbe Agent geschützte Implementierungsdetails gesehen hat.
Wenn eine strenge Trennung erforderlich ist, teile die Arbeit auf: Eine Beobachtungsrolle erstellt ein normalisiertes Verhaltenspaket, und eine separate Implementierungsrolle erhält nur dieses Paket.
Wähle das gewünschte Ergebnis
Kläre, welches Ergebnis benötigt wird:
- Nur Verhaltenspaket — Spezifikationen und Abnahmeszenarien.
- Implementierungsübergabe — Verhaltenspaket plus baureife Aufgaben und Schnittstellen.
- Verifizierte Replikation — Unabhängige Implementierung plus erneute Paritätstests.
Erweitere „Analysiere dieses Produkt“ nicht zum Bau eines Klons, es sei denn, der Benutzer hat eine Implementierung angefordert.
Initialisiere ein Arbeitspaket mit:
python3 scripts/init_replica_pack.py <Ausgabeverzeichnis> --product "<beobachtetes Produkt>" --replica "<neues Produkt>"
Phase 1: Umfang und Autorisierung definieren
Dokumentiere:
- autorisiertes Ziel und Zugriffsmethode;
- beabsichtigtes unabhängiges Produkt und Benutzer;
- zu erhaltende Verhaltensweisen;
- Verhaltensweisen, Branding, Daten und Assets, die ausgeschlossen werden sollen;
- unterstützte Plattform und Testumgebung;
- ob Laufzeitinteraktion oder Kontoaktionen eine erneute Zustimmung erfordern;
- die Paritätsschwelle: exakter Vertrag, funktional äquivalent oder absichtlich geändert.
Erstelle aufgabenbasierten Umfang, nicht „kopiere die ganze App“. Beginne mit den kleinsten wertvollen Benutzerreisen.
Phase 2: Als Benutzer beobachten
Erfasse für jede Reise:
- Startzustand und Voraussetzungen;
- Benutzeraktion;
- unmittelbar beobachtbare Antwort;
- resultierenden Zustand und persistierte Daten;
- Fehler, Verzögerungen, Grenzen und Wiederherstellungspfade;
- Beweispfad und Umgebung;
- epistemisches Label:
observed,derivedoderinferred.
Setze das Ziel zwischen Durchläufen zurück, wenn der Zustand das Verhalten beeinflussen könnte. Wiederhole variables oder zeitkritisches Verhalten ausreichend, um Bereiche zu identifizieren, anstatt eine einzelne Stichprobe als Regel zu behandeln.
Beobachtungsbeweise können Aufzeichnungen, Screenshots, Barrierefreiheitsbäume, öffentliches Netzwerkverhalten, exportierte Dateien, benutzersichtbare Logs und dokumentierte APIs umfassen. Verwende verfügbare Inspektionswerkzeuge nur innerhalb der Autorisierung. Interne Implementierungsdetails sind für einen Verhaltensvertrag nicht notwendig.
Lies references/observation-and-spec.md, wenn du das Verhaltenspaket schreibst.
Phase 3: In einen Verhaltensvertrag normalisieren
Beschreibe das Verhalten unabhängig von der ursprünglichen Oberfläche und Formulierung. Der Vertrag sollte definieren:
- Akteure und Berechtigungen;
- Entitäten, Identifikatoren und Beziehungen;
- Zustände und gültige Übergänge;
- Aktionen, Eingaben, Ausgaben, Nebenwirkungen und Invarianten;
- Validierungs- und Fehlerverhalten;
- Persistenz, Ordnungs-, Zeitplanungs- und Nebenläufigkeitsregeln, soweit sichtbar;
- externe Integrationsgrenzen;
- Barrierefreiheits- und Plattformerwartungen;
- beabsichtigte Unterschiede.
Jede nicht triviale Regel benötigt einen Beweisverweis oder ein explizites Inferenzlabel. Sich widersprechende Beobachtungen bleiben ungelöst, bis sie getestet werden; wähle nicht stillschweigend die bequeme Interpretation.
Phase 4: Eine saubere Implementierungsübergabe erstellen
Die Implementierungsübergabe kann enthalten:
behavior-spec.yaml
state-model.md
data-contracts.md
acceptance-scenarios.md
implementation-handoff.md
source-observations.csv
Schreibe Namen, Text, visuelle Identität und Domänenbeispiele für das neue Produkt um. Schließe ursprüngliche Assets und interne Identifikatoren aus. Gib Schnittstellen und Ergebnisse an, nicht die vermutete Quellarchitektur.
Lies references/clean-room-handoff.md, bevor du das Paket einem Implementierungsagenten übergibst.
Phase 5: Unabhängig implementieren
Wähle Technologie basierend auf den Einschränkungen des neuen Produkts, nicht auf Vermutungen über den ursprünglichen Stack. Erhalte Verhaltensverträge, während unterschiedliche Architektur, Algorithmen, visuelles Design und Datenstrukturen erlaubt sind.
Führe ein Implementierungsentscheidungsprotokoll für bewusste Unterschiede. Ändere die Verhaltensspezifikation nicht nur, um eine fehlschlagende Implementierung konform erscheinen zu lassen; aktualisiere die Spezifikation nur, wenn eine neue Beobachtung sie widerlegt oder der Benutzer eine Produktänderung genehmigt.
Phase 6: Erneut abspielen und vergleichen
Wandle Abnahmeszenarien wo praktikabel in ausführbare Tests um. Führe dieselben normalisierten Aktionen gegen das Original und die Replikation aus und vergleiche dann die benutzersichtbaren Ergebnisse.
Klassifiziere jedes Szenario:
match— alle erforderlichen Beobachtungen stimmen innerhalb der erklärten Toleranz überein;acceptable-difference— unterscheidet sich absichtlich und ist genehmigt/dokumentiert;mismatch— widerspricht dem Verhaltensvertrag;unverified— eine Seite konnte nicht ausgeführt werden oder die Beweise sind unzureichend.
Für strukturierte Ereignisspuren verwende:
python3 scripts/compare_traces.py original.json replica.json --output parity-report.md
Lies references/parity-testing.md, wenn du Normalisierung, Toleranzen oder Veröffentlichungsbedingungen entwirfst.
Abschlussbedingung
Bezeichne die Replikation erst dann als abgeschlossen, wenn:
- jedes veröffentlichungsblockierende Szenario
matchoder ein genehmigtesacceptable-differenceist; - ungelöste abgeleitete Regeln offengelegt werden;
- das neue Produkt keine kopierten geschützten Assets oder Identität enthält;
- ein Benutzer die Kernreise in der beabsichtigten Umgebung ausführen kann;
- der Paritätsbericht auf überprüfbare Beweise verweist.
Ein Abschlussbericht muss Umfang, Autorisierungsgrenze, beobachtete Abdeckung, Inferenzen, beabsichtigte Unterschiede, Abweichungen, unverifizierte Bereiche und das genaue getestete Implementierungsartefakt angeben.