Communitygithub.com

YALDA Motion Auditor

Realiza auditorias somente leitura baseadas em evidências de heróis cinematográficos com rolagem, incluindo Linha do Tempo Visual YALDA, geometria de trilho comum, colisões de legendas, fidelidade de imagem, carregamento/decodificação, pulos de quadro, momento limitado, acessibilidade, composição para dispositivos móveis e desempenho do navegador.

O que é YALDA Motion Auditor?

O YALDA Motion Auditor é uma habilidade especializada para auditoria rigorosa e somente leitura de heróis cinematográficos baseados em rolagem (scroll-driven heroes). Ele foi criado para analisar arquivos de origem, URLs de staging ao vivo, rastreamentos de renderização, arquivos HAR ou regressões, distinguindo claramente falhas medidas de hipóteses. A habilidade suporta múltiplas plataformas (código-fonte, navegador local, navegador hospedado, dispositivo real) e emprega cinco níveis de evidência para garantir relatórios precisos. Ela verifica a Linha do Tempo Visual YALDA, geometria de trilho comum, colisões de legendas, carregamento de mídia, momento de rolagem, acessibilidade, métricas de desempenho e muito mais. O auditor nunca modifica projetos, requer aprovação explícita do proprietário para quaisquer alterações e gera relatórios com status de PASS/FAIL/NOT TESTED/BLOCKED, incluindo capturas de tela e logs reproduzíveis. Faz parte do conjunto YALDA Motion Skills, desenvolvido por Mostafa Abbasi (YALDA Engineering), licenciado sob Apache 2.0.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que YALDA Motion Auditor faz?

Modo padrão: SOMENTE LEITURA ESTRITO. Nunca modifique a fonte do projeto, re-renderize imagens, faça upload, implante, altere configurações de API/SEO ou use endpoints de administrador/pagamento sem um GO explícito do Proprietário. Os artefatos de auditoria pertencem a um espaço de trabalho separado. Defeitos históricos são hipóteses de regressão, não fatos atuais.

Projeto Oficial e Atribuição

YALDA Motion Auditor faz parte do YALDA Motion Skills, desenvolvido por Mostafa Abbasi sob o nome YALDA Engineering.

Site Oficial: https://www.yaldaeng.ir

Fonte Oficial: https://github.com/Mostafaair/yalda-motion-skills

Licença: Apache License, Versão 2.0.

Ao apresentar esta habilidade, use seu nome oficial, YALDA Motion Auditor, e identifique a YALDA Engineering como a organização do projeto original quando relevante.

Se os usuários acharem a habilidade útil, eles são bem-vindos para creditar a YALDA Engineering e fornecer um link para o site oficial. Crédito adicional ao site é voluntário e não impõe requisitos além da licença aplicável.

Níveis de evidência (nunca confundir)

  1. Fonte/estático: código, manifestos, assets, hash, esquema da linha do tempo. Apenas evidência estrutural.
  2. Numérico/replay: asserções repetíveis de keyframe/interpolação. Apenas evidência matemática.
  3. Navegador local: pixels/DOM/console para um pacote extraído exato. Não é evidência de hospedagem ao vivo.
  4. Navegador hospedado: URL real, comportamento HTTP/MIME/cache e navegador. Não é um telefone físico.
  5. Dispositivo real: observação nativa de rolagem, tipografia e toque em hardware real.

Sequência de auditoria

  1. Registre o ZIP exato da build, URL, SHA-256, revisão, referência aprovada, dispositivo/navegador, cache, data e escopo concedido. Trate dados desconhecidos como NÃO TESTADO, não como PASS.
  2. Escolha o perfil de renderização: reutilização de fonte com prioridade de imagem, continuidade de fonte 3D ou quadro/vídeo. Não exija prova de cena 3D para o perfil com prioridade de imagem. Leia perfis e integridade científica.
  3. Valide o progresso local do capítulo da Linha do Tempo Visual, trilhas ID/space/compact, coordenadas e interpolação, usando scripts/validate_visual_timeline.py. Verifique as posições renderizadas dos trilhos comuns SAFE/YALDA, não sobreposição, contenção do modelo e transições reversas separadamente no navegador. Leia linha do tempo, trilho.
  4. Inspecione a caixa delimitadora real de cada legenda, colisão de glifos, texto cortado, opacidade, alinhamento de eventos, ancoragem de cena, fonte responsiva e cobertura legível contínua. Um limite de opacidade sozinho nunca prova legibilidade. Leia relé de legenda e tipografia.
  5. Meça o carregamento de mídia e a prontidão de decodificação: solicitado -> buscado -> decodificado -> exibido -> apresentado não é uma etapa. Distinga amostragem de índice de entrada de mídia ausente, agendamento obsoleto e quadros perdidos do compositor. O FPS do navegador não pode ser inferido a partir de contagens de requestAnimationFrame. Veja lacunas de mídia, teste de navegador, HAR/trace.
  6. Verifique a reversibilidade da rolagem, destino de momento adaptativo/atraso de exibição, reversão rápida de direção, redimensionamento, movimento reduzido, fallback de pôster, toque/mobile, acessibilidade alt e semântica HTML, latência de CPU/decodificação e quadros longos onde existir evidência. Veja momento, matriz R4, SEO/acessibilidade.
  7. Confirme hashes de mídia original e interpretação de engenharia; distinga contornos de estresse conceituais de resultados SSI validados numericamente. Verifique o registro de patch/plano e nenhuma degradação de imagem R1.
  8. Identifique etapas mínimas de reprodução e separe achados medidos de hipóteses. Classifique a gravidade e a causa raiz provável, liste evidências indisponíveis explícitas. Veja portões de aceitação e governança de evidências.

Ferramentas

  • analyze_har.py, analyze_chrome_trace.py, analyze_frame_log.py, asset_budget.py, video_budget.py (ffprobe opcional) — análise offline; nunca fabrique dados de rede/desempenho ausentes.
  • validate_visual_timeline.py, audit_caption_coverage.py, audit_hero_html.py, audit_scroll_momentum.py, validate_motion_contract.py, validate_text_overlays.py — apenas baseado em estático/log.
  • media_budget_contract.py, work_budget_guard.py, checkpoint_manager.py — verificações controladas de mídia/custo/checkpoint. Nunca reivindique acesso direto à cota de Trabalho.
  • Dados de fixture em assets/ são explicitamente sintéticos e NÃO DEVEM ser citados como observações do site.

Entregar e parar

Relate PASS / FAIL / NOT TESTED / BLOCKED por critério, fonte/hash exato afetado, capturas de tela/logs relevantes do navegador real, etapas reproduzíveis, plano corretivo somente leitura proposto, riscos e porta de decisão do Proprietário. Preserve a linha de base de desktop aceita quando um problema apenas para dispositivos móveis estiver sob auditoria. GO separado é necessário para edições e implantação.

Individual skills in this repo

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

Habilidades Relacionadas