Extractor de Estilos Frontend
Objetivo
Producir un Paquete de Sistema de Diseño Portátil v1.0.0 respaldado por evidencia y neutral en cuanto al framework, a partir de un frontend fuente. La salida es un contrato de entrega para frontend-style-adapter, NO código fuente copiado y NO un clon pixel-perfect.
Lee references/CONTRACT.md antes de escribir el paquete. Lee references/INSPECTION_CHECKLIST.md durante la inspección. No inventes valores de estilo ni representes patrones inferidos como hechos observados.
Entradas
- Fuente: raíz del repositorio / espacio de trabajo, directorios seleccionados o un sitio web renderizado accesible.
- Opcional: páginas/componentes específicos, temas, puntos de quiebre, fidelidad de diseño, ruta de salida.
- Valores predeterminados: fuente = repositorio actual; alcance = UI compartida representativa + rutas/páginas descubribles en el repositorio; salida =
design-system/portable/dentro del repositorio fuente (a menos que el usuario solicite otra ubicación). - Una URL pública sin CSS fuente accesible ni estilos computados es una fuente solo visual. Marca las mediciones exactas de píxeles/colores/espaciado como inferidas a menos que sean medibles mediante herramientas. Si el entorno no puede abrir el sitio web, explica la limitación en lugar de inventar un análisis.
Flujo de trabajo
- Orientarse sin modificar la fuente. Verifica el estado de git, la estructura del proyecto, el manifiesto del paquete, el framework y la pila de estilos, la estructura de rutas/páginas, los estilos globales, los proveedores de temas, las bibliotecas de componentes y los tokens de diseño. Respeta
AGENTS.mdy las instrucciones del repositorio. Nunca leas.env, secretos ni datos irrelevantes. - Ejecutar el inventario heurístico opcional (solo stdlib; no es un analizador CSS autorizado):
python3 <skill-root>/scripts/style_inventory.py <source-root> --out <temporary-path>/style-inventory.jsonUsa una ruta temporal fuera del repositorio si es posible. Lee el resumen; verifica las afirmaciones importantes directamente en el código/UI renderizada. - Muestrear la UI representativa: caparazón global, navegación, encabezados/texto, botones, campos/formularios, tarjetas, tablas, modales, alertas, estados de carga/vacío/error; inspecciona escritorio y móvil, hover/focus/disabled, claro/oscuro si es compatible. Muestrea rutas comunes e inusuales. Registra las superficies inspeccionadas y omitidas.
- Resolver la jerarquía de reglas: tokens/configuración explícita → componentes compartidos → patrones de página repetidos → excepciones únicas. No confundas el diseño de una sola página con una regla global. Conserva tokens semánticos y alias (por ejemplo,
var(--brand-primary)) cuando sean significativos; indica los valores reales resueltos solo si están verificados. - Registrar la procedencia: cada token y cada regla estructurada necesita
origin,confidenceyevidenceconcreta. Prefiere ruta de archivo + línea/símbolo, observación de estilo computado o referencia de captura de pantalla/viewport. Cada inferencia no respaldada debe etiquetarse como tal. Indica cualquier limitación, páginas no inspeccionadas, incertidumbre sobre licencias de dependencias/activos. - Redactar el paquete en la ruta de salida elegida. Archivos requeridos:
manifest.json,tokens.json,rules.json,README.md,typography.md,layout-rules.md,component-rules.md,interaction-rules.md,responsive-rules.md. Opcionalassets.mdpara consideraciones de iconos/imágenes/fuentes. Consultareferences/CONTRACT.mdyassets/example-bundle/para la estructura; reemplaza TODO el contenido de ejemplo con observaciones específicas de la fuente. Usa lenguaje portátil (contratos de componentes e intención de diseño) en lugar de una implementación específica del framework como única descripción. - Validar:
python3 <skill-root>/scripts/validate_bundle.py <bundle-path>. Corrige todos los errores. Inspecciona manualmente los elementos de baja confianza o desconocidos. No afirmes que se probó la fidelidad visual si no se realizó una comparación de navegador/captura de pantalla. - Informar: fuente y superficies inspeccionadas, método de framework/estilo, ruta de salida, recuentos de tokens/reglas, cobertura/incertidumbres, resultado del validador y uso de entrega: invoca
frontend-style-adaptercon la ruta del sistema de diseño.
Restricciones estrictas
- Extraer lenguaje de diseño, no lógica de negocio, copia, activos propietarios o detalles internos de implementación.
- No modificar la fuente de la aplicación, instalar paquetes, reescribir la configuración ni hacer commit automáticamente. Crear el paquete solicitado está permitido.
- No copiar logotipos, archivos de fuentes, imágenes/iconos con licencia en el paquete a menos que el usuario lo autorice explícitamente y los derechos estén claros; en su lugar, describe su apariencia, referencias originales y advertencias de licencia.
- No transferir
.env, credenciales, datos de usuario, respuestas de API en vivo ni secretos. - Conservar temas claro/oscuro separados y reglas responsivas si existen; no aplanarlos en un solo estilo.
- Los detalles exactos de implementación pertenecen a la
evidence/notas; los requisitos deben permanecer portátiles entre frameworks. - Preferir claridad a volumen: patrones documentados de alto valor superan a cientos de tokens no respaldados.
- Si no hay una UI/navegador ejecutable disponible, informa
visualVerification: "not_performed"en el manifiesto.
Hecho cuando
El paquete valida; cada hecho exportado es rastreable; las reglas globales están separadas de las excepciones; los estados de accesibilidad/responsividad están cubiertos; y el informe indica las brechas conocidas.