Reproduire (Replicate)
Faites de la fidélité une boucle d'implémentation axée sur les preuves. Inspectez la référence, inventoriez ses détails, implémentez, comparez, corrigez et vérifiez. Une première impression convaincante n'est pas une finition : préservez les petites relations et comportements qui rendent la référence distinctive.
Partez de la référence de l'utilisateur
- Déduisez la cible, le périmètre, la plateforme et les différences intentionnelles de la conversation. Cette compétence fonctionne pour une capture d'écran, un fichier de design, un composant, une implémentation existante, une application, un site web ou un service. N'exigez pas d'original interactif si l'utilisateur a fourni un design statique.
- Inspectez la référence réelle avant de coder. Préférez la source spécifiée par l'utilisateur ; utilisez le logiciel installé pour le comportement, les fichiers de design pour les spécifications de design explicites et les images en pleine résolution pour l'apparence rendue. Lorsque les sources divergent, enregistrez la divergence et appliquez la priorité indiquée par l'utilisateur plutôt que de les mélanger silencieusement.
- Inspectez l'implémentation existante et les instructions du projet. Préservez les fonctionnalités fonctionnelles et les modifications de l'utilisateur. Si la tâche est une correction de fidélité, corrigez le design existant au lieu d'inventer une nouvelle direction.
- Ne demandez que les informations manquantes qui bloquent une progression significative. Si l'accès à l'original n'est pas disponible, continuez avec les preuves disponibles et indiquez ce qui ne peut pas être vérifié. N'inventez jamais d'observations.
- Établissez un ensemble limité de flux ou d'états et de critères d'acceptation. N'interprétez pas « reproduire » comme une autorisation à acheter, publier, contacter d'autres personnes, copier des identifiants ou modifier des données de service non liées.
Inspectez avant de simplifier
Créez un inventaire compact de la référence en utilisant evidence-template.md. Pour un petit composant, cela peut être quelques lignes ; ne transformez pas une petite modification en un gros projet de documentation.
Inspectez l'ensemble de la référence, puis les régions individuelles. Enregistrez séparément les faits observés, les mesures, les estimations et les inconnues. Ne remplacez pas des détails inhabituels par des valeurs par défaut familières simplement parce qu'ils sont plus faciles à implémenter.
Inspectez les détails applicables :
- Disposition : alignement, conteneur, grille, marges, padding, espacements, proportions, superposition, rognage, zones de sécurité et éléments fixes/sticky.
- Typographie : famille de police, graisse, taille, hauteur de ligne, suivi, ligne de base, habillage, troncature et alignement. La longueur du texte et le contenu réel font partie de la disposition.
- Surfaces : couleurs échantillonnées, dégradés, transparence, matériaux, bordures, traitement des coins, ombres, recadrage d'illustration, forme/poids de l'icône et alignement optique.
- États : sélectionné, focus, pressé, chargement, vide, erreur, désactivé, développé, défilé et clavier visible ; variantes clair/sombre ou responsives si dans le périmètre.
- Comportement : zones de toucher, navigation, comportement de retour, rétention d'état, champ de recherche, menus, défilement, overscroll, défilement rapide et gestes interrompus.
- Animation : déclencheur, délai, durée, easing/ressort, trajectoire, dépassement, fondu, mise à l'échelle, ancrage, interruption et retour au repos.
- Flux de service : contrats d'entrée/sortie, ordonnancement, persistance, tentatives, erreurs, latence et effets secondaires visibles pour l'utilisateur. La similitude visuelle seule ne reproduit pas un service.
Pour les références statiques, faites d'abord correspondre l'apparence observable. Marquez les interactions non affichées et le comportement responsive comme inférés ; choisissez un comportement raisonnable sans prétendre qu'il a été observé. Pour les références interactives, explorez les transitions complètes, pas seulement leurs points finaux. Incluez les entrées répétées rapides et les gestes partiels/annulés lorsque cela est pertinent.
Choisissez les outils en fonction des preuves
Utilisez les outils disponibles, et non des noms ou capacités d'outils supposés. Lisez les instructions applicables des outils/compétences avant de les utiliser.
- Fichiers de design : utilisez l'intégration de design pertinente pour inspecter les nœuds, les styles, les ressources et les contraintes, ainsi que les aperçus rendus. Exportez les ressources autorisées réelles lorsque possible plutôt que de les approximer.
- Applications : utilisez les outils Argent/device pour l'opération, les captures d'écran, les cadres d'accessibilité et les itinéraires reproductibles. Par défaut, utilisez un téléphone USB physique connecté avant d'envisager un simulateur. Appliquez les compétences de configuration/interaction de la plateforme si nécessaire.
- Sites web : utilisez les outils de navigateur disponibles pour les captures d'écran, les états de fenêtre d'affichage, les interactions et l'inspection de la disposition. Testez les largeurs responsives et les modes de saisie pertinents.
- Captures d'écran : inspectez en pleine résolution et recadrez les régions pour analyse. Mesurez en unités logiques lorsque l'échelle du dispositif est connue ; ne confondez pas les pixels de la capture d'écran avec les points de disposition.
- Animation : capturez une vidéo avec les outils d'enregistrement pris en charge et inspectez les images / feuilles de contact. Mesurez la position en fonction du temps, y compris les images de stabilisation finale. Utilisez les enregistrements pour étudier l'animation, pas pour revendiquer une FPS d'affichage qu'ils ne peuvent pas établir.
- Performance : utilisez les profileurs/Instruments natifs pour les applications natives ou les outils de performance du navigateur pour les applications web. Lisez les compétences de profilage pertinentes. Les compétences d'animation/polis sage UI complètent les preuves de la référence ; leurs préférences générales ne doivent pas ignorer le design demandé.
- Services : utilisez les API documentées, les connecteurs disponibles et les données de test contrôlées pour comparer les contrats observables. Évitez les sondes destructrices et les requêtes payantes inutiles.
Utilisez de petits scripts de mesure lorsqu'ils résolvent l'incertitude. Préférez un échantillonnage reproductible à une couleur, une police, un espacement ou un ressort deviné. N'installez pas une grosse chaîne d'outils pour une petite comparaison lorsque les outils existants suffisent.
Implémentez une tranche complète
- Reproduisez un flux ou un composant représentatif complet avec du contenu réel avant de vous étendre. Choisissez-en un qui exerce les transitions de disposition et d'état importantes.
- Codez les valeurs mesurées partagées de manière cohérente. Maintenez l'identité du composant, l'état de navigation et la disposition stables d'une transition à l'autre.
- Utilisez les mécanismes natifs/plateforme lorsqu'ils correspondent à la référence. Utilisez une implémentation de plus bas niveau uniquement lorsque l'observation ou le test démontre une inadéquation. Ne supposez pas qu'une feuille, un menu ou un ressort par défaut correspond simplement parce qu'il semble natif.
- Préservez le texte, les ressources, l'ordre et les détails visuels distinctifs. N'ajoutez pas de dégradés, de décoration, de sections d'espace réservé, de modifications de copie ou d'« améliorations » absentes de la référence, sauf demande.
- Maintenez le comportement fonctionnel correct tout en faisant correspondre l'apparence. Le chargement, le prétraitement ou les animations ne doivent pas bloquer inutilement une action qui peut déjà être effectuée.
Comparez et corrigez
Exécutez cette boucle après chaque tranche significative :
- Mettez la référence et l'implémentation dans des états comparables : même contenu, fenêtre d'affichage/dispositif, échelle, thème, position de défilement, clavier et état des données/lecture pertinent.
- Capturez les deux. Comparez la composition complète, puis les régions. Utilisez des superpositions/différences lorsque cela est utile et inspectez les images réelles, pas seulement un score. Gardez les masques d'exclusion explicites et limités aux zones véritablement variables.
- Enregistrez les divergences concrètes, leurs preuves et leur sévérité. Corrigez d'abord les plus grandes différences structurelles, puis la typographie/les surfaces, puis l'animation et les petits détails d'interaction. Revenez à la structure si des observations ultérieures la contredisent.
- Pour l'animation, comparez la transition entière, y compris la première image, l'annulation, le dépassement, la couverture des zones de sécurité et la stabilisation finale. Recherchez des flashs, des changements d'arrière-plan tardifs, des barres qui disparaissent, un redimensionnement d'icône et une reconstruction de contenu.
- Répétez les vérifications affectées après les corrections, ainsi que les régressions comportementales pertinentes. Ne continuez pas à répéter des tests larges une fois qu'ils réussissent sans nouvelle preuve le justifiant.
Ne traitez pas une différence de pixels comme un score de similarité universel. Indiquez l'état exact, le dispositif/fenêtre d'affichage, le seuil et les masques derrière les affirmations quantitatives. Faire correspondre une capture d'écran n'établit pas une parité de produit complet. Les différences de rendu/police peuvent être des contraintes légitimes ; identifiez-les plutôt que de les cacher derrière des seuils larges.
Si ça a l'air correct mais que la sensation est erronée
Séparez la conception de l'animation de la performance d'exécution. Profilez avant de modifier les durées ou les ressorts au hasard.
- Répétez la même charge de travail représentative avant et après la modification, avec une surcharge d'observation comparable.
- Évitez les captures d'écran/requêtes d'accessibilité par image pendant les mesures sensibles au temps. Capturez les preuves visuelles séparément lorsque l'instrumentation modifie la charge de travail.
- Recherchez les transformations de données répétées, l'invalidation excessive d'état, la reconstruction de vue, les E/S synchrones, le décodage, le travail de disposition et les rappels de gestes en double.
- Modifiez le goulot d'étranglement démontré, puis vérifiez à la fois la performance et l'apparence. Conserver les vues/caches échange de la mémoire contre de la vitesse : limitez-les et gérez correctement l'invalidation et le cycle de vie.
- Rapportez ce qui a été mesuré et ses limitations. Le rééchantillonnage vidéo n'est pas la FPS de l'affichage ; des charges de travail différentes ne constituent pas une base de référence numérique valide.
Terminez avec des preuves
Complétez l'implémentation et la vérification autorisées, pas seulement un audit ou un plan, sauf si l'utilisateur a demandé uniquement des recherches.
Avant de déclarer le travail terminé :
- Chaque critère d'acceptation dans le périmètre dispose d'une preuve d'implémentation et de vérification, ou d'une limitation explicite non résolue.
- Les états statiques importants ont été comparés à la référence ; les transitions importantes ont été exercées lorsqu'elles sont observables.
- Les vérifications fonctionnelles couvrent le comportement que la modification pourrait casser. Utilisez des itinéraires reproductibles pour les flux substantiels ; évitez les tests qui ne font que répéter du code de style trivial.
- Les différences intentionnelles connues sont distinguées des défauts et des inconnues.
- Le rapport final indique ce qui a changé, ce qui a été réellement testé et les différences restantes. Liez les preuves de comparaison utiles ; ne prétendez pas être « pixel-parfait » ou avoir un « comportement exact » au-delà de ce qui a été vérifié.
Gardez à l'esprit les limites de ressources de l'hôte. Sérialsez les builds/profilages lourds sur les machines contraintes. Fermez uniquement les fenêtres, applications, dispositifs et services démarrés pour cette tâche qui ne sont plus nécessaires. Préservez le travail utilisateur existant et les services requis. Gardez les secrets et les données de session personnelles hors des preuves et du contrôle de version. Ne supprimez pas les preuves de référence sans autorisation ; conservez les captures et mesures finales utiles.
Exemples d'invocation
/replicate Fais correspondre cette capture d'écran dans la page existante. Fais attention à la typographie et à l'espacement./replicate Implémente ce fichier de design, y compris ses variantes mobiles. Préserve le comportement de checkout existant./replicate Recrée le lecteur et les flux de recherche de cette application. Compare les deux applications sur le téléphone connecté./replicate L'implémentation actuelle a manqué des détails de ce design. Inspecte les deux et termine la passe de fidélité./replicate Reproduis le flux d'importation de ce service avec notre backend, y compris les états de progression, de tentative et d'échec.