roadkwonai/resume-portfolio

Resume Portfolio

Cria o portfólio do usuário usando os templates do repositório Resume Studio. O site já está praticamente pronto; o trabalho deste skill é transferir os fatos. Em vez de criar um novo layout, o foco é preencher corretamente o arquivo content/profile.json.

Se a pasta atual contiver gallery/ e templates/, este é o Resume Studio. Caso contrário, pergunte ao usuário a localização; se não tiver feito o download, oriente a executar git clone https://github.com/roadkwonai/resume-studio.git e depois npm install. Todos os caminhos abaixo são relativos a essa pasta.

1. Coleta de Materiais e Escolha do Template

Essas duas etapas são de responsabilidade do usuário, portanto solicite ambas de uma só vez.

Abrir a galeria. Execute npm run studio em segundo plano (a primeira execução leva alguns minutos para construir). Quando http://localhost:4100 responder, abra no navegador. Se o usuário já tiver mencionado um template específico, a galeria pode ser pulada.

Peça em uma única mensagem:

• O caminho do arquivo de currículo ou o conteúdo colado
• Um pedido para escolher o template na galeria (o botão "Selecionar este template" na tela grava em selection.json)
• Se houver: cargo pretendido, idioma do site (português/inglês), foto de perfil, imagens de projetos, links como GitHub, etc.

Para usuários indecisos, recomende com base na quantidade de materiais. A base para recomendações está em references/templates.md.

Se o usuário disser que escolheu na galeria, leia selection.json para confirmar. Este arquivo registra apenas o último clique, portanto pode conter um valor antigo. Se o usuário mencionou o nome do template, essa informação tem prioridade.

2. Elaboração do profile.json

Leia references/profile-guide.md e o arquivo templates/<id>/content/README.md do template escolhido, depois elabore o profile.json no scratchpad. A especificação está em shared/profile.ts.

Não escreva conteúdo sem fonte. O portfólio é um documento que recrutadores leem como fato. Inserir números, depoimentos ou períodos inexistentes pode causar constrangimento ao usuário em entrevistas e caracterizar falsificação de histórico profissional. Itens vazios desaparecem automaticamente da tela, portanto é sempre mais seguro deixá-los em branco. Refinar frases é permitido, mas não aumente os fatos. Por exemplo, escrever "desenvolvi um sistema de pagamentos" em vez de "desenvolvimento de sistema de pagamentos" é aceitável; escrever "sistema de pagamentos para milhões de usuários" não é.

Transfira apenas conteúdo que possa ser tornado público. Currículos são documentos privados enviados a empresas, enquanto o site é visível para todos. Não transfira CPF, endereço residencial, data de nascimento, estado civil, detalhes de serviço militar ou salário. Inclua número de telefone apenas se o usuário concordar com a divulgação.

Se houver mais de uma fonte ou muito conteúdo, leia references/sources.md. Lá estão os critérios para quando os valores diferem entre as fontes e como selecionar.

Após a elaboração, valide o formato com:

npm run validate -- <caminho-do-arquivo>

3. Geração do Portfólio

npm run new -- <id-do-template> <slug> <caminho-do-profile.json>

Use o ID do template mencionado pelo usuário; somente quando seguir a seleção da galeria, use selected no lugar de <id-do-template>. O slug é o nome do usuário em letras minúsculas no formato latino (exemplo: joao-silva). Em seguida:

• Copie (não mova) fotos, imagens e o PDF do currículo para portfolios/<slug>/public/profile/.
• Escreva os caminhos das imagens no profile.json como /profile/nomedoarquivo.
• Disponibilize o PDF do currículo no campo basics.resumeFile para download; isso tornará o PDF inteiro público. Verifique com pdftotext se o PDF contém informações pessoais omitidas no site (como telefone ou endereço) e, se houver, registre isso obrigatoriamente no relatório. Não corrija o arquivo.
• Leia os textos fixos em content/site.pt.json. Se houver afirmações inadequadas para a pessoa (como "contribuições em projetos de código aberto"), ajuste conforme os fatos.
• Para alterar textos, edite content/site.pt.json. Não modifique componentes. Apenas modifique componentes se for absolutamente necessário para expressar algo não previsto na especificação, e informe o usuário.

4. Validação

npm run verify -- <slug>

Verifica formato, build de produção e vestígios de dados demo do template em uma única etapa. Se passar, execute npm run start -w @resume/portfolio-<slug> em segundo plano e visualize a página em 1440px e 390px. Se você reconstruiu o site, é necessário parar o servidor anterior, pois ele pode não servir o novo build corretamente, resultando em erros 500. Verifique pontos como quebra de linha em nomes longos de empresas ou projetos, vazamento horizontal, áreas vazias, posição da foto, nomes que ficaram estranhos com letras maiúsculas (ex.: SaaS aparecendo como SAAS). Se o conteúdo quebrar por ser muito longo, encurte o texto correspondente (mantendo os fatos) antes de modificar o template.

Por fim, confira novamente os números e nomes próprios do profile.json com o texto original do currículo.

5. Entrega

Informe ao usuário:

• O endereço de execução e o caminho do portfólio
• Seções que ficaram vazias por falta de material e a ordem de prioridade para preenchê-las
• Itens que este template não exibe (conforme content/README.md de cada template). Por exemplo, se o template não mostra formação acadêmica, avise
• Informações pessoais omitidas intencionalmente do currículo e informações pessoais que permanecem no PDF para download
• Valores que diferiam entre as fontes, o valor escolhido e projetos descartados na seleção
• Frases cuja expressão foi alterada durante o refinamento e que precisam de verificação do usuário

A implantação é um ato público; portanto, realize-a apenas se o usuário solicitar. A pasta do portfólio é um aplicativo independente e pode ser implantada diretamente.

As pastas portfolios/, PDFs e selection.json estão incluídos em .gitignore e não são commitados no repositório Resume Studio. Se houver necessidade de enviar currículo, fotos ou contatos do usuário para um repositório público, mostre primeiro a lista de arquivos que serão enviados e obtenha confirmação.

Quando for uma solicitação de modificação

Se o portfólio já foi criado, edite apenas portfolios/<slug>/content/profile.json e repita a etapa 4.

Para trocar o template, crie um novo slug com o mesmo profile.json. Como o formato é o mesmo, não é necessário reescrever o conteúdo. A pasta antiga não deve ser excluída até que o usuário solicite.