Editar Parte del Sitio
Objetivo
Realizar una mejora dirigida a una parte de un sitio estático existente mientras se preserva el resto del sitio.
Esta habilidad es para el pulido iterativo después de que el sitio ya existe. Debe sentirse como una edición local cuidadosa, no como un nuevo pase de generación.
Contrato
Entradas:
- Carpeta del sitio estático existente, página objetivo, captura de pantalla/URL local, o descripción en lenguaje natural de la región objetivo.
EDITING.mdy archivos HTML/CSS/JS relevantes.- Cambio deseado de texto antes/después, estilo, comportamiento responsivo o interacción pequeña.
Salidas:
- Una edición enfocada en la sección de página, componente, bloque de texto, regla de estilo o interacción ligera afectada.
EDITING.mdactualizado solo cuando las instrucciones de edición futuras necesiten cambiar.- Breve informe de dónde se realizó el cambio, archivos modificados y validación ejecutada.
Límites:
- No reconstruir todo el sitio, cambiar la dirección del tema, importar publicaciones, personalizar muchos campos, ni publicar.
- No tocar páginas/recursos no relacionados.
- No introducir dependencias, pasos de compilación ni rutas absolutas locales del sitio.
Criterio de éxito:
- El cambio local solicitado es visible en la misma región del navegador que se confirmó antes de editar.
- Las comprobaciones de escritorio/móvil o interacción pasan para la superficie afectada.
- No se introdujeron cambios no relacionados en el diseño o la navegación.
Si el criterio falla:
- Re-mapear la región del navegador al código fuente y realizar la corrección más pequeña posible.
- Ejecutar o sugerir
review-static-sitecuando el problema afecte a la navegación compartida, muchas páginas, recursos, codificación o preparación para publicación.
Cuándo Usar
Usa esta habilidad cuando el usuario pida:
- Cambiar una sección, tarjeta, bloque, componente o región de página.
- Hacer un detalle visual más pequeño, más tranquilo, más denso, más limpio, más divertido, más técnico o menos distractor.
- Corregir un problema de diseño móvil, desbordamiento de texto, problema de espaciado o alineación incómoda.
- Ajustar una interacción pequeña como hover, alternancia de tema, comportamiento de menú, botón de copia, filtro, pestaña o animación.
- Reescribir o acortar un fragmento específico de texto visible.
- Coincidir con una captura de pantalla o comentario del usuario para un área localizada.
No uses esta habilidad para generación de sitios completos, búsqueda de temas, recreación cercana de un nuevo sitio de referencia, reemplazo grande de contenido personal, migración de artículos, despliegue o conversión de framework.
Entradas
Usa lo que el usuario proporcione:
- Carpeta raíz del sitio y página objetivo.
- Una captura de pantalla, vista del navegador, URL local o descripción en lenguaje natural del problema.
- El texto exacto, nombre de sección, nombre de clase o área visual a cambiar.
EDITING.md, si está presente.- Archivos HTML/CSS/JS existentes.
- Cualquier dirección de estilo o redacción deseada antes/después.
Si el área objetivo es ambigua, inspecciona el sitio y haz la interpretación razonable más pequeña. Pide una breve aclaración solo cuando múltiples ediciones plausibles producirían resultados muy diferentes.
Flujo de Trabajo
- Antes de editar, usa el navegador para confirmar la página objetivo y la región objetivo.
- Lee
EDITING.mdcuando esté presente, luego inspecciona los archivos HTML/CSS/JS relevantes. - Usa la búsqueda para encontrar texto visible, IDs, clases, bloques de datos o marcado similar a componentes.
- Mapea la región del navegador confirmada a los archivos fuente relevantes, selectores, bloques de datos o manejadores de eventos.
- Realiza la edición coherente más pequeña que satisfaga la solicitud.
- Mantén el lenguaje de diseño existente a menos que el usuario pida explícitamente cambiarlo.
- Después de editar, regresa a la misma página y región en el navegador y verifica el cambio allí.
- Informa qué cambió y menciona cualquier validación de seguimiento necesaria.
Control de Alcance
Mantén la edición local.
- Prefiere editar la sección, clase u objeto de datos existente en lugar de crear un duplicado paralelo.
- Evita reescribir toda la página cuando un cambio a nivel de sección es suficiente.
- Evita cambiar variables CSS compartidas a menos que el usuario quiera un cambio de estilo en todo el sitio.
- Evita tocar páginas, recursos o contenido no relacionados.
- Preserva la navegación, el mapa de páginas, la estrategia de marcadores de posición y las convenciones de
EDITING.md. - Preserva la estrategia de rutas del sitio; no introduzcas rutas absolutas locales del sitio como
/assets/...,/posts/...,/images/...o/data/...durante una edición local. - Si una solicitud pequeña expone un problema estructural más grande, explica la compensación antes de hacer cambios amplios.
Cuando el usuario pida un cambio visual amplio en múltiples páginas, sugiere usar una habilidad de generación mayor o rediseño en lugar de estirar esta.
Localizar el Lugar Correcto
Usa una búsqueda en capas:
- Busca el texto visible o las etiquetas cercanas.
- Busca en
EDITING.mdel mapa de sección/página. - Inspecciona los enlaces de navegación y los nombres de archivos de página.
- Inspecciona etiquetas semánticas como
header,main,section,article,asideyfooter. - Inspecciona selectores CSS y ganchos de eventos JavaScript.
- Usa herramientas de desarrollo del navegador o capturas de pantalla cuando la ubicación en el código fuente no sea obvia.
Si el contenido repetido se renderiza a partir de datos, edita los datos fuente en lugar de solo el marcado generado.
Preservación del Diseño
Adapta la edición al sitio actual.
- Reutiliza el espaciado, la tipografía, los colores, los bordes, las sombras, los iconos y los patrones de movimiento existentes.
- Mantén el texto dentro de su contenedor tanto en escritorio como en móvil.
- Evita que los efectos decorativos interfieran con la lectura.
- Respeta
prefers-reduced-motional cambiar animaciones. - Mantén las páginas de artículos/detalle más tranquilas que las páginas de inicio muy estilizadas, a menos que el usuario pida lo contrario.
- No agregues un hero de estilo de marketing ni una sección decorativa no relacionada a un sitio web o blog personal.
Al cambiar texto, iguala la voz existente y el idioma del usuario.
Ediciones de Interacción
Para cambios en JavaScript o interacción:
- Encuentra los event listeners y las convenciones de estado existentes antes de agregar nuevos.
- Mantén JavaScript vainilla si el sitio es estático simple.
- Evita introducir dependencias o pasos de compilación.
- Al generar enlaces, resultados de búsqueda, URLs de imágenes o elementos de navegación en JavaScript, usa rutas relativas a la página que funcionen desde la profundidad de la página afectada.
- Prueba los estados de clic, teclado, móvil y uso repetido cuando sea relevante.
- Preserva los fundamentos de accesibilidad como el foco, las etiquetas y el comportamiento de movimiento reducido.
Correcciones Responsivas
Para problemas de diseño o móviles:
- Verifica tanto el ancho de escritorio como el móvil.
- Prefiere cambios CSS que preserven el diseño de escritorio mientras corrigen pantallas estrechas.
- Usa dimensiones estables, ajuste de línea, anchos mínimos/máximos, ajustes de grid/flex y control de desbordamiento.
- No ocultes contenido importante en móvil solo para que el diseño encaje.
Guía de Edición
Si el cambio afecta cómo se deben realizar ediciones futuras, actualiza EDITING.md.
Actualízalo cuando:
- Se introduzca una nueva sección, clase, campo de datos o patrón de interacción.
- El almacenamiento de contenido se mueva a un nuevo archivo u objeto de datos.
- El usuario haya solicitado un cambio que los agentes futuros deban preservar.
No actualices EDITING.md para cambios pequeños de texto o espaciado a menos que la guía se vuelva engañosa.
Validación
Valida la superficie afectada, no necesariamente todo el sitio.
Usa una herramienta de navegador interactiva realmente disponible antes de editar para confirmar la página objetivo y la región. "Disponible" significa que está expuesta en la lista de herramientas invocables del turno actual. En Codex puede ser el plugin Browser/in-app browser cuando se enruta al turno; en otros agentes puede ser un navegador visible equivalente, una herramienta de browser-use o un navegador basado en devtools. Después de editar, regresa a esa misma página y región en el navegador interactivo para verificar el resultado.
Si no hay una herramienta de navegador interactivo invocable, no finjas que ocurrió la confirmación antes/después del navegador. Pide al usuario que habilite o invoque la herramienta de navegador si la edición depende del mapeo visual de la región; para Codex, eso puede significar enviar una solicitud que mencione explícitamente @browser. Si el usuario no redirige o el cliente no tiene tal herramienta, recurre a Playwright, capturas de pantalla o inspección del código fuente y declara la limitación.
No recurras por defecto a Playwright, validación solo con capturas de pantalla o inspección del código fuente cuando una herramienta de navegador interactivo sea realmente invocable. Usa Playwright solo como alternativa cuando no haya una herramienta de navegador interactivo invocable, cuando el usuario lo pida explícitamente o cuando se necesite específicamente una regresión scripteada repetible.
Para ediciones visuales, responsivas o interactivas, verifica la región cambiada en las vistas de escritorio/móvil relevantes y ejercita la interacción modificada.
Ejecuta o sugiere review-static-site solo cuando la edición afecte a la navegación compartida, el diseño global, muchas páginas, rutas de recursos, codificación de fuente o preparación para publicación.
Si la edición toca href, src, url(...) de CSS, imágenes, fuentes, favicons, archivos de datos o URLs generadas por JavaScript, verifica que la página afectada aún funcione con rutas relativas a la página y que abrir directamente el archivo estático no pierda CSS, JS o imágenes.
Salida
Para ediciones locales, solo informa:
- Dónde se realizó el cambio.
- Qué archivos cambiaron.
- Qué validación se realizó.
Menciona la validación más amplia de review-static-site solo cuando realmente se recomiende. No repitas el informe ni sobre-expliques todo el código base.