Personalizar Site
Objetivo
Personalizar um site estático já gerado para que ele pareça o site do próprio usuário, em vez de um modelo, demonstração ou referência copiada.
Esta habilidade edita conteúdo e metadados. Ela não escolhe um tema, redesenha o layout, recria um site de referência, migra um grande arquivo de artigos, publica o site ou converte o projeto para outro framework.
Contrato
Entradas:
- Pasta de site estático gerado existente,
EDITING.md, mapa de páginas ou notas de transição. - Identidade/conteúdo fornecidos pelo usuário: biografia, currículo, README do GitHub, página inicial antiga, links de redes sociais, projetos, avatar/logo, detalhes de contato ou substituições específicas.
- Arquivos de dados existentes, blocos de dados JavaScript, metadados e conteúdo de marcador de posição/site de origem a serem substituídos.
Saídas:
- Conteúdo visível personalizado, metadados, links, imagens e campos de identidade em nível de código-fonte.
- Resíduos de modelo/demonstração/site de origem removidos ou substituídos.
EDITING.mdatualizado descrevendo campos preenchidos, placeholders remanescentes e locais de conteúdo.
Limites:
- Não escolha um novo tema, redesenhe o layout, recrie um novo site de referência, importe um grande arquivo de textos, publique ou converta frameworks.
- Não invente fatos pessoais específicos, empregadores, escolas, prêmios, datas, locais ou métricas.
- Não cole dados privados do usuário de volta no relatório final desnecessariamente.
Portão de sucesso:
- A identidade/conteúdo fornecidos pelo usuário aparecem nos locais corretos visíveis no navegador.
- Placeholders importantes e identidade do site de origem foram removidos ou intencionalmente documentados.
- Links internos/ativos alterados permanecem relativos à página e válidos.
review-static-sitepode ser executado ou apenas relatar limitações aceitas.
Se o portão falhar:
- Refaça o inventário de HTML, metadados, arquivos de dados e conteúdo renderizado por JavaScript.
- Substitua strings de marcador/origem perdidas.
- Use
edit-site-partpara pequenos problemas de ajuste de layout causados pelo novo conteúdo. - Use
review-static-sitenovamente após as correções.
1. Entradas
Use quaisquer materiais disponíveis:
- Pasta do site estático, geralmente
site/,dist/,out/oupublic/. EDITING.md, mapa de páginas ou notas de transição de outra habilidade.- Biografia, currículo, CV, README do GitHub, página inicial antiga, lista de links de redes sociais, lista de projetos, avatar, logotipo ou detalhes de contato fornecidos pelo usuário.
- Arquivos de dados existentes como
profile.json,posts.json,projects.jsonou blocos de dados emassets/script.js. - Instruções de substituição específicas do usuário.
Se informações importantes estiverem faltando, use placeholders claros em vez de inventar detalhes pessoais elaborados.
2. Inventário de Conteúdo
Antes de editar, identifique onde o conteúdo pessoal ou de marcador está localizado.
Verifique:
- Arquivos HTML e subpáginas.
<title>, meta descrição, metadados Open Graph/Twitter, referências de favicon/logotipo e títulos visíveis.- Cabeçalho, navegação, hero, seções de perfil/sobre, blocos de contato, rodapé, barras laterais, cartões e sobreposições.
- Conteúdo repetido em arquivos JSON, blocos de dados JavaScript ou listas HTML repetidas.
- Páginas de demonstração de artigo/detalhe, páginas de projeto, páginas de notas, páginas de links e páginas especiais.
- Instruções do
EDITING.mde quaisquer locais de conteúdo documentados.
Procure por textos comuns de marcador ou demonstração, como seu nome, [email protected], exemplo.com, lorem ipsum, postagem de exemplo, projeto de exemplo, A FAZER, substitua-me e strings semelhantes.
3. Substituição de Identidade Pessoal
Substitua campos de identidade visíveis e em nível de código-fonte de forma consistente.
Campos típicos:
- Título do site, nome do autor, nome de exibição, cargo, slogan, biografia curta, localização, disponibilidade/status e interesses.
- E-mail, links de redes sociais, GitHub, X/Twitter, LinkedIn, Bluesky, RSS, newsletter, currículo/CV e outros links fornecidos pelo usuário.
- Avatar, logotipo, favicon, texto alternativo, legendas de imagem e rótulos de perfil.
- Texto do hero da página inicial, texto da página sobre, texto de contato, texto do rodapé e descrições de metadados.
Não invente empregadores específicos, escolas, prêmios, publicações, métricas, locais ou anos. Se o usuário não forneceu algo, mantenha neutro e fácil de substituir.
Ao substituir links ou ativos, preserve a compatibilidade com caminhos estáticos:
- Mantenha links e ativos locais do site relativos à página, não absolutos à raiz.
- De páginas raiz, use caminhos como
assets/avatar.png,about.htmleposts/example.html. - De páginas aninhadas, use a profundidade correta, como
../assets/avatar.pnge../index.html. - Não introduza
/assets/...,/posts/...,/images/...,/data/...ou/para links internos, a menos que o site seja intencionalmente apenas para servidor raiz e o usuário aceite que a abertura direta de arquivos pode quebrar. - Links externos como GitHub, LinkedIn, e-mail e domínios pessoais podem permanecer URLs absolutos.
4. Limpeza de Site de Origem e Modelo
Ao personalizar uma recriação de estilo, remova a identidade do site original e o conteúdo específico da origem por padrão.
Substitua ou remova:
- Nomes de autores originais, handles, domínios, e-mails, links de redes sociais, IDs de análise, links de amigos, URLs privadas, texto de licenciamento, estatísticas do site e links comunitários.
- Catálogo de artigos original, texto do corpo do artigo, nomes de projetos, depoimentos pessoais e alegações pessoais.
- Avatares, capas, capturas de tela, logotipos ou outros ativos baixados do site original, a menos que o usuário os possua ou tenha permissão.
Mantenha a estrutura visual e o padrão de interação, mas torne o conteúdo claramente pertencente ao usuário ou neutro como conteúdo de marcador.
5. Adaptação de Conteúdo
Adapte o material do usuário ao estilo e layout existentes do site, em vez de colar texto longo e bruto em todos os lugares.
Use o conceito do site para moldar o texto:
- Site minimalista: conciso, calmo, direto.
- Estilo terminal/arquivo: perfil, log, status, diretório ou texto semelhante a configuração.
- Estilo Bento: trechos modulares curtos.
- Página inicial de pesquisa: formal, precisa, orientada a projetos/publicações.
- Blog ou jardim digital: tópicos de escrita, notas recentes, tags e caminhos de leitura.
- Portfólio: trabalho selecionado, função, resultado, stack e links.
Mantenha os comprimentos de texto adequados aos contêineres existentes. Se um parágrafo fornecido pelo usuário for muito longo para um cartão, resuma-o e coloque a versão completa na página "Sobre".
Prefira editar fontes de dados centralizadas quando existirem. Se o conteúdo for repetido em vários arquivos, atualize todas as cópias visíveis e de metadados de forma consistente.
6. Validação
Use uma ferramenta de navegador interativa realmente disponível como a primeira opção para inspecionar a pré-visualização local e confirmar que o conteúdo personalizado está realmente visível nos lugares corretos. "Disponível" significa que está exposto na lista de ferramentas chamáveis do turno atual. No Codex, isso pode ser o plugin Browser/navegador no aplicativo quando roteado para o turno; em outros agentes, pode ser um navegador visível equivalente, ferramenta de uso de navegador ou navegador com ferramentas de desenvolvimento.
Se nenhuma ferramenta de navegador interativa for chamável, não finja que a verificação de posicionamento no navegador ocorreu. Peça ao usuário para habilitar ou invocar a ferramenta de navegador se o posicionamento visual for importante; para Codex, isso pode significar enviar uma solicitação que mencione explicitamente @browser. Se o usuário não redirecionar ou o cliente não tiver tal ferramenta, recorra a Playwright, capturas de tela, auditorias estáticas ou verificações de código-fonte e declare a limitação.
Não use Playwright ou validação apenas com capturas de tela como padrão quando uma ferramenta de navegador interativa for realmente chamável. Use Playwright apenas como fallback quando nenhuma ferramenta de navegador interativa for chamável, quando o usuário solicitar explicitamente ou quando for necessária uma regressão scriptada repetível.
Verifique as páginas que devem exibir as informações do usuário, como início, sobre/perfil, contato, projetos, links e páginas de artigo/detalhe representativas. Confirme que nome, slogan, biografia, avatar/logotipo, detalhes de contato, links de redes sociais, nomes de projetos e itens em destaque fornecidos pelo usuário aparecem onde esperado.
Confirme também que conteúdo importante de marcador ou identidade do site de origem não está mais visível no navegador. Esta é uma verificação de posicionamento de conteúdo, não uma validação completa de redesign visual.
Se a personalização alterou avatares, favicons, ícones de redes sociais, links de projetos, links de postagens ou cartões orientados a dados, confirme que os caminhos alterados funcionam a partir da profundidade da página afetada e que nenhum caminho absoluto acidental à raiz do site foi introduzido para links locais.
Chame ou sugira o uso de review-static-site ao final.
Guia de Edição
Atualize EDITING.md quando ele existir, ou crie-o se o site for destinado a ser reutilizável.
Registre:
- Quais campos pessoais foram preenchidos.
- Qual conteúdo permanece apenas como marcador.
- Onde perfil, links, projetos, itens em destaque, postagens, imagens e texto do tema agora residem.
- Quaisquer ativos fornecidos pelo usuário copiados para o site e onde são referenciados.
- Qualquer conteúdo do site de origem intencionalmente removido ou substituído.
Mantenha o guia para agentes e usuários futuros, não como texto de marketing dentro do site.
Saída
Quando terminar, relate brevemente:
- Quais informações pessoais e páginas foram atualizadas.
- Quais arquivos foram alterados.
- Quais placeholders ou resíduos específicos da origem permanecem, se houver.
- Se
review-static-sitefoi executado ou deve ser executado em seguida.
Não cole dados pessoais privados do usuário de volta desnecessariamente.