Editar Parte do Site
Objetivo
Realizar uma melhoria direcionada em uma parte de um site estático existente, preservando o restante do site.
Esta habilidade é para polimento iterativo após o site já existir. Deve parecer uma edição local cuidadosa, não uma nova passada de geração.
Contrato
Entradas:
- Pasta do site estático existente, página alvo, captura de tela/URL local, ou descrição em linguagem natural da região alvo.
EDITING.mde arquivos HTML/CSS/JS relevantes.- Alteração desejada de antes/depois para texto, estilo, comportamento responsivo ou pequena interação.
Saídas:
- Uma edição focada na seção da página, componente, bloco de texto, regra de estilo ou interação leve afetada.
EDITING.mdatualizado apenas quando as instruções de edição futura precisarem mudar.- Breve relatório de onde a mudança foi feita, arquivos alterados e validação realizada.
Limites:
- Não reconstruir o site inteiro, mudar a direção do tema, importar posts, personalizar muitos campos ou publicar.
- Não tocar em páginas/recursos não relacionados.
- Não introduzir dependências, etapas de build ou caminhos absolutos locais do site (
/...).
Critério de sucesso:
- A mudança local solicitada é visível na mesma região do navegador que foi confirmada antes da edição.
- Verificações de desktop/mobile ou interação passam para a superfície afetada.
- Nenhuma alteração de layout ou navegação não relacionada foi introduzida.
Se o critério falhar:
- Re-mapear a região do navegador para o código-fonte e fazer a menor edição corretiva.
- Executar ou sugerir
review-static-sitequando o problema afetar navegação compartilhada, muitas páginas, recursos, codificação ou prontidão para publicação.
Quando Usar
Use esta habilidade quando o usuário pedir para:
- Alterar uma seção, cartão, bloco, componente ou região de página.
- Tornar um detalhe visual menor, mais calmo, mais denso, mais limpo, mais lúdico, mais técnico ou menos distrativo.
- Corrigir um problema de layout mobile, estouro de texto, problema de espaçamento ou alinhamento estranho.
- Ajustar uma pequena interação como hover, alternância de tema, comportamento de menu, botão de cópia, filtro, aba ou animação.
- Reescrever ou encurtar um trecho específico de texto visível.
- Corresponder a uma captura de tela ou comentário do usuário para uma área localizada.
Não use esta habilidade para geração completa de site, busca de temas, recriação próxima de um novo site de referência, substituição de grande conteúdo pessoal, migração de artigos, implantação ou conversão de framework.
Entradas
Use o que o usuário fornecer:
- Pasta raiz do site e página alvo.
- Uma captura de tela, visualização do navegador, URL local ou descrição em linguagem natural do problema.
- O texto exato, nome da seção, nome da classe ou área visual a ser alterada.
EDITING.md, se presente.- Arquivos HTML/CSS/JS existentes.
- Qualquer redação desejada de antes/depois ou direção de estilo.
Se a área alvo for ambígua, inspecione o site e faça a menor interpretação razoável. Peça um breve esclarecimento apenas quando múltiplas edições plausíveis produziriam resultados muito diferentes.
Fluxo de Trabalho
- Antes de editar, use o navegador para confirmar a página alvo e a região alvo.
- Leia o
EDITING.mdquando presente, depois inspecione os HTML/CSS/JS relevantes. - Use busca para encontrar texto visível correspondente, IDs, classes, blocos de dados ou marcação semelhante a componentes.
- Mapeie a região do navegador confirmada para os arquivos-fonte relevantes, seletores, blocos de dados ou manipuladores de eventos.
- Faça a menor edição coerente que atenda à solicitação.
- Mantenha a linguagem de design existente, a menos que o usuário peça explicitamente para alterá-la.
- Após editar, retorne à mesma página e região no navegador e verifique a mudança lá.
- Relate o que mudou e mencione qualquer validação de acompanhamento necessária.
Controle de Escopo
Mantenha a edição local.
- Prefira editar a seção, classe ou objeto de dados existente em vez de criar uma duplicata paralela.
- Evite reescrever a página inteira quando uma alteração no nível da seção for suficiente.
- Evite alterar variáveis CSS compartilhadas, a menos que o usuário queira uma mudança de estilo em todo o site.
- Evite tocar em páginas, recursos ou conteúdo não relacionados.
- Preserve a navegação, o mapa da página, a estratégia de placeholders e as convenções do
EDITING.md. - Preserve a estratégia de caminhos do site; não introduza caminhos absolutos locais do site como
/assets/...,/posts/...,/images/...ou/data/...durante uma edição local. - Se uma pequena solicitação expuser um problema estrutural maior, explique a compensação antes de fazer mudanças amplas.
Quando o usuário pedir uma mudança visual ampla em várias páginas, sugira usar uma habilidade de geração maior ou redesign em vez de esticar esta.
Localizar o Lugar Certo
Use uma busca em camadas:
- Busque pelo texto visível ou rótulos próximos.
- Busque no
EDITING.mdpelo mapa de seção/página. - Inspecione links de navegação e nomes de arquivos de página.
- Inspecione tags semânticas como
header,main,section,article,asideefooter. - Inspecione seletores CSS e hooks de eventos JavaScript.
- Use ferramentas de desenvolvedor do navegador ou capturas de tela quando a localização no código-fonte não for óbvia.
Se conteúdo repetido for renderizado a partir de dados, edite os dados-fonte em vez de apenas a marcação que parece gerada.
Preservação de Design
Ajuste a edição ao site atual.
- Reutilize espaçamento, tipografia, cores, bordas, sombras, ícones e padrões de movimento existentes.
- Mantenha o texto dentro de seu contêiner tanto em desktop quanto mobile.
- Evite que efeitos decorativos interfiram na leitura.
- Respeite
prefers-reduced-motionao alterar animações. - Mantenha páginas de artigo/detalhe mais calmas do que páginas iniciais fortemente estilizadas, a menos que o usuário peça o contrário.
- Não adicione um herói no estilo de marketing ou seção decorativa não relacionada a um site pessoal ou blog.
Ao alterar texto, combine com a voz existente e o idioma do usuário.
Edições de Interação
Para alterações em JavaScript ou interação:
- Encontre ouvintes de evento e convenções de estado existentes antes de adicionar novos.
- Mantenha JavaScript puro se o site for estático simples.
- Evite introduzir dependências ou etapas de build.
- Ao gerar links, resultados de busca, URLs de imagens ou itens de navegação em JavaScript, use caminhos relativos à página que funcionem a partir da profundidade da página afetada.
- Teste estados de clique, teclado, mobile e uso repetido quando relevante.
- Preserve acessibilidade básica como foco, rótulos e comportamento de movimento reduzido.
Correções Responsivas
Para problemas de layout ou mobile:
- Verifique larguras de desktop e mobile.
- Prefira alterações CSS que preservem o layout de desktop enquanto corrigem telas estreitas.
- Use dimensões estáveis, quebra de linha, larguras mín/máx, ajustes de grid/flex e controle de estouro.
- Não oculte conteúdo importante no mobile apenas para fazer o layout caber.
Guia de Edição
Se a mudança afetar como futuras edições devem ser feitas, atualize o EDITING.md.
Atualize-o quando:
- Uma nova seção, classe, campo de dados ou padrão de interação for introduzido.
- O armazenamento de conteúdo mudar para um novo arquivo ou objeto de dados.
- O usuário solicitou uma mudança que agentes futuros podem precisar preservar.
Não atualize o EDITING.md para pequenas alterações de texto ou espaçamento, a menos que o guia se torne enganoso.
Validação
Valide a superfície afetada, não necessariamente o site inteiro.
Use uma ferramenta de navegador interativa realmente disponível antes de editar para confirmar a página alvo e a região. "Disponível" significa que está exposta na lista de ferramentas invocáveis da rodada atual. No Codex, pode ser a ferramenta Navegador/navegador no aplicativo quando roteada para a rodada; em outros agentes, pode ser um navegador visível equivalente, ferramenta de uso do navegador ou navegador com ferramentas de desenvolvedor. Após editar, retorne à mesma página e região no navegador interativo para verificar o resultado.
Se nenhuma ferramenta de navegador interativa for invocável, não finja que a confirmação de antes/depois no navegador aconteceu. Peça ao usuário para habilitar ou invocar a ferramenta de navegador se a edição depender de mapeamento de região visual; 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 ao Playwright, capturas de tela ou inspeção de código-fonte e mencione a limitação.
Não recorra ao Playwright, validação apenas por capturas de tela ou apenas inspeção de código-fonte quando uma ferramenta de navegador interativa for realmente invocável. Use Playwright apenas como fallback quando nenhuma ferramenta de navegador interativa for invocável, quando o usuário pedir explicitamente ou quando uma regressão de script repetível for especificamente necessária.
Para edições visuais, responsivas ou interativas, verifique a região alterada nas viewports relevantes de desktop/mobile e teste a interação alterada.
Execute ou sugira review-static-site apenas quando a edição afetar navegação compartilhada, layout global, muitas páginas, caminhos de recursos, codificação de fonte ou prontidão para publicação.
Se a edição tocar em href, src, CSS url(...), imagens, fontes, favicons, arquivos de dados ou URLs gerados por JavaScript, verifique se a página afetada ainda funciona com caminhos relativos à página e se abrir o arquivo estático diretamente não perderá CSS, JS ou imagens.
Saída
Para edições locais, relate apenas:
- Onde a mudança foi feita.
- Quais arquivos foram alterados.
- Qual validação foi realizada.
Mencione validação mais ampla com review-static-site apenas quando for realmente recomendada. Não repita o relatório nem explique demais todo o código-fonte.