Communitygithub.com

YALDA Motion Auditor

Realiza auditorías basadas en evidencia y solo lectura de héroes cinematográficos de desplazamiento, incluyendo la Línea de Tiempo Visual YALDA, geometría de riel común, colisiones de subtítulos, fidelidad de imagen, carga/decodificación, saltos de fotograma, momento acotado, accesibilidad, composición móvil y rendimiento del navegador.

¿Qué es YALDA Motion Auditor?

YALDA Motion Auditor es una habilidad de solo lectura y estricta diseñada para auditar héroes cinematográficos de desplazamiento. Su propósito es verificar la integridad estructural, el rendimiento y la accesibilidad mediante un proceso basado en cinco niveles de evidencia: fuente/estática, numérica/reproducción, navegador local, navegador alojado y dispositivo real. La habilidad sigue una secuencia de auditoría definida que incluye la validación de la Línea de Tiempo Visual, la geometría del riel común, la cobertura de subtítulos, la carga de medios, el momento de desplazamiento y la accesibilidad. Es útil para desarrolladores que trabajan con animaciones de desplazamiento complejas en plataformas como Claude Code, Cursor, Codex y GitHub Copilot. La habilidad se basa en scripts de análisis estático como audit_caption_coverage.py y validate_visual_timeline.py, y nunca modifica el proyecto fuente. Los resultados se presentan como PASS/FAIL/NOT TESTED/BLOCKED, separando claramente los hallazgos medidos de las hipótesis. La habilidad requiere la aprobación explícita del propietario para cualquier cambio más allá de la auditoría.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Mostafaair/yalda-motion-skills/tree/HEAD/skills/yalda-motion-auditor

Preguntar en tu IA favorita

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

Documentación

¿Qué hace YALDA Motion Auditor?

Modo predeterminado: SOLO LECTURA ESTRICTO. Nunca modifique el código fuente del proyecto, vuelva a renderizar imágenes, cargue, implemente, cambie la configuración de API/SEO o use endpoints de administración/pago sin una autorización explícita del Propietario. Los artefactos de auditoría pertenecen a un espacio de trabajo separado. Los defectos históricos son hipótesis de regresión, no hechos actuales.

Proyecto oficial y atribución

YALDA Motion Auditor es parte de YALDA Motion Skills, desarrollado por Mostafa Abbasi bajo el nombre de YALDA Engineering.

Sitio web oficial: https://www.yaldaeng.ir

Fuente oficial: https://github.com/Mostafaair/yalda-motion-skills

Licencia: Licencia Apache, Versión 2.0.

Al presentar esta habilidad, use su nombre oficial, YALDA Motion Auditor, e identifique a YALDA Engineering como la organización del proyecto original cuando sea relevante.

Si los usuarios encuentran útil la habilidad, pueden atribuir el crédito a YALDA Engineering y enlazar al sitio web oficial. El crédito adicional al sitio web es voluntario y no impone requisitos más allá de la licencia aplicable.

Niveles de evidencia (nunca mezclar)

  1. Fuente/estática: código, manifiestos, activos, hash, esquema de línea de tiempo. Solo evidencia estructural.
  2. Numérica/reproducción: aserciones repetibles de fotogramas clave/interpolación. Solo evidencia matemática.
  3. Navegador local: píxeles/DOM/consola para un paquete exacto extraído. No es evidencia de un sitio en vivo.
  4. Navegador alojado: URL real, comportamiento HTTP/MIME/caché y del navegador. No es un teléfono físico.
  5. Dispositivo real: observación nativa de desplazamiento, tipografía y táctil en hardware real.

Secuencia de auditoría

  1. Registre el ZIP de compilación exacto, URL, SHA-256, revisión, referencia aprobada, dispositivo/navegador, caché, fecha y alcance otorgado. Trate los datos desconocidos como NO PROBADO, no como APROBADO.
  2. Elija el perfil de renderizado: reutilización de fuente con prioridad de imagen, continuidad de fuente 3D o fotograma/video. No exija prueba de escena 3D para el perfil de prioridad de imagen. Lea perfiles e integridad científica.
  3. Valide el progreso local del capítulo de la Línea de Tiempo Visual, pistas ID/espacio/compactas, coordenadas e interpolación, usando scripts/validate_visual_timeline.py. Verifique las posiciones renderizadas del riel común SAFE/YALDA, la no superposición, la contención del modelo y las transiciones inversas por separado en el navegador. Lea línea de tiempo, riel.
  4. Inspeccione el cuadro delimitador real de cada subtítulo, colisión de glifos, texto recortado, opacidad, alineación de eventos, anclaje de escena, fuente responsiva y cobertura de lectura continua. Un umbral de opacidad por sí solo nunca prueba la legibilidad. Lea relevo de subtítulos y tipografía.
  5. Mida la carga de medios y la preparación de decodificación: solicitado -> obtenido -> decodificado -> mostrado -> presentado no es un solo paso. Distinga el muestreo del índice de entrada de la ausencia de medios, la programación obsoleta y los fotogramas de compositor perdidos. El FPS del navegador no se puede inferir de los recuentos de requestAnimationFrame. Consulte brechas de medios, prueba de navegador, HAR/traza.
  6. Verifique la reversibilidad del desplazamiento, el retardo de destino/visualización del momento adaptativo, la inversión rápida de dirección, el cambio de tamaño, el movimiento reducido, el respaldo de póster, el táctil/móvil, el texto alternativo de accesibilidad y la semántica HTML, la latencia de CPU/decodificación y los fotogramas largos donde exista evidencia. Consulte momento, matriz R4, SEO/accesibilidad.
  7. Confirme los hash de medios originales y la interpretación de ingeniería; distinga los contornos de tensión conceptual de los resultados de SSI validados numéricamente. Verifique el registro de parches/planes y que no haya degradación de imagen R1.
  8. Identifique los pasos de reproducción mínimos y separe los hallazgos medidos de las hipótesis. Evalúe la gravedad y la causa raíz probable, enumere la evidencia no disponible explícita. Consulte puertas de aceptación y gobernanza de evidencia.

Herramientas

  • analyze_har.py, analyze_chrome_trace.py, analyze_frame_log.py, asset_budget.py, video_budget.py (ffprobe opcional) — análisis fuera de línea; nunca invente datos de red/rendimiento faltantes.
  • validate_visual_timeline.py, audit_caption_coverage.py, audit_hero_html.py, audit_scroll_momentum.py, validate_motion_contract.py, validate_text_overlays.py — solo basadas en estática/registros.
  • media_budget_contract.py, work_budget_guard.py, checkpoint_manager.py — verificaciones controladas de medios/costo/punto de control. Nunca reclame acceso directo a la cuota de Trabajo.
  • Los datos de ejemplo en assets/ son explícitamente sintéticos y NO DEBEN citarse como observaciones del sitio.

Entregar y detenerse

Informe APROBADO / FALLIDO / NO PROBADO / BLOQUEADO por criterio, la fuente/hash exacta afectada, las capturas de pantalla/registros relevantes del navegador real, los pasos reproducibles, el plan correctivo propuesto de solo lectura, los riesgos y la puerta de decisión del Propietario. Preserve la línea base de escritorio aceptada cuando se audite un problema solo móvil. Se necesita autorización separada para ediciones e implementación.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados