Gerar Site
Visão Geral
Use esta skill para reproduzir um fluxo de trabalho cuidadoso de CV para site. O princípio chave é criar material de origem revisável antes de gerar as páginas: primeiro extraia o CV para Markdown, depois decida o que é público e, em seguida, construa o site a partir do conteúdo estruturado.
Fluxo de Trabalho
1. Inspecionar o Espaço de Trabalho
Verifique os arquivos atuais do projeto antes de editar:
- Encontre arquivos de status do fluxo de trabalho, como
WEBSITE_WORKFLOW.md,PROJECT_STATUS.mdou similares. - Encontre o arquivo de CV/perfil fonte: geralmente
.pdf,.tex,.docx, ou um CV em texto/Markdown. - Verifique se um site já existe:
package.json,astro.config.*,src/,public/,dist/. - Verifique o estado do Git levemente com
git status --shortquando útil.
Não presuma um projeto em branco.
2. Ler e Inspecionar o CV
Se a fonte for um PDF:
- Use a skill de PDF.
- Extraia texto com
pdfplumberou outra ferramenta confiável de extração de texto de PDF. - Renderize páginas como imagens quando possível e inspecione-as visualmente para que o layout e os limites das seções não sejam interpretados erroneamente.
- Espere que a extração de texto de PDF tenha artefatos de espaçamento/ícones; limpe-os manualmente na saída estruturada.
Se a fonte for LaTeX:
- Leia o arquivo
.texfonte diretamente. - Trate comandos de seção, macros e listas como estrutura.
- Não exija compilação LaTeX local a menos que o usuário peça regeneração de PDF.
Se a fonte for .docx:
- Use a skill de documentos para extrair estrutura e conteúdo.
3. Extrair para Markdown Revisável
Crie um arquivo Markdown fonte antes de construir as páginas do site. Prefira:
content/cv_extracted.md
Inclua seções estruturadas como:
- Identidade
- Contato público
- Contato/detalhes privados ou ocultos
- Perfil
- Idiomas
- Expertise técnica
- Habilidades profissionais
- Experiência profissional
- Educação
- Publicações
- Projetos
- Potencial de apresentação no site para cada projeto
Mantenha este arquivo factual. É o material de origem, não uma cópia de marketing final.
4. Perguntar ou Confirmar Decisões de Público/Privado
Antes de colocar detalhes pessoais em um site público, confirme:
- E-mail público
- Se deve mostrar número de telefone
- Se deve mostrar data de nascimento
- Se deve mostrar endereço completo
- Se deve mostrar detalhes de residência/autorização/visto/carteira de motorista
- Quais links são públicos ou ocultos: GitHub, LinkedIn, Google Scholar, ORCID, ResearchGate, etc.
- Público-alvo preferido: indústria, academia, misto, clientes, recrutadores, colaboradores
- Preferência visual: minimalista, acadêmico, portfólio técnico expressivo, etc.
Postura de privacidade padrão:
- Oculte data de nascimento, número de telefone, endereço completo, autorização de residência, carteira de motorista e detalhes sensíveis similares, a menos que o usuário explicitamente queira torná-los públicos.
- Prefira e-mail público, cidade/país e links profissionais selecionados.
5. Esboçar a Estrutura do Site
Crie um rascunho de estrutura antes de montar ou editar intensamente as páginas. Prefira:
WEBSITE_STRUCTURE_DRAFT.md
Inclua:
- Direção de design
- Público-alvo
- Navegação
- Lista de páginas
- Propósito da página
- Conteúdo sugerido por página
- Perguntas ou decisões em aberto
- Recomendação técnica
Uma boa primeira estrutura:
- Início
- Sobre
- CV
- Projetos
- Contato
Para perfis com forte foco em pesquisa, deixe espaço para páginas acadêmicas de apresentação web posteriores.
6. Montar o Site
Use Astro por padrão para um site pessoal com foco em conteúdo, a menos que o usuário solicite outra pilha.
Estrutura sugerida:
src/
pages/
index.astro
about.astro
cv.astro
projects.astro
contact.astro
content/
profile.ts
projects.ts
layouts/
BaseLayout.astro
styles/
global.css
public/
Construa o conteúdo do site a partir de arquivos fonte estruturados, não espalhando texto de CV codificado manualmente por toda parte.
Arquivos de conteúdo recomendados:
src/content/profile.tspara identidade, perfil, expertise, experiência, educação, publicações.src/content/projects.tspara entradas de projetos e notas de apresentação posteriores.
Copie ativos públicos para public/:
- CV em PDF, se o usuário quiser um CV para download.
- Imagem de retrato, se disponível e aprovada.
- Imagens de projetos ou figuras posteriormente.
7. Projetar a Primeira Versão
Para um primeiro site pessoal:
- Faça a primeira tela ser a identidade/perfil real, não uma página de destino de marketing.
- Use ativos visuais reais quando disponíveis.
- Mantenha as informações de contato com consciência de privacidade.
- Construa páginas que possam ser escaneadas rapidamente, mas expandidas posteriormente.
- Para audiências da indústria, enfatize utilidade em engenharia, fluxos de trabalho de P&D, profundidade técnica e capacidades transferíveis.
- Para audiências acadêmicas, enfatize questões de pesquisa, métodos, publicações e fluxo de apresentação.
Evite adaptar excessivamente a primeira versão. Deixe lugares claros para futuras páginas de apresentação de projetos.
8. Verificar Localmente
Execute:
npm.cmd install
npm.cmd run build
npm.cmd run dev
No Windows/PowerShell, prefira npm.cmd se npm estiver bloqueado pela política de execução de scripts.
Se a telemetria do Astro tentar escrever fora do espaço de trabalho, defina scripts em package.json como:
"dev": "set ASTRO_TELEMETRY_DISABLED=1&& astro dev",
"build": "set ASTRO_TELEMETRY_DISABLED=1&& astro build",
"preview": "set ASTRO_TELEMETRY_DISABLED=1&& astro preview"
Verifique:
- O build é bem-sucedido.
- As rotas locais retornam 200.
- Os ativos públicos carregam.
- Nenhum detalhe sensível é mostrado acidentalmente.
- A inspeção visual no navegador é realizada quando disponível, ou o usuário revisa manualmente.
9. Atualizar Arquivos de Status e Readme
Atualize um arquivo de status/dashboard se o projeto usar um, por exemplo:
PROJECT_STATUS.md
Arquivos de suporte úteis:
readme_website.txt: como editar, visualizar, construir e fazer commit do site.readme_git.txt: configuração do Git e comandos comuns.WEBSITE_WORKFLOW.md: fluxo de trabalho de longo prazo.
Mantenha o status conciso. Não adicione detalhes ruidosos do Git a menos que o usuário peça.
Expectativas de Saída
Ao final de uma primeira passagem, o projeto deve ter:
- Markdown do CV extraído.
- Rascunho da estrutura do site.
- Um site Astro funcional.
- Conteúdo separado do código de página/layout.
- Um build bem-sucedido.
- Uma URL de visualização local.
- Notas claras sobre o que ainda está pendente.