O que Extrator de Estilos de Frontend faz?
Objetivo
Produzir um Pacote de Sistema de Design Portátil v1.0.0 baseado em evidências e neutro em relação a frameworks, a partir de um frontend fonte. A saída é um contrato de entrega para frontend-style-adapter, NÃO é código fonte copiado e NÃO é um clone pixel-perfect.
Leia references/CONTRACT.md antes de escrever o pacote. Leia references/INSPECTION_CHECKLIST.md durante a inspeção. Não invente valores de estilo nem represente padrões inferidos como fatos observados.
Entradas
- Fonte: raiz do repositório / espaço de trabalho, diretórios selecionados ou um site renderizado acessível.
- Opcional: páginas/componentes específicos, temas, breakpoints, fidelidade de design, caminho de saída.
- Padrões: fonte = repositório atual; escopo = UI compartilhada representativa + rotas/páginas detectáveis no repositório; saída =
design-system/portable/dentro do repositório fonte (a menos que o usuário solicite outro local). - Uma URL pública sem CSS fonte acessível ou estilos computados é uma fonte apenas visual. Marque medições exatas de pixel/cor/espaçamento como inferidas, a menos que sejam mensuráveis por ferramentas. Se o ambiente não puder abrir o site, explique a limitação em vez de fabricar a análise.
Fluxo de Trabalho
- Oriente-se sem alterar a fonte. Verifique status do git, estrutura do projeto, manifesto de pacotes, framework e pilha de estilização, estrutura de rotas/páginas, estilos globais, provedores de tema, bibliotecas de componentes e tokens de design. Respeite
AGENTS.mde instruções do repositório. Nunca leia.env, segredos ou dados irrelevantes. - Execute o inventário heurístico opcional (apenas stdlib; não é um parser CSS autoritativo):
python3 <skill-root>/scripts/style_inventory.py <source-root> --out <temporary-path>/style-inventory.jsonUse um caminho temporário fora do repositório, se possível. Leia o resumo; verifique afirmações importantes diretamente no código/UI renderizada. - Amostre a UI representativa: shell global, navegação, títulos/texto, botões, campos/formulários, cards, tabelas, modais, alertas, estados de carregamento/vazio/erro; inspecione desktop e mobile, hover/foco/desabilitado, claro/escuro se suportado. Amostre tanto rotas comuns quanto incomuns. Registre superfícies inspecionadas vs ignoradas.
- Resolva hierarquia de regras: tokens explícitos/configuração → componentes compartilhados → padrões de página repetidos → exceções isoladas. Não confunda o layout de uma única página com uma regra global. Preserve tokens semânticos e aliases (ex.
var(--brand-primary)) quando significativos; declare valores resolvidos reais apenas se verificados. - Registre proveniência: cada token e cada regra estruturada precisa de
origin,confidenceeevidenceconcreta. Prefira caminho de arquivo + linha/símbolo, observação de estilo computado ou referência de screenshot/viewport. Qualquer inferência não suportada deve ser rotulada como tal. Indique limitações, páginas não inspecionadas, incertezas sobre licenciamento de dependências/ativos. - Elabore o pacote no caminho de saída escolhido. Arquivos obrigatórios:
manifest.json,tokens.json,rules.json,README.md,typography.md,layout-rules.md,component-rules.md,interaction-rules.md,responsive-rules.md. Opcional:assets.mdpara considerações sobre ícones/imagens/fontes. Vejareferences/CONTRACT.mdeassets/example-bundle/para formato; substitua TODO o conteúdo de exemplo por observações específicas da fonte. Use linguagem portátil (contratos de componente e intenção de design) em vez de implementação específica de framework como única descrição. - Valide:
python3 <skill-root>/scripts/validate_bundle.py <bundle-path>. Corrija todos os erros. Inspecione manualmente itens desconhecidos/de baixa confiança. Não afirme que a fidelidade visual foi testada se nenhuma comparação de navegador/captura de tela foi realizada. - Relate: fonte e superfícies inspecionadas, framework/método de estilização, caminho de saída, contagens de tokens/regras, cobertura/incertezas, resultado do validador e instruções de uso: invoque
frontend-style-adaptercom o caminho do sistema de design.
Restrições rígidas
- Extraia linguagem de design, não lógica de negócio, cópia, ativos proprietários ou detalhes de implementação interna.
- Não modifique o código fonte do aplicativo, instale pacotes, reescreva configuração ou faça commit automaticamente. Criar o pacote solicitado é permitido.
- Não copie logotipos, binários de fontes, imagens/ícones licenciados para o pacote, a menos que o usuário autorize explicitamente e os direitos estejam claros; em vez disso, descreva sua aparência, referências originais e ressalvas de licenciamento.
- Não transfira
.env, credenciais, dados de usuário, respostas de API ativas ou segredos. - Preserve temas escuro/claro separados e regras responsivas se existirem; não os achate em um único estilo.
- Detalhes exatos de implementação pertencem a
evidence/notas; requisitos devem permanecer portáteis entre frameworks. - Prefira clareza a volume: padrões documentados de alto valor superam centenas de tokens não suportados.
- Se nenhuma UI/navegador executável estiver disponível, reporte
visualVerification: "not_performed"no manifesto.
Pronto quando
O pacote valida; cada fato exportado é rastreável; regras globais estão separadas de exceções; estados de acessibilidade/responsividade são abordados; e o relatório indica lacunas conhecidas.