Construir Site Pessoal
Objetivo
Coordenar o conjunto de habilidades do site pessoal em um fluxo de trabalho confiável.
Esta é uma skill de orquestração, não uma skill de implementação. Ela deve rotear para as skills especializadas corretas, aplicar portões de qualidade e manter o fluxo de trabalho em andamento até que a solicitação atual atinja seu ponto de parada natural.
Não duplique as regras de implementação detalhadas das skills filhas. Carregue e siga as skills filhas quando sua etapa for alcançada.
Para solicitações voltadas ao usuário do tipo "da ideia ao site pessoal" ou lançamento com um clique, prefira from-idea-to-personal-site. Use esta skill como o coordenador de rota de nível inferior quando o próximo passo ou a escolha da skill filha for o problema principal.
Contrato
Entradas:
- Solicitação do usuário, pasta do site ou pasta de saída desejada, referências, materiais de identidade, materiais de conteúdo e destino de publicação opcional.
- Estado atual do fluxo de trabalho quando o usuário pergunta o que fazer a seguir.
Saídas:
- Rota de fluxo de trabalho escolhida e skills filhas executadas.
- Um site estático local, site existente validado, conteúdo importado, edição focada ou preparação para publicação, dependendo da solicitação.
- Resumo de handoff com pasta do site, status de visualização/publicação, validação realizada e etapas manuais restantes.
Limites:
- Não implemente detalhes de skills filhas diretamente quando uma skill filha especializada se aplicar.
- Não execute todas as skills filhas por padrão; escolha a cadeia mais curta que satisfaça a solicitação.
- Não publique, faça push, crie projetos, vincule domínios ou altere DNS a menos que seja explicitamente solicitado.
- Não pule
review-static-siteapós geração, recriação, personalização, importação de posts ou edições amplas.
Portão de sucesso:
- A cadeia de skills filhas escolhida atinge o ponto de parada natural do usuário: direção selecionada, site construído, conteúdo adicionado, site validado, edição concluída ou implantação preparada/realizada.
- Os portões de qualidade necessários passam ou o usuário aceita explicitamente as limitações documentadas.
Se o portão falhar:
- Roteie o portão com falha para a menor skill filha responsável.
- Reexecute a validação afetada.
- Pare e relate o bloqueador somente quando faltar conteúdo do usuário, credenciais, ativos indisponíveis ou ações de conta externa impedirem o progresso.
Skills Filhas
Use estas skills como blocos de construção do fluxo de trabalho:
search-blog-theme: descobrir e comparar direções de tema para site pessoal/blog.find-style-references: pesquisar e inspecionar sites reais/modelos/capturas de tela para uma direção escolhida e produzir um briefing de referência pronto para construção.make-personal-site: criar um site pessoal estático original sem dependências.copy-website-style: recriar o estilo, layout, movimento e tipos de página de um site de referência específico.personalize-site: substituir a identidade de placeholder/demo/origem pelo conteúdo do próprio usuário.add-blog-posts: importar Markdown, anotações do Obsidian, rascunhos do Word, posts HTML antigos, imagens, matemática, links e outros escritos para um site existente.edit-site-part: fazer alterações locais focadas em uma seção, componente, bloco de cópia, detalhe de estilo ou interação específicos.review-static-site: validar a saída estática quanto a links, tipos de página, renderização do navegador, codificação, resíduos de placeholder, compatibilidade de abertura direta e correção de caminhos.publish-static-site: preparar ou realizar implantação para GitHub Pages, Cloudflare Pages, Netlify ou Vercel.
Se o nome de uma skill filha mudar, prefira a skill instalada localmente com o propósito correspondente.
Matriz de Contrato de Skill Filha
Use esta matriz para decidir handoffs e loops de reparo:
| Skill filha | Entrada necessária | Saída esperada | Portão de sucesso | Se o portão falhar |
|---|---|---|---|---|
search-blog-theme | Gosto do usuário, propósito, referências ou palavras-chave | 3-5 direções, URLs de referência verificadas, uma recomendação | A direção é específica o suficiente para construir | Pesquise mais referências, refine a metáfora ou faça uma pergunta de preferência |
find-style-references | Direção de estilo escolhida, tipo de site, palavras de clima ou exemplos | 4-8 referências reais, observações do navegador, briefing de design pronto para construção | Múltiplos ângulos de pesquisa e pelo menos 3 referências fortes inspecionadas quando possível | Amplie a pesquisa, inspecione referências mais fortes ou retorne a search-blog-theme |
make-personal-site | Direção, dicas de conteúdo/perfil, escopo de página, pasta de saída | Site estático simples com páginas representativas, ativos, EDITING.md | Tipos de página necessários, caminhos relativos, fonte UTF-8, visualização local | Corrija estrutura/caminhos/ativos, depois review-static-site |
copy-website-style | URL/modelo/captura de tela alvo e escopo | Recriação de estilo estático com mapa de página, placeholders/conteúdo do usuário, EDITING.md | Layout/movimento/tipos de página característicos correspondem à fidelidade solicitada | Reinspecione o alvo, repita a recriação, depois review-static-site |
personalize-site | Site existente mais identidade/conteúdo do usuário | Identidade, links, metadados, ativos substituídos, limpeza de placeholder/origem | Conteúdo do usuário visível e resíduos removidos | Refaça o inventário dos locais de conteúdo ou use edit-site-part para ajuste de layout |
add-blog-posts | Site existente mais posts/ativos de origem | Novas páginas de post, índices/dados atualizados, ativos copiados, notas de edição | Posts renderizam, links/ativos/matemática/conteúdo avançado funcionam | Corrija conversão/índices/ativos ou use edit-site-part para problemas de apresentação local |
edit-site-part | Site existente mais página/região/alteração alvo | Pequena edição de código/conteúdo/estilo/interação com escopo definido | A mesma região do navegador mostra a alteração solicitada sem quebra não relacionada | Remapeie a origem e faça uma edição corretiva menor |
review-static-site | Raiz estática, escopo esperado, strings proibidas/referência opcionais | Constatações ou correções, resultado de auditoria/navegador, estado de aprovação/reprovação | Nenhum bloqueador restante | Roteie o bloqueador para a menor skill filha responsável |
publish-static-site | Raiz de implantação validada mais plataforma/modo escolhido | Configurações/arquivos de implantação, URL ativa opcional, verificação pós-implantação | Pasta correta implantada e URL ativa funciona | Corrija bloqueadores locais, configurações de implantação ou etapas de conta/DNS |
Princípios Operacionais
- Roteie primeiro, depois execute. Decida a cadeia correta antes de fazer edições amplas.
- Mantenha a saída de cada etapa utilizável pela próxima etapa.
- Prefira HTML/CSS/JS simples e zero dependências para esta versão, a menos que o usuário peça explicitamente outra pilha.
- Não transforme um site pessoal ou blog em uma página de destino de marketing.
- Não invente fatos pessoais detalhados quando faltarem dados do usuário.
- Substitua a identidade copiada do site de origem por padrão em recriações de estilo.
- Use links e ativos relativos à página por padrão; evite caminhos absolutos da raiz do site, como
/assets/...ou/posts/.... - Valide com
review-static-siteapós qualquer geração, recriação, personalização, importação de posts ou edição ampla. - Pare em um site local validado, a menos que o usuário peça explicitamente para publicar.
- Não crie repositórios, faça push de código, implante, vincule domínios ou altere DNS a menos que o usuário peça explicitamente.
Entrada
Colete apenas as informações necessárias para a próxima decisão. Não faça uma entrevista excessiva com o usuário.
Entradas úteis:
- Pasta de saída desejada ou pasta do site existente.
- Se o usuário deseja um novo site, uma recriação de uma referência, importação de conteúdo, personalização, uma edição local, validação ou publicação.
- URLs de referência, capturas de tela, modelos ou palavras de tema.
- Materiais de identidade do usuário: nome, biografia, links, currículo, projetos, avatar/logo, página inicial antiga, perfil do GitHub.
- Materiais de conteúdo: Markdown, anotações do Obsidian, documentos do Word, posts antigos, pastas de imagens ou texto colado.
- Destino de publicação: GitHub Pages, Cloudflare Pages, Netlify, Vercel ou apenas orientação.
Se a solicitação for clara o suficiente, prossiga. Faça uma pergunta concisa apenas quando várias rotas produziriam trabalhos muito diferentes.
Roteador
Escolha o fluxo de trabalho com base no estado atual do usuário:
- Ideia vaga ou "encontre um estilo para mim": use
search-blog-theme, depoisfind-style-referencesantes de uma construção original. - Direção escolhida e nenhum site alvo específico: use
find-style-references, depoismake-personal-site. - URL/modelo/captura de tela alvo específico para corresponder de perto: use
copy-website-style. - Site gerado existente que ainda tem placeholders ou identidade copiada: use
personalize-site. - Site existente mais novos artigos/anotações/documentos: use
add-blog-posts. - Site existente mais uma pequena alteração visual/de cópia/layout/interação: use
edit-site-part. - "Verifique este site", "isto é bom o suficiente", "antes de publicar": use
review-static-site. - "Implantar", "publicar", "GitHub Pages", "Cloudflare Pages", "Netlify", "Vercel": use
publish-static-site, apósreview-static-site.
Quando o usuário solicitar uma construção completa com um clique, escolha a cadeia mais curta que lide com as entradas reais. Não execute todas as skills filhas apenas porque elas existem.
Exemplos de Rota
Use estes exemplos para estabilizar o roteamento:
| Padrão de solicitação do usuário | Rota |
|---|---|
| "Quero um blog pessoal distinto, ajude-me a escolher um estilo" | search-blog-theme |
| "Encontre referências reais para este estilo escolhido antes de construir" | find-style-references |
| "Faça um site pessoal nesta direção escolhida" | find-style-references -> make-personal-site -> review-static-site |
| "Construa um blog pessoal completo do zero" | search-blog-theme se necessário -> find-style-references -> make-personal-site -> personalize-site se houver conteúdo -> review-static-site |
| "Use esta URL como referência e recrie-a" | copy-website-style -> personalize-site -> review-static-site |
| "Copie este site mas substitua o conteúdo da pessoa pelo meu" | copy-website-style -> personalize-site -> review-static-site |
| "Aqui está meu site gerado, substitua os placeholders pela minha biografia/projetos/links" | personalize-site -> review-static-site |
| "Adicione este artigo Markdown/Obsidian/Word ao site" | add-blog-posts -> review-static-site |
| "Altere esta seção/cor/título/card/menu" | edit-site-part; adicione review-static-site apenas se a estrutura ou ativos compartilhados mudarem |
| "Verifique se este site está pronto" | review-static-site |
| "Implante isto no Cloudflare Pages/GitHub Pages/Netlify/Vercel" | review-static-site -> publish-static-site |
| "Funciona localmente via HTTP, mas não ao clicar duas vezes no index.html" | review-static-site; corrija falhas no portão de caminho antes de publicar |
Pipelines Padrão
Ideia para Site Original
Use quando o usuário tem apenas um objetivo aproximado ou preferência de estilo.
search-blog-themese a direção visual não estiver clara.find-style-referencespara fundamentar a direção escolhida em sites/modelos/capturas de tela reais.make-personal-sitepara criar o site estático.personalize-sitese o usuário forneceu identidade/conteúdo ou o site tem placeholders que devem ser preenchidos.review-static-sitecomo o portão de garantia de qualidade (QA) rigoroso.- Pare com instruções de visualização local, a menos que a publicação tenha sido solicitada.
Referência para Site Pessoal
Use quando o usuário fornece uma URL alvo, captura de tela, modelo v0, design Figma ou site existente para corresponder.
copy-website-stylepara recriar o layout, movimento, tipos de página e interações.personalize-sitepara substituir a identidade alvo e o conteúdo placeholder.add-blog-postsse o usuário forneceu conteúdo de escrita.review-static-sitecomo o portão de QA rigoroso.- Pare com instruções de visualização local, a menos que a publicação tenha sido solicitada.
Blog Primeiro Conteúdo
Use quando a entrada mais forte do usuário são artigos, anotações, Markdown, arquivos Word ou um arquivo de escrita antigo.
- Use
search-blog-themeapenas se não existir site/tema. - Use
find-style-referencesse um novo sistema visual original for necessário. - Use
make-personal-sitese ainda não existir um site estático. - Use
add-blog-postspara importar o conteúdo para o sistema de posts do site existente. - Use
personalize-sitese o conteúdo de identidade/perfil permanecer genérico. - Use
review-static-sitecomo o portão de QA rigoroso. - Pare com instruções de visualização local, a menos que a publicação tenha sido solicitada.
Melhoria de Site Existente
Use quando o usuário já tem uma pasta de site gerada.
- Inspecione o site e
EDITING.mdse presente. - Use
personalize-sitepara substituição de identidade/conteúdo. - Use
add-blog-postspara importações de artigos. - Use
edit-site-partpara alterações de design ou cópia focadas. - Use
review-static-sitequando a alteração afetar navegação, tipos de página, ativos, codificação, prontidão para publicação ou mais de uma página.
Site Pronto para Publicar
Use quando o usuário pedir para publicar ou implantar.
- Use
review-static-siteprimeiro. - Corrija bloqueadores ou roteie para a skill filha relevante se a revisão encontrar problemas.
- Use
publish-static-sitesomente após o site passar pelas verificações locais necessárias ou o usuário aceitar os riscos conhecidos. - Verifique a URL ativa quando a implantação ocorrer.
Portões de Qualidade
O fluxo de trabalho não está concluído até que os portões relevantes passem ou o usuário aceite uma limitação explícita.
Portão de tema:
- A direção visual ou referência é específica o suficiente para construir.
- Se a construção é original e baseada em palavras de gosto, referências de estilo reais foram pesquisadas de múltiplos ângulos e pelo menos 3 referências fortes foram inspecionadas quando possível, ou o usuário dispensou essa etapa explicitamente.
- A abordagem escolhida corresponde ao tipo de site do usuário: blog, portfólio, página inicial de pesquisa, jardim digital, anotações, links ou híbrido.
Portão de estrutura:
- Os tipos de página necessários existem, não apenas a página inicial.
- Sites tipo blog incluem pelo menos uma página de artigo/detalhe e um ponto de entrada de lista/arquivo.
- A navegação aponta para páginas geradas reais.
Portão de conteúdo:
- A identidade/conteúdo fornecido pelo usuário aparece nos lugares pretendidos.
- O conteúdo apenas placeholder é claramente marcado ou substituído.
- A identidade copiada do site de origem é removida das recriações de estilo, a menos que o usuário a possua ou tenha permissão.
Portão de caminho:
- Links e ativos locais do site são relativos à página por padrão.
- Páginas aninhadas usam profundidade
../correta. - HTML, CSS
url(...), links gerados por JavaScript, arquivos de dados, imagens de capa, fontes e ativos de terceiros evitam caminhos absolutos acidentais da raiz. - A abertura direta de
index.htmlnão deve perder CSS, JS, imagens ou navegação.
Portão de codificação:
- A fonte é UTF-8 sem BOM (a menos que o navegador alvo exija BOM para arquivos específicos).
- A codificação é declarada em HTML via
<meta charset="utf-8">ou cabeçalho HTTP. - Caracteres especiais, emojis, acentos e scripts não latinos aparecem corretamente.
- Arquivos binários (imagens, fontes, PDFs) não são corrompidos.
Portão de publicação:
- A pasta a ser implantada é uma raiz estática completa.
- O site foi verificado para funcionar em modo de abertura direta, a menos que o serviço de hospedagem injete tratamento de servidor.
- O conteúdo sensível ou privado não está incluído.
- O usuário confirmou o alvo de implantação e, para provedores com projeto/conta, as credenciais ou acesso estão prontos.
Checklist de Trabalhos
Pergunte apenas o necessário. Se a solicitação for clara, pule perguntas desnecessárias.
Rápido (1-2 perguntas): Novo Site ou Referência
- "Você quer um site pessoal original ou recriar o estilo de um site/design existente?"
- Se recriação: "Qual é a URL ou o nome do site/modelo que você quer que eu corresponda?"
- Se original: "Você tem palavras-chave de estilo ou exemplos de sites que você gosta, ou quer que eu pesquise temas populares?"
Rápido (1-2 perguntas): Site Existente
- "O que você quer fazer: adicionar conteúdo (artigos/posts), personalizar a identidade (biografia/links/avatar), editar uma parte específica ou preparar/publicar o site?"
- "Você pode me mostrar ou descrever a localização do seu site (pasta local, URL)?"
Detalhado (se solicitado ou se a etapa anterior precisar de mais)
Use estas perguntas quando a resposta a uma pergunta rápida exigir mais informações.
- "Aqui está o que posso ver no seu site/pasta. Você pode confirmar ou corrigir esta visão geral?"
- "Quem é o público deste site?"
- "Quantas páginas você espera (por exemplo, início, sobre, blog, projetos, contato)?"
- "Você tem uma imagem de avatar ou logotipo?"
- "Você tem um currículo, lista de projetos ou links de redes sociais para incluir?"
- "Você tem posts ou anotações existentes para importar? Em qual formato?"
- "Há alguma cor, fonte ou sensação visual específica que você queira?"
- "Você quer publicar isto online agora ou mantê-lo local por enquanto?"
- "Se publicar: GitHub Pages, Cloudflare Pages, Netlify ou Vercel?"
Diretrizes de Contribuição
- Execute conforme. Skills filhas mudam. Verifique se a skill filha instalada corresponde ao propósito, não apenas ao nome, antes de chamá-la.
- Se uma nova skill filha for adicionada, adicione-a à matriz e aos pipelines padrão.
- Não modifique a entrada do usuário como preparação. Passe tudo o que for relevante para a skill filha.
- Não armazene em cache saídas de skills filhas entre execuções. A entrada do usuário pode mudar.
- Mantenha as instruções na raiz da saída em
EDITING.mdpara que o usuário possa fazer edições locais manualmente. - Respeite os limites da ferramenta. Se um ambiente bloquear certos comandos externos, informe o usuário em vez de parar em silêncio.
Tratamento de Erros
Quando uma skill filha falha:
- Capture a mensagem de erro e qual portão falhou.
- Se o erro for um bloqueador conhecido (credenciais ausentes, ativo faltando), pare e informe o usuário com instruções para fornecer a peça que falta.
- Se o erro for uma falha de validação na saída da skill filha, reexecute a skill filha com contexto do que precisa ser corrigido. Se uma skill filha falhar duas vezes na mesma saída, pergunte ao usuário como proceder ou mude para uma skill filha diferente que possa realizar a tarefa.
- Se uma skill filha não estiver disponível (não instalada ou nome alterado), informe o usuário e sugira o próximo caminho alternativo mais próximo.