Communitygithub.com

replay-to-replica

Convierte la observación autorizada de una aplicación, sitio web, flujo de trabajo de dispositivo o demostración de usuario en una especificación de comportamiento vinculada a evidencia, un handoff de implementación independiente, escenarios de aceptación ejecutables y un informe de paridad.

¿Qué es replay-to-replica?

Replay to Replica es un skill diseñado para equipos de desarrollo que necesitan reproducir comportamientos de productos existentes sin acceder a su código fuente, marca o activos protegidos. Este skill guía el proceso de observación autorizada, normalización de comportamientos en un contrato independiente, generación de un handoff limpio para implementación, y verificación mediante pruebas de paridad. Es ideal para entornos de ingeniería inversa ética, creación de productos compatibles o migraciones donde se debe preservar la funcionalidad sin copiar propiedad intelectual. Funciona en sistemas de terminal que soportan Python, se integra con herramientas de observación como grabaciones y árboles de accesibilidad, y automatiza la comparación de trazas con scripts. No debe usarse para eludir controles de acceso, extraer secretos ni crear clones no autorizados.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wangjunyu86/replay-to-replica/tree/HEAD

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Replay to Replica

Traduce el comportamiento observado de un producto a un contrato implementable e independientemente expresado, luego verifica la nueva implementación reproduciendo las mismas tareas de usuario. Optimiza para claridad de comportamiento, no para imitación visual o de código.

Límite

Este skill admite observación autorizada en caja negra y handoff estilo sala limpia. No establece cumplimiento legal por sí mismo. Respeta licencias, términos, patentes, privacidad y restricciones contractuales. No:

  • eludir autenticación, pago, límites de tasa, cifrado o controles técnicos;
  • acceder a datos o funciones para los que el usuario no está autorizado;
  • copiar código fuente, código descompilado, activos propietarios, marcas registradas, textos publicitarios, identificadores ocultos o datos confidenciales en el paquete de implementación;
  • reclamar separación estricta de sala limpia cuando la misma persona o agente vio detalles de implementación protegidos.

Si la separación estricta importa, divide el trabajo: un rol de observación produce un paquete de comportamiento normalizado, y un rol de implementación separado recibe solo ese paquete.

Elige el resultado solicitado

Aclara qué resultado se necesita:

  • Solo paquete de comportamiento — especificaciones y escenarios de aceptación.
  • Handoff de implementación — paquete de comportamiento más tareas listas para construir e interfaces.
  • Réplica verificada — implementación independiente más pruebas de paridad reproducidas.

No expandas "analiza este producto" para construir un clon a menos que el usuario haya solicitado implementación.

Inicializa un paquete de trabajo con:

python3 scripts/init_replica_pack.py <directorio-de-salida> --product "<producto observado>" --replica "<nuevo producto>"

Fase 1: Definir alcance y autorización

Registra:

  • objetivo autorizado y método de acceso;
  • producto independiente y usuario previsto;
  • comportamientos a preservar;
  • comportamientos, marca, datos y activos a excluir;
  • plataforma compatible y entorno de prueba;
  • si la interacción en tiempo de ejecución o las acciones de cuenta requieren consentimiento renovado;
  • el umbral de paridad: contrato exacto, funcionalmente equivalente o modificado intencionalmente.

Crea un alcance basado en tareas en lugar de "copiar toda la aplicación". Comienza con los recorridos más pequeños y valiosos.

Fase 2: Observar como usuario

Para cada recorrido, captura:

  1. estado inicial y prerrequisitos;
  2. acción del usuario;
  3. respuesta inmediatamente observable;
  4. estado resultante y datos persistidos;
  5. errores, demoras, límites y caminos de recuperación;
  6. ruta de evidencia y entorno;
  7. etiqueta epistémica: observed (observado), derived (derivado) o inferred (inferido).

Reinicia el destino entre ejecuciones cuando el estado pueda afectar el comportamiento. Repite el comportamiento variable o sensible al tiempo lo suficiente para identificar rangos en lugar de tratar una muestra como regla.

La evidencia de observación puede incluir grabaciones, capturas de pantalla, árboles de accesibilidad, comportamiento de red público, archivos exportados, registros visibles para el usuario y API documentadas. Usa las herramientas de inspección disponibles solo dentro de la autorización. Los detalles de implementación interna no son necesarios para un contrato de comportamiento.

Lee references/observation-and-spec.md al escribir el paquete de comportamiento.

Fase 3: Normalizar en un contrato de comportamiento

Describe el comportamiento de manera independiente de la interfaz original y la redacción. El contrato debe definir:

  • actores y permisos;
  • entidades, identificadores y relaciones;
  • estados y transiciones válidas;
  • acciones, entradas, salidas, efectos secundarios e invariantes;
  • validación y comportamiento de fallo;
  • reglas de persistencia, ordenamiento, temporización y concurrencia donde sea visible;
  • límites de integración externa;
  • expectativas de accesibilidad y plataforma;
  • diferencias intencionales.

Cada regla no trivial necesita una referencia de evidencia o una etiqueta de inferencia explícita. Las observaciones conflictivas permanecen sin resolver hasta que se prueban; no elijas silenciosamente la interpretación conveniente.

Fase 4: Producir un handoff de implementación limpio

El handoff de implementación puede incluir:

behavior-spec.yaml
state-model.md
data-contracts.md
acceptance-scenarios.md
implementation-handoff.md
source-observations.csv

Reescribe nombres, texto, identidad visual y ejemplos de dominio para el nuevo producto. Excluye activos originales e identificadores internos. Especifica interfaces y resultados, no la arquitectura de origen supuesta.

Lee references/clean-room-handoff.md antes de entregar el paquete a un agente de implementación.

Fase 5: Implementar de forma independiente

Elige la tecnología a partir de las restricciones del nuevo producto, no de suposiciones sobre la pila original. Preserva los contratos de comportamiento mientras permites arquitectura, algoritmos, diseño visual y estructuras de datos diferentes.

Mantén un registro de decisiones de implementación para diferencias deliberadas. No cambies la especificación de comportamiento solo para que una implementación fallida parezca conforme; actualiza la especificación solo cuando una nueva observación la refute o el usuario apruebe un cambio de producto.

Fase 6: Replay y comparación

Convierte los escenarios de aceptación en pruebas ejecutables cuando sea práctico. Ejecuta las mismas acciones normalizadas contra el original y la réplica, luego compara los resultados observables por el usuario.

Clasifica cada escenario:

  • match (coincide) — todos los observables requeridos concuerdan dentro de la tolerancia declarada;
  • acceptable-difference (diferencia aceptable) — difiere intencionalmente y está aprobado/documentado;
  • mismatch (discrepancia) — contradice el contrato de comportamiento;
  • unverified (no verificado) — un lado no pudo ejecutarse o la evidencia es insuficiente.

Para trazas de eventos estructuradas, usa:

python3 scripts/compare_traces.py original.json replica.json --output parity-report.md

Lee references/parity-testing.md al diseñar normalización, tolerancias o compuertas de liberación.

Compuerta de finalización

No llames completa a la réplica a menos que:

  • cada escenario bloqueante de lanzamiento sea match o una acceptable-difference aprobada;
  • las reglas inferidas no resueltas estén divulgadas;
  • el nuevo producto no contenga activos protegidos ni identidad copiados;
  • un usuario pueda ejecutar el recorrido principal en el entorno previsto;
  • el informe de paridad enlace a evidencia inspeccionable.

Un informe final debe indicar alcance, límite de autorización, cobertura observada, inferencias, diferencias intencionales, discrepancias, áreas no verificadas y el artefacto de implementación exacto probado.

Skills relacionados