Criar Site Pessoal
Objetivo
Criar ou redesenhar um site pessoal como arquivos estáticos simples: HTML, CSS e opcionalmente JavaScript vanilla.
Esta habilidade é a etapa de implementação após uma direção visual ter sido escolhida. Ela transforma uma recomendação de tema, perfil de usuário, anotações, posts de exemplo, descrições de projetos ou uma pasta de site estático existente em um site pessoal funcional.
Promessa central:
- Sem framework.
- Sem etapa de build.
- Sem instalação de pacotes.
- Sem dependência de runtime.
- Abrir
index.htmldiretamente para visualização manual. - Usar links e ativos relativos à página para que abertura direta de arquivo, HTTP local e hospedagem estática funcionem.
- Implantar a pasta em hospedagem estática.
Para QA automatizado no navegador, sirva a pasta estática por HTTP local em vez de abrir URLs file://.
Contrato
Entradas:
- Direção de tema, materiais de perfil do usuário, necessidades de página, conteúdo de exemplo ou uma pasta estática existente.
- Referências opcionais que devem guiar o estilo sem exigir uma réplica de alta fidelidade.
- Pasta de saída desejada e restrições estáticas.
Saídas:
- Uma pasta de site estático simples com HTML, CSS, JavaScript vanilla opcional, ativos locais e tipos de página representativos.
EDITING.mdpara edições futuras quando um novo site ou reformulação material for criada.- Instruções de visualização local e resumo de validação.
Limites:
- Não recriar fielmente um site alvo específico; usar
copy-website-style. - Não importar grandes arquivos de escrita; usar
add-blog-posts. - Não publicar ou configurar hospedagem; usar
publish-static-site. - Não introduzir frameworks, instalações de pacotes, backends, CMS, autenticação ou bancos de dados, a menos que o usuário peça explicitamente.
Portão de sucesso:
- Os tipos de página necessários existem e a navegação aponta para caminhos relativos reais.
- O site funciona como arquivos estáticos simples sem etapa de build.
- O código-fonte é legível em UTF-8, os placeholders são claros e
review-static-sitepode passar ou relatar apenas limitações aceitas.
Se o portão falhar:
- Corrigir tipos de página ausentes, caminhos, ativos, codificação, placeholders ou problemas de navegador dentro desta habilidade.
- Usar
personalize-sitequando a falha for identidade/conteúdo do usuário ausente. - Usar
review-static-sitenovamente após as correções.
Pipeline Curto
Siga este pipeline para trabalho original de site pessoal:
- Esclarecer o propósito do site, direção do tema, conteúdo disponível e escopo da página.
- Decidir o mapa de páginas estáticas e a estratégia de placeholders antes de codificar.
- Construir primeiro a estrutura compartilhada: cabeçalho, navegação, layout principal, rodapé, variáveis CSS globais e interações compartilhadas.
- Implementar a página inicial e cada tipo de página solicitado ou implícito.
- Usar o conteúdo do usuário ou placeholders claramente substituíveis; não inventar identidade pessoal detalhada.
- Adicionar um guia de edição para futuras edições do modelo/usuário.
- Verificar a compatibilidade de caminhos de abertura direta com links e ativos relativos.
- Validar localmente via HTTP em um navegador real.
- Verificar links, ativos, tipos de página e legibilidade do código-fonte UTF-8 antes da entrega final.
Quando Usar
Use esta habilidade quando o usuário:
- Quiser um site pessoal, blog, página inicial, portfólio, página de pesquisa ou site estático simples em HTML/CSS/JS.
- Pedir para implementar uma direção de tema produzida por
search-blog-theme. - Quiser um site simples sem framework, fácil de inspecionar, editar e implantar.
- Quiser redesenhar um site estático existente mantendo-o livre de dependências.
- Fornecer referências visuais soltas, mas não exigir uma réplica de alta fidelidade.
Não Usar Quando
Não use esta habilidade quando:
- O usuário apenas quiser pesquisar temas ou comparar referências visuais. Usar
search-blog-theme. - O usuário quiser recriar fielmente a aparência, layout, movimento ou sensação de interação de um site específico. Usar
copy-website-style. - O usuário quiser migrar muitos posts, converter notas do Obsidian, reparar frontmatter ou mover grandes arquivos de conteúdo. Usar
add-blog-posts. - O usuário quiser apenas ajuda com implantação, DNS, GitHub Pages, Cloudflare Pages, Cloudflare Pages Direct Upload, Netlify ou Vercel. Usar
publish-static-site. - O usuário pedir explicitamente por um projeto de framework como Next.js, Astro, Hugo, Jekyll, Quartz ou React.
- O usuário pedir por um backend, banco de dados, autenticação, CMS, sistema de comentários ou comportamento dinâmico de servidor.
Entradas
Use o que o usuário fornecer. Não bloquear se alguns detalhes estiverem faltando.
Entradas úteis incluem:
- Direção de tema: arquivo de código privado, dashboard de registro de pesquisa, jardim digital, portfólio bento, caderno de campo, sistema operacional pessoal, etc.
- Perfil do usuário: nome, breve biografia, função, localização, links sociais, avatar, currículo, publicações, projetos.
- Necessidades de página: início, sobre, blog, projetos, notas, publicações, contato.
- Conteúdo de exemplo: 1-3 posts, descrições de projetos, trechos de Markdown, páginas HTML antigas.
- Pasta de site existente: arquivos HTML/CSS/JS atuais para preservar ou refatorar.
- Referências soltas: v0, Figma, temas do GitHub, templates de framework, capturas de tela ou referências de clima visual.
Regra de Referência
Referências podem vir de qualquer stack. Trate-as como referências visuais e estruturais, não como escolhas de implementação, a menos que o usuário peça explicitamente para usar aquele framework.
Para um site estático simples, traduza referências assim:
- Componentes React, Next ou Astro -> seções HTML repetidas com classes CSS reutilizáveis.
- Classes utilitárias do Tailwind -> regras CSS normais em
assets/style.css. - Rotas de framework -> arquivos
.htmlvinculados. - Coleções de conteúdo ou dados de CMS -> listas HTML estáticas ou pequenos arquivos JSON.
- Configuração de tema -> propriedades personalizadas CSS.
- Interações simples -> JavaScript vanilla apenas quando útil.
Se o usuário quiser combinar fielmente um site específico, delegar para copy-website-style em vez de tratar como referência solta.
Estrutura de Site Padrão
Para um novo site, prefira esta estrutura, a menos que o usuário peça o contrário:
site/
index.html
EDITING.md
about.html
blog.html
projects.html
posts/
first-post.html
assets/
style.css
script.js
images/
data/
posts.json
profile.json
Para um site existente, preserve a estrutura atual do usuário quando prático. Não renomeie ou reorganize grandes partes do site, a menos que melhore claramente o trabalho solicitado.
Expectativas de Página
Crie apenas as páginas necessárias para a solicitação do usuário. Para um starter de site pessoal completo, inclua:
- Início: identidade, introdução curta, área de herói específica do tema, posts recentes, projetos selecionados.
- Sobre: biografia, interesses, habilidades, contato, links sociais, CV/publicações opcionais.
- Índice do blog: lista de posts com título, data, tags e resumo.
- Página de post: layout de artigo legível com título, data, tags, conteúdo e navegação de volta ao índice do blog.
- Projetos: cards ou linhas de projetos com descrição, stack, links e resultado.
Mantenha a primeira tela útil. Não crie uma landing page de marketing quando o usuário pediu um site pessoal ou blog.
Para um starter completo de site pessoal ou blog, não pare em uma única página inicial. Crie tipos de página representativos funcionais, mesmo quando o conteúdo for apenas placeholder:
- Pelo menos uma página de artigo/detalhe para um blog.
- Uma página de lista ou arquivo quando posts, notas, projetos ou publicações fizerem parte do site.
- Uma página de perfil/sobre quando a página inicial vincular a identidade ou detalhes de formação.
- Qualquer página especial implícita pelo conceito escolhido, como notas, links, jardim, now, uses, publicações ou experimentos.
Para grandes coleções de conteúdo futuro, crie a estrutura e algumas entradas placeholder representativas em vez de inventar um arquivo completo.
Regra de Compatibilidade de Caminhos
Os sites estáticos gerados devem funcionar quando o usuário abrir index.html diretamente, quando servidos por HTTP local e quando implantados em hosts estáticos comuns.
Regras padrão:
- Usar caminhos relativos à página para todos os links e ativos locais do site.
- Das páginas raiz, vincular CSS/JS/imagens como
assets/style.css,assets/script.js,assets/images/avatar.pnge páginas comoabout.htmlouposts/example.html. - De páginas aninhadas como
posts/example.html, vincular ativos compartilhados como../assets/style.csse páginas raiz como../blog.htmlou../index.html. - Não usar caminhos absolutos de raiz do site como
/assets/style.css,/assets/script.js,/posts/example.html,/data/posts.json,/images/foo.pngou/, a menos que o usuário aceite explicitamente o comportamento apenas de raiz do servidor. - Aplicar a mesma regra para
url(...)em CSS, favicons, imagens Open Graph, imagens de capa, fontes, ativos de terceiros KaTeX/math, links RSS/sitemap e URLs geradas por JavaScript. - Ao mover ou adicionar uma página, recalcular caminhos com base na profundidade da pasta dessa página, em vez de copiar links de uma página raiz.
Evitar suposições apenas de servidor:
- Não depender de
fetch("data/posts.json")ou outras buscas de arquivo local para navegação principal, listas de posts ou conteúdo da página inicial, se a visualização de abertura direta fizer parte da promessa. - Se dados repetidos forem úteis, renderizar o conteúdo essencial diretamente em HTML ou armazenar dados em um objeto JavaScript local carregado com um
<script src="assets/script.js">relativo. - Melhorias opcionais podem usar arquivos de dados apenas quando a página ainda ler e navegar corretamente sem aquela busca.
Regras de Estilo
Deixe o tema selecionado guiar a linguagem visual, mas mantenha o site legível e sustentável.
- Colocar a estilização de todo o site em
assets/style.css. - Usar propriedades personalizadas CSS para cores, espaçamento, bordas e escolhas tipográficas.
- Usar HTML semântico quando possível:
header,nav,main,article,section,footer. - Usar regras de layout responsivo para que as páginas funcionem em dispositivos móveis e desktop.
- Tornar as páginas de artigo mais calmas do que a página inicial, se o tema for visualmente intenso.
- Preferir fontes do sistema, a menos que o usuário peça uma fonte específica ou o tema exija uma.
- Não depender de ativos remotos, a menos que o usuário os forneça ou eles sejam claramente aceitáveis.
- Não deixar efeitos decorativos bloquearem a leitura, navegação ou acessibilidade.
Regras de Interação
Usar JavaScript vanilla apenas quando agregar valor claro.
Bons usos:
- Alternância de navegação móvel.
- Alternância de tema.
- Filtragem leve de tags ou posts.
- Pequenos efeitos progressivos que não afetam a leitura principal.
Evitar:
- Frameworks de animação pesados.
- Decoração com uso intenso de Canvas, a menos que o usuário peça explicitamente.
- Efeitos que exigem um servidor de desenvolvimento ou instalação de pacote.
- Cintilação contínua, glitching agressivo ou efeitos de rolagem que prejudicam a leitura.
Respeitar prefers-reduced-motion para temas animados.
Regra de Simplificação Estática
Quando uma referência solta tiver recursos complexos ou dependentes de framework, traduzi-los em equivalentes estáticos mais simples:
- Globo 3D -> mapa de tópicos, painel de status, constelação de projetos ou bloco visual estático.
- Grid bento animado -> grid CSS responsivo com estados de hover sutis.
- Simulador de terminal -> navegação temática e conteúdo em estilo de log, não uma linha de comando falsa, a menos que útil.
- Grafo de conhecimento -> tags, posts relacionados, índice de tópicos ou links curados manualmente.
- Busca dinâmica -> entrada de filtro simples, páginas de tag estáticas ou nenhuma busca para a primeira versão.
- Posts orientados por CMS ->
posts/*.htmlmaisdata/posts.json.
Preferir uma versão estática limpa que capture a sensação desejada pelo usuário em vez de uma cópia superdimensionada da referência.
Regra de Site Existente
Ao modificar um site existente:
- Inspecionar a estrutura de arquivos atual antes de editar.
- Preservar o conteúdo do usuário e arquivos não relacionados.
- Manter as alterações limitadas às páginas e ativos solicitados.
- Reutilizar convenções visuais existentes quando já funcionarem.
- Evitar substituir o site inteiro, a menos que o usuário peça uma reformulação completa.
- Se o site já tiver
style.cssouscript.js, estendê-los com cuidado em vez de criar duplicatas conflitantes.
Regra de Conteúdo
Para pequenas quantidades de conteúdo, escrever HTML estático diretamente.
Para conteúdo repetido como posts ou projetos, usar:
- HTML estático repetido quando a lista for curta.
- Um objeto de dados JavaScript local mais renderização JavaScript vanilla quando melhorar a capacidade de manutenção.
- Um pequeno arquivo JSON apenas quando o site puder exigir HTTP local/hospedagem estática para esse recurso, e a página principal ainda funcionar sem ele.
Não inventar fatos pessoais detalhados. Usar placeholders claramente quando os dados do usuário estiverem ausentes.
Manter os placeholders fáceis de encontrar e substituir. Preferir armazenar conteúdo repetido em um local claramente nomeado, como data/*.json, um bloco de dados documentado em assets/script.js ou uma seção HTML repetida com nomes de classe estáveis.
Marcar conteúdo apenas placeholder, posts de demonstração, projetos de exemplo e links mock claramente nos arquivos ou no EDITING.md para que o usuário ou um modelo futuro possa substituí-los antes da publicação.
Regra do Guia de Edição
Ao criar um novo site ou reformular materialmente um existente, incluir EDITING.md na pasta de saída.
EDITING.md é principalmente para um modelo ou agente futuro que modificará o site gerado posteriormente. Mantê-lo conciso, mas concreto. Explicar:
- Hierarquia de pastas e para que serve cada arquivo/pasta.
- Formatos de arquivo usados pelo site: HTML, CSS, JS, blocos JSON/dados e imagens.
- Mapa de páginas: qual arquivo gerado é a página inicial, sobre/perfil, blog/lista, artigo/detalhe, projetos, notas, links ou outros tipos de página.
- Regiões de layout compartilhado: cabeçalho, navegação, navegação móvel, conteúdo principal, rodapé, barras laterais, sobreposições ou controles de tema.
- Onde cada região principal da página inicial está em
index.html, usando nomes de seção/classe próximos. - Onde cada template de subpágina está e como os links internos se conectam a ele.
- Onde o conteúdo repetido é armazenado e seu formato esperado de objeto/marcação.
- Como alterar título do site, tagline, avatar/logo, navegação, posts em destaque, listas de projetos, listas de links, imagens, cores e variáveis de tema.
- Qual conteúdo é apenas placeholder e deve ser substituído antes da publicação.
Regra de Integridade de Codificação
Os arquivos fonte gerados devem ser UTF-8 válidos e legíveis por humanos em forma de código-fonte, não apenas com aparência correta em capturas de tela do navegador.
Para páginas ou guias de edição contendo texto em chinês, japonês, coreano, latim acentuado ou outro conteúdo não-ASCII:
- Incluir
<meta charset="utf-8">nos arquivos HTML. - Escrever os arquivos como UTF-8.
- Verificar a legibilidade do código-fonte com um leitor compatível com UTF-8 antes da entrega final.