Encontrar Referências de Estilo
Objetivo
Transformar uma direção de estilo de site pessoal escolhida ou vagamente descrita em referências de design concretas e verificadas antes da implementação.
Esta habilidade é uma habilidade de pesquisa e resumo de design. Ela não constrói o site e não clona um único site alvo. Ela encontra múltiplas referências reais, as inspeciona, extrai padrões de design reutilizáveis e produz um resumo pronto para construção para make-personal-site.
Contrato
Entradas:
- Direção de estilo do usuário, palavras de tema, tipo de site, público, escopo de conteúdo, referências ou restrições.
- Exemplos opcionais para incluir ou evitar, fontes de plataforma/template preferidas e estrutura alvo do site.
Saídas:
- 4-8 candidatos de referência relevantes quando disponíveis, com URLs de origem e uma breve justificativa.
- Observações de navegador ou captura de tela para referências selecionadas quando a ferramenta estiver disponível.
- Um resumo prático de referência cobrindo layout, navegação, primeira tela, lista de artigos, detalhe de artigo, áreas de projeto/sobre, cor, tipografia, imagens, movimento, interações e comportamento responsivo.
- Notas claras de "pegar emprestado" e "evitar".
- Um repasse final de construção para
make-personal-site.
Limites:
- Não implementar o site.
- Não copiar código-fonte protegido, imagens, identidade pessoal, IDs de analytics ou ativos de marca.
- Não tratar uma referência como alvo de clonagem. Se o usuário quiser um site específico copiado, encaminhar para
copy-website-style. - Não gastar tempo com instalação de frameworks ou viabilidade de construção; esta habilidade apenas estuda referências de design.
Portão de sucesso:
- A direção está fundamentada em referências concretas e é específica o suficiente para
make-personal-siteconstruir um site estático original. - A pesquisa de referências usou múltiplos ângulos de busca, não uma única palavra-chave.
- Pelo menos 3 referências fortes foram inspecionadas quando possível, a menos que o usuário tenha pedido explicitamente um rascunho rápido.
- O resumo final separa a linguagem de design reutilizável do conteúdo/identidade que não deve ser copiado.
Se o portão falhar:
- Pesquisar com palavras-chave mais amplas ou alternativas.
- Inspecionar um conjunto menor de referências mais fortes.
- Retornar para
search-blog-themese a direção ainda não estiver clara. - Fazer apenas uma pergunta concisa de preferência quando múltiplas famílias de referência levariam a sites muito diferentes.
Quando Usar
Use esta habilidade quando:
- O usuário já deu uma direção ampla, como blog técnico natural, homepage de pesquisa tranquila, arquivo de terminal retrô, site de notas aconchegante ou portfólio brutalista.
search-blog-themerecomendou uma direção, mas ainda precisa de exemplos reais antes de construir.from-idea-to-personal-siteestá prestes a construir um site original a partir de palavras de gosto em vez de uma URL de referência concreta.- O agente precisa de mais fundamentação visual antes de
make-personal-site.
Não use esta habilidade quando:
- O usuário ainda não escolheu nenhuma direção; use
search-blog-theme. - O usuário forneceu uma URL alvo e quer recriação próxima; use
copy-website-style. - O site já existe e só precisa de uma pequena alteração; use
edit-site-part.
Fluxo de Trabalho
-
Reafirmar a direção de estilo internamente como palavras-chave pesquisáveis. Entrada: gosto do usuário e propósito do site. Saída: 5-10 frases de pesquisa em múltiplos ângulos. Portão: as frases de pesquisa cobrem humor, tipo de site, sistema visual, estrutura e pelo menos uma paráfrase alternativa.
-
Pesquisar referências reais. Entrada: frases de pesquisa. Saída: sites candidatos, templates, portfólios, blogs, páginas de design ou demos no GitHub. Portão: usar pelo menos 3 ângulos de busca distintos antes de decidir as referências, a menos que o usuário tenha pedido explicitamente um rascunho rápido.
-
Inspecionar referências selecionadas. Entrada: principais candidatos. Saída: observações de navegador/captura de tela. Portão: pelo menos 3 referências fortes são inspecionadas quando possível; usar 4-6 quando a direção for ampla.
-
Extrair padrões de design. Entrada: referências inspecionadas. Saída: padrões reutilizáveis e antipadrões. Portão: as notas são sobre layout, hierarquia, interação, tipografia, cor, densidade de conteúdo e comportamento responsivo, não apenas vibes.
-
Sintetizar um resumo de construção. Entrada: padrões de referência mais restrições do usuário. Saída: um resumo conciso de design para
make-personal-site. Portão: o resumo é específico o suficiente para ser implementado sem outra passada de pesquisa.
Orientação de Pesquisa
Construir pesquisas a partir de combinações de:
- Tipo de site: site pessoal, blog pessoal, portfólio, homepage de pesquisa, jardim digital, site de notas, blog de desenvolvedor.
- Humor: natural, calmo, editorial, aconchegante, cru, brutalista, terminal, arquivo, caderno, jardim, minimalista, lúdico, científico.
- Estrutura: homepage de blog, índice de artigos, grade de projetos, navegação lateral, bento, linha do tempo, arquivo de notas, página "agora".
- Fontes: templates v0, comunidade Figma, temas GitHub, sites pessoais, exemplos de Astro/Hugo/Jekyll/Quartz, sites de inspiração de design.
Preferir frases específicas em vez de vagas. Por exemplo:
- site pessoal de desenvolvedor natural
- blog técnico calmo site pessoal
- jardim digital design inspirado na natureza
- homepage de pesquisa site pessoal minimalista
- template de blog pessoal notas projetos
Não parar após uma frase de pesquisa ou o primeiro resultado atraente. Para uma direção como homepage técnica cyberpunk, pesquisar em múltiplos ângulos, como:
- site pessoal de desenvolvedor cyberpunk
- blog técnico futurista site pessoal
- portfólio cyberpunk terminal
- site pessoal brutalista neon
- homepage pessoal interface sci-fi
Usar busca na web atual para referências porque templates, portfólios e exemplos de design mudam com o tempo.
Inspeção no Navegador
Para cada referência forte, inspecionar a página ao vivo com uma ferramenta de navegador interativa realmente disponível. "Disponível" significa que está exposta na lista de ferramentas chamáveis do turno atual. No Codex, isso pode ser o plugin Browser/navegador no aplicativo quando roteado para o turno; em outros agentes, pode ser um navegador visível equivalente, ferramenta browser-use ou navegador com suporte a devtools.
Se nenhuma ferramenta de navegador interativa for chamável, não fingir que a referência foi inspecionada visualmente em um navegador. Pedir ao usuário para ativar ou invocar a ferramenta de navegador se a fidelidade da referência visual for importante; para Codex, isso pode significar enviar uma solicitação que mencione explicitamente @browser. Se o usuário não redirecionar ou o cliente não tiver tal ferramenta, recorrer a Playwright, capturas de tela, trechos de resultados de busca, páginas fonte ou descrições escritas e declarar a limitação.
Não usar Playwright, revisão apenas com capturas de tela ou trechos de resultados de busca como padrão quando uma ferramenta de navegador interativa for realmente chamável. Capturas de tela podem ser capturadas como evidência após a passada interativa no navegador, mas não substituem a inspeção interativa. Usar Playwright apenas como fallback quando nenhuma ferramenta de navegador interativa for chamável, quando o usuário pedir explicitamente ou quando uma comparação repetível e scriptada for especificamente necessária.
Verificar:
- Primeiro viewport: o que é imediatamente útil?
- Navegação: navegação superior, navegação lateral, comando/menu, tags, pesquisa, links de arquivo.
- Modelo de conteúdo: posts, notas, projetos, sobre, links, registros, agora, jardim, currículo.
- Experiência de leitura: largura do artigo, tipografia, blocos de código, matemática, imagens, notas de rodapé, índice.
- Sistema visual: paleta, espaçamento, raio de borda, densidade, cards, divisores, textura, imagens.
- Movimento e interação: estados de hover, alternância de tema, filtros, pesquisa, efeitos de rolagem, transições de página.
- Comportamento responsivo: o que deve acontecer no celular?
- Risco: o que se tornaria muito difícil de ler, muito genérico, muito pesado ou muito próximo da fonte?
Se a ferramenta de navegador não estiver disponível, usar páginas fonte, trechos de resultados de busca, capturas de tela e notas escritas, e declarar que a inspeção visual foi limitada.
Forma da Saída
Manter a resposta natural e útil. Não expor um longo log de processo oculto.
Incluir:
- Recomendação curta: a direção mais forte para construir.
- Referências: 4-8 itens com URL/fonte e por que cada um importa.
- Pegar emprestado: padrões concretos para adaptar.
- Evitar: coisas para não copiar ou que prejudicariam o site do usuário.
- Resumo de construção: a direção exata para
make-personal-site. - Repasse: próxima habilidade recomendada e quaisquer restrições de fonte.
Quando o usuário pedir uma resposta rápida, comprimir a saída para as melhores 3-5 referências e um resumo.
Requisitos do Resumo de Construção
O resumo final deve especificar:
- Identidade do site: como o site deve parecer em uma frase.
- Escopo de páginas: home, índice de blog, detalhe de post, projetos, sobre, notas/registros, links ou outras páginas.
- Primeira tela: qual conteúdo útil aparece imediatamente.
- Layout: navegação, colunas de conteúdo, barras laterais, cards/listas, estrutura de arquivo.
- Sistema visual: paleta de cores, estilo de tipo, espaçamento, bordas, imagens, estilo de ícone.
- Interações: alternância de tema, filtro/pesquisa, botões de cópia, estados de hover, movimento opcional.
- Comportamento responsivo: navegação móvel e prioridade de conteúdo.
- Não copiar: identidade pessoal original, artigos, ativos, logotipos, código proprietário, analytics ou tratamento exato de marca.
Repasse
Após o resumo estar pronto:
- Rotear construções de site original para
make-personal-site. - Rotear recriações próximas de um único site para
copy-website-style. - Rotear escolhas de direção não resolvidas de volta para
search-blog-theme.