Gerador de Site Pessoal
Transforme "um currículo + uma lista de links + trabalhos dispersos" em um site estático com estrutura de informação, estilo visual e pronto para implantação.
Resultado: um conjunto de HTML/CSS/JS puramente estático (sem build, sem framework, CSS em arquivo único), diretamente implantável no Cloudflare Pages / Vercel / GitHub Pages.
Princípios Centrais
- A ordem não pode ser invertida: primeiro conteúdo → depois estrutura → depois visual → por último código. Não comece com um template ou perguntando sobre cores e fontes.
- Diferencie quatro tipos de informação: fatos confirmados pelo usuário / resumos de fontes originais / textos redigidos pela IA / inferências a serem confirmadas. Não invente experiências, números, clientes, avaliações, identidades ou relações de parceria.
- Proteja a privacidade por padrão: confirme separadamente antes de divulgar número de telefone, endereço, e-mail pessoal ou materiais de clientes.
- Não crie seções vazias para preencher o template: se faltarem informações, reduza a profundidade do conteúdo ou liste os itens ausentes, não use casos fictícios para preencher.
- Ofereça opções com recomendação: para cada ponto de decisão, forneça 2–3 opções com diferenças substanciais + uma recomendação clara, não jogue toda a escolha para o usuário.
- Implantação é uma ação de publicação: só execute com autorização explícita do usuário.
Fluxo de Trabalho
① Definir escopo → ② Coletar materiais → ③ Definir hierarquia de informações → ④ Definir estilo visual → ⑤ Gerar → ⑥ Validar → ⑦ Implantar após autorização
① Definir Escopo
Primeiro, determine se é novo site ou reforma de site existente.
- Se houver projeto: leia a estrutura de diretórios, páginas existentes, fontes de conteúdo, comandos de build, configuração de implantação e status do git; mantenha a stack técnica e as restrições de design existentes, não comece do zero.
- Novo projeto: por padrão, site estático responsivo e leve; só introduza um framework ou backend se realmente precisar de CMS, login ou dados dinâmicos.
Em seguida, faça apenas uma pergunta para definir a direção:
"Para quem é este site principalmente? O que você espera que ele(a) faça depois de vê-lo?"
Não pergunte sobre cores, fontes ou animações nesta etapa.
② Coletar Materiais
Leia references/intake.md (contém: materiais mínimos para início, ordem progressiva de perguntas, campos de entidades de conteúdo, níveis de evidência, regras de privacidade, tabela de fontes coletáveis).
Pontos importantes:
- A primeira resposta deve ser leve. O usuário já disse o que tem; na primeira resposta, peça apenas que ele envie esses materiais; depois de ler o primeiro lote, faça a próxima pergunta. Pergunte apenas uma coisa de cada vez, a que mais impacta o próximo passo, não jogue uma lista de uma dúzia de itens.
- Leia primeiro o que puder, não pergunte. Currículo (Read / docx / pdf), GitHub, blog, artigos do WeChat (WebFetch), plataformas que exigem login (claude-in-chrome). Se encontrar bloqueio de login, CAPTCHA ou anti-raspagem, pare imediatamente e peça ao usuário que forneça arquivos exportados, textos, lista de links ou capturas de tela.
- Números antes de adjetivos, e use apenas métricas verificáveis. "10 produtos, 50 mil usuários, quase 200 Skills" é melhor que "experiência rica"; não adicione estimativas para itens não verificáveis.
- Conteúdo repetido em várias plataformas combine em uma única entidade de conteúdo, mantendo links de várias fontes; se houver conflito de informações, mantenha ambas as versões para o usuário confirmar.
Após a coleta, produza uma lista de verificação de materiais (já obtidos / a confirmar / ausentes / sugestões de complemento). Aguarde a confirmação do usuário antes de prosseguir.
③ Definir Hierarquia de Informações
Leia references/architectures.md. Use uma decisão em dois eixos:
Eixo 1: Objetivo do site (escolha um objetivo principal, no máximo um secundário)
| Perfil do usuário principal | Objetivo principal |
|---|---|
| Experiência de trabalho, habilidades, formação acadêmica, buscando emprego | Conversão para recrutamento |
| Projetos / Design / Fotografia / Vídeo, muitos materiais visuais | Portfólio |
| Uma história de vida + interesses + valores, poucos produtos concretos | Apresentação pessoal |
| Artigos escritos / livros lidos / caminhos percorridos, quer arquivar | Registro de longo prazo |
| Quer receber consultorias, encomendas, mentorias, trabalhos comerciais | Captação de clientes via consultoria |
| WeChat / X / Xiaohongshu / Podcast, com seguidores e ativos de conteúdo | Página do criador de conteúdo |
| Já lançou produtos, projetos open source, quer que as pessoas usem/comprem | Desenvolvedor independente |
Eixo 2: Profundidade do conteúdo (determinada pela quantidade de materiais, não pelo desejo)
L1 Cartão de visita— Página única, apenas identidade / posicionamento / ação principal / 3 links representativos. Para materiais escassos ou lançamento rápido.L2 Camada de prova— Página inicial + páginas de detalhes de projetos/experiências. Requer contribuições pessoais, processos, resultados, materiais de mídia.L3 Sistema de conteúdo— Página inicial + detalhes + índice de categorias + arquivo + mecanismo de atualização contínua. Requer fonte de conteúdo estável e disposição para atualizar.
Se os materiais não suportam L2, vá para L1; se não houver capacidade de atualização contínua, não escolha L3.
Use o template de architectures.md para produzir 2–3 opções realmente diferentes (a diferença deve vir das tarefas do visitante, não apenas da renomeação de seções). Para cada opção, especifique: para quem é / promessa da primeira tela / ação principal / navegação / ordem da página inicial / quais materiais existentes usa / o que mais precisa / principais trade-offs. Recomende claramente uma opção. Aguarde a confirmação do usuário antes de prosseguir para o visual.
④ Definir Estilo Visual
Primeiro pergunte: "Você tem algum site ou design de que goste? Se sim, me mande o link ou uma captura de tela." Ter uma referência é muito mais preciso do que fazer o usuário escolher entre adjetivos.
Três caminhos, escolha com base no que o usuário tem:
- O usuário deu URLs de referência / capturas de tela / guias de estilo → Leia
references/style-extraction.md. De preferência, use o claude-in-chrome para abrir o site de referência e execute o script para amostrar os estilos computados reais (font stack, valores de cor, bordas arredondadas, sombras, largura do container), amostrando tanto o tema claro quanto o escuro. Se não conseguir abrir ou precisar de login, recorra à análise de captura de tela. Extraia a essência, não clone o site inteiro, não use logotipo, textos, ilustrações ou layouts originais. - O usuário mencionou uma marca ("Faz um estilo Notion", "Estilo Apple") → Chame o skill brand-design-md para obter o DESIGN.md e mapeie para as variáveis
:rootdosite.css. - O usuário não tem referências → Leia
references/visual-styles.md, escolha 2–3 direções dentre 6 estilos integrados + razões para a recomendação, cada um com valores de variáveis CSS prontos para copiar.
Se o usuário deu vários sites de referência, primeiro pergunte: "Qual deles você mais gosta da sensação? O que especificamente você gosta nos outros?" — A maioria das pessoas gosta do layout de A + da paleta de cores de B; fazer a interseção diretamente resulta em algo sem identidade.
Quando o usuário mencionar WordPress / Framer / Webflow / Notion, tome emprestada a organização da informação e a essência, mas não finja gerar um tema ou projeto para a plataforma correspondente.
Independentemente do caminho, no final, altere apenas as variáveis :root, não reescreva a parte de componentes do site.css. Escreva o código somente após a escolha.
⑤ Gerar o Site
Copie assets/starter/:
site.css— Variáveis CSS + linha de base tipográfica + componentes de cartão/lista, temas claro/escuro. Mudar estilo = mudar variáveis:root, não reescreva o arquivo inteiro.nav.js— Barra superior fixa injetada em arquivo único (alternância de tema escuro + ocultação ao rolar). Na área de configuração no topo, altereSITE_NAME/LINKS/THEME_KEY. O760pxno CSS inline deve corresponder ao--maxdosite.css.index.html— Esqueleto da página inicial. Seções adicionadas/removidas conforme o plano.
Deve atender a:
- Na primeira tela, deve aparecer o nome do usuário ou apelido comum + posicionamento + uma ação principal; apenas uma ação principal, no máximo uma ação secundária.
- A navegação reflete a arquitetura de informações confirmada, não copiando seções de templates de plataformas; 4–6 itens.
- Os trabalhos devem focar em problema / meu papel / abordagem / resultado, não apenas miniaturas.
- Os links de redes sociais devem explicar o que pode ser visto nesta plataforma, não apenas uma fileira de ícones.
- Cada página como
xxx/index.html, compartilhando/site.csse/nav.js; sem CDN, frameworks ou etapas de build. <title>,<meta name="description">, favicon, imagem de compartilhamento completos; links externos comtarget="_blank" rel="noreferrer".- Navegação suave em desktop e mobile; fluxo principal realizável via teclado; estrutura semântica e
altcompletos; suporte aprefers-reduced-motion. - Imagens: use trabalhos reais / pessoas reais / capturas de tela reais; se faltar, primeiro solicite o material; imagens geradas devem ser claramente identificadas como tal.
- Não use frases como "Este é meu site pessoal" ou "Abaixo estão meus trabalhos" como elementos de design.
Tipografia em chinês: line-height ≥ 1,7, espaçamento entre parágrafos ≥ 18px, font stack deve incluir PingFang SC. Se precisar de habilidades de design front-end mais avançadas, chame o skill frontend-design.
⑥ Validar
Leia references/delivery-checklist.md e verifique item por item. Valide pelo menos:
- Página inicial, navegação, páginas de detalhes, links externos, ação principal
- Cinco larguras: 360 / 390 / 768 / 1280 / 1440
- Nomes e títulos mais longos não transbordam; comportamento com conteúdo vazio, falha ao carregar imagem, links externos quebrados
- Console sem erros que afetem o uso; sem rolagem horizontal inesperada ou sobreposição de layout
- Ambos os temas (claro e escuro) legíveis (contraste ≥ 4,5:1)
- Sem resquícios de TODO, números fictícios ou links de teste no site
- Informações públicas consistentes com a lista confirmada pelo usuário
Use python3 -m http.server para pré-visualizar localmente, ou screenshots com claude-in-chrome, e peça ao usuário para confirmar antes da publicação.
⑦ Implantar Após Autorização
Primeiro explique onde será publicado, se é público, qual repositório/conta será usado, quais domínios ou variáveis de ambiente serão alterados; obtenha autorização explícita antes de executar.
- Se houver projeto existente, mantenha o método de implantação atual; para novos sites estáticos, priorize Cloudflare Pages / Vercel / GitHub Pages (comando de build vazio, diretório de saída definido como raiz do site).
- Primeiro construa → depois publique → verifique a URL de produção para o conteúdo crítico. Visualização bem-sucedida não significa que o domínio personalizado esteja ativo.
- Não inclua chaves, currículos originais ou dados exportados de plataformas no site.
Especificações Finais de Entrega
Liste de forma concisa: objetivo e profundidade de conteúdo selecionados / páginas implementadas e conteúdo chave / URL de acesso / resultados da validação / conteúdo ainda não público ou a ser complementado. Não use longas repetições para encobrir código, validação ou implantação incompletos.
Lista de Práticas a Evitar
- ❌ Página inicial abarrotada com todo o conteúdo — nos primeiros 3 segundos da primeira tela, diga "quem é você + o que você faz + como te encontrar", o resto é secundário
- ❌ Frases vazias como "apaixonado por tecnologia, buscando excelência" — substitua por fatos e números verificáveis
- ❌ Inventar experiências, projetos, números ou avaliações de clientes que o usuário não forneceu
- ❌ Fazer uma dúzia de perguntas de uma vez; ou pular a confirmação de materiais e planos e ir direto para o código
- ❌ Forçar L3 com materiais insuficientes, usando blogs vazios e casos fictícios para preencher
- ❌ Animações complexas, acúmulo de gradientes, uma fonte diferente para cada seção — a credibilidade de um site pessoal vem da moderação
- ❌ Copiar um site de referência inteiro e mudar o nome — extraia a essência das cores/tipografia/espaçamento, não o logotipo, textos, ilustrações ou layouts originais
- ❌ Fazer push / implantar / divulgar informações de contato sem autorização