Personalizar Sitio
Objetivo
Personalizar un sitio estático ya generado para que se sienta como el sitio propio del usuario, no como una plantilla, demo o copia de referencia.
Esta habilidad edita contenido y metadatos. No elige un tema, rediseña el diseño, recrea un sitio de referencia, migra un archivo grande de artículos, publica el sitio ni convierte el proyecto a otro framework.
Contrato
Entradas:
- Carpeta de sitio estático existente generado,
EDITING.md, mapa de páginas o notas de entrega. - Identidad/contenido proporcionados por el usuario: biografía, currículum, README de GitHub, página de inicio anterior, enlaces sociales, proyectos, avatar/logo, datos de contacto o reemplazos específicos.
- Archivos de datos existentes, bloques de datos en JavaScript, metadatos y contenido de marcador de posición/fuente a reemplazar.
Salidas:
- Contenido visible personalizado, metadatos, enlaces, imágenes y campos de identidad a nivel de fuente.
- Residuos de plantilla/demo/sitio fuente eliminados o reemplazados.
EDITING.mdactualizado que describe los campos completados, marcadores de posición restantes y ubicaciones de contenido.
Límites:
- No elegir un nuevo tema, rediseñar el diseño, recrear un nuevo sitio de referencia, importar un archivo grande de escritos, publicar ni convertir frameworks.
- No inventar datos personales específicos, empleadores, escuelas, premios, fechas, ubicaciones o métricas.
- No pegar datos privados del usuario en el informe final innecesariamente.
Criterio de éxito:
- La identidad/contenido proporcionados por el usuario aparecen en las ubicaciones correctas visibles en el navegador.
- Los marcadores de posición importantes y la identidad del sitio fuente han desaparecido o están documentados intencionalmente.
- Los enlaces y activos internos modificados siguen siendo relativos a la página y válidos.
review-static-sitepuede pasar o solo informar limitaciones aceptadas.
Si el criterio falla:
- Re-inventariar HTML, metadatos, archivos de datos y contenido renderizado por JavaScript.
- Reemplazar cadenas de marcador de posición/fuente omitidas.
- Usar
edit-site-partpara problemas pequeños de ajuste de diseño causados por contenido nuevo. - Usar
review-static-sitenuevamente después de las correcciones.
1. Entradas
Utilizar cualquier material disponible:
- Carpeta de sitio estático, generalmente
site/,dist/,out/opublic/. EDITING.md, mapa de páginas o notas de entrega de otra habilidad.- Biografía, currículum, CV, README de GitHub, página de inicio anterior, enlaces sociales, lista de proyectos, avatar, logo o datos de contacto proporcionados por el usuario.
- Archivos de datos existentes como
profile.json,posts.json,projects.jsono bloques de datos enassets/script.js. - Instrucciones de reemplazo específicas del usuario.
Si falta información importante, usar marcadores de posición claros en lugar de inventar datos personales detallados.
2. Inventario de Contenido
Antes de editar, identificar dónde vive el contenido personal o de marcador de posición.
Revisar:
- Archivos HTML y subpáginas.
<title>, meta descripción, metadatos de Open Graph/Twitter, referencias de favicon/logo y encabezados visibles.- Encabezado, navegación, héroe, secciones de perfil/acerca de, bloques de contacto, pie de página, barras laterales, tarjetas y superposiciones.
- Contenido repetido en archivos JSON, bloques de datos JavaScript o listas HTML repetidas.
- Páginas de demostración de artículos/detalles, páginas de proyectos, páginas de notas, páginas de enlaces y páginas especiales.
- Instrucciones de
EDITING.mdy cualquier ubicación de contenido documentada.
Buscar texto común de marcador de posición o demo como tu nombre, [email protected], example.com, lorem ipsum, publicación de muestra, proyecto de muestra, TODO, reemplázame y cadenas similares.
3. Reemplazo de Identidad Personal
Reemplazar campos de identidad visibles y a nivel de fuente de manera consistente.
Campos típicos:
- Título del sitio, nombre del autor, nombre para mostrar, rol, eslogan, biografía corta, ubicación, disponibilidad/estado e intereses.
- Correo electrónico, enlaces sociales, GitHub, X/Twitter, LinkedIn, Bluesky, RSS, boletín, currículum/CV y otros enlaces proporcionados por el usuario.
- Avatar, logo, favicon, texto alternativo, pies de foto de imagen y etiquetas de perfil.
- Texto del héroe de la página de inicio, texto de la página de inicio, texto de contacto, texto del pie de página y descripciones de metadatos.
No inventar empleadores, escuelas, premios, publicaciones, métricas, ubicaciones o años específicos. Si el usuario no ha proporcionado algo, mantenerlo neutral y fácil de reemplazar.
Al reemplazar enlaces o activos, preservar la compatibilidad de rutas estáticas:
- Mantener enlaces y activos locales del sitio relativos a la página, no absolutos a la raíz.
- Desde páginas raíz, usar rutas como
assets/avatar.png,about.htmlyposts/example.html. - Desde páginas anidadas, usar la profundidad correcta como
../assets/avatar.pngy../index.html. - No introducir
/assets/...,/posts/...,/images/...,/data/...ni/para enlaces internos a menos que el sitio esté intencionalmente limitado a raíz del servidor y el usuario acepte que la apertura directa de archivos pueda fallar. - Los enlaces externos como GitHub, LinkedIn, correo electrónico y dominios personales pueden permanecer como URL absolutas.
4. Limpieza del Sitio Fuente y la Plantilla
Al personalizar una recreación de estilo, eliminar la identidad del sitio original y el contenido específico de la fuente de manera predeterminada.
Reemplazar o eliminar:
- Nombres de autores originales, handles, dominios, correos electrónicos, enlaces sociales, ID de análisis, enlaces de amigos, URL privadas, texto de licencia, estadísticas del sitio y enlaces comunitarios.
- Catálogo de artículos original, texto del cuerpo del artículo, nombres de proyectos, testimonios personales y afirmaciones personales.
- Avatares, portadas, capturas de pantalla, logotipos u otros activos descargados del sitio original a menos que el usuario los posea o tenga permiso.
Mantener la estructura visual y el patrón de interacción, pero hacer que el contenido pertenezca claramente al usuario o siga siendo contenido de marcador de posición neutral.
5. Adaptación de Contenido
Adaptar el material del usuario al estilo y diseño existentes del sitio en lugar de pegar texto largo y sin formato en todas partes.
Usar el concepto del sitio para dar forma al texto:
- Sitio minimalista: conciso, tranquilo, directo.
- Estilo terminal/archivo: perfil, registro, estado, directorio o redacción similar a configuración.
- Estilo bento: fragmentos modulares cortos.
- Página de inicio de investigación: formal, precisa, orientada a proyectos/publicaciones.
- Blog o jardín digital: temas de escritura, notas recientes, etiquetas y rutas de lectura.
- Portafolio: trabajo seleccionado, rol, resultado, stack y enlaces.
Mantener longitudes de texto adecuadas para los contenedores existentes. Si un párrafo proporcionado por el usuario es demasiado largo para una tarjeta, resumirlo y colocar la versión completa en la página "Acerca de".
Preferir editar fuentes de datos centralizadas cuando existan. Si el contenido se repite en varios archivos, actualizar todas las copias visibles y de metadatos de manera consistente.
6. Validación
Usar una herramienta de navegador interactiva realmente disponible como primera opción para inspeccionar la vista previa local y confirmar que el contenido personalizado es realmente visible en los lugares correctos. "Disponible" significa que está expuesto en la lista de herramientas invocables del turno actual. En Codex, esto puede ser el complemento de navegador/navegador en la aplicación cuando se enruta al turno; en otros agentes, puede ser un navegador visible equivalente, una herramienta de navegación o un navegador con herramientas de desarrollo.
Si no hay ninguna herramienta de navegador interactiva invocable, no pretender que se realizó la verificación de ubicación en el navegador. Pedir al usuario que habilite o invoque la herramienta de navegador si la ubicación visual es importante; para Codex, esto puede significar enviar una solicitud que mencione explícitamente @browser. Si el usuario no redirige o el cliente no tiene dicha herramienta, recurrir a Playwright, capturas de pantalla, auditorías estáticas o verificaciones de fuente y declarar la limitación.
No recurrir de forma predeterminada a Playwright o validación solo con capturas de pantalla cuando una herramienta de navegador interactiva es realmente invocable. Usar Playwright solo como respaldo cuando no haya una herramienta de navegador interactiva invocable, cuando el usuario lo solicite explícitamente o cuando se necesite específicamente una regresión de script repetible.
Revisar las páginas que deberían mostrar la información del usuario, como inicio, acerca de/perfil, contacto, proyectos, enlaces y páginas representativas de artículos/detalles. Confirmar que el nombre, eslogan, biografía, avatar/logo, datos de contacto, enlaces sociales, nombres de proyectos y elementos destacados proporcionados por el usuario aparecen donde se espera.
También confirmar que el contenido importante de marcador de posición o la identidad del sitio fuente ya no sean visibles en el navegador. Esta es una verificación de ubicación de contenido, no una revisión completa de diseño visual.
Si la personalización cambió avatares, favicons, iconos sociales, enlaces de proyectos, enlaces de publicaciones o tarjetas basadas en datos, confirmar que las rutas modificadas funcionan desde la profundidad de la página afectada y que no se introdujeron rutas accidentales absolutas a la raíz en el sitio local.
Llamar o sugerir usar review-static-site al final.
Guía de Edición
Actualizar EDITING.md cuando exista, o crearlo si se espera que el sitio sea reutilizable.
Registrar:
- Qué campos personales se completaron.
- Qué contenido permanece solo como marcador de posición.
- Dónde viven ahora el perfil, enlaces, proyectos, elementos destacados, publicaciones, imágenes y texto del tema.
- Cualquier activo proporcionado por el usuario copiado en el sitio y dónde se referencia.
- Cualquier contenido del sitio fuente eliminado o reemplazado intencionalmente.
Mantener la guía para futuros agentes y usuarios, no como texto de marketing dentro del sitio web.
Salida
Al finalizar, informar brevemente:
- Qué información personal y páginas se actualizaron.
- Qué archivos cambiaron.
- Qué marcadores de posición o residuos específicos de la fuente permanecen, si los hay.
- Si se ejecutó
review-static-siteo si se debe ejecutar a continuación.
No pegar los datos personales privados del usuario innecesariamente.