Generar Sitio Web
Resumen
Usa esta habilidad para reproducir un flujo de trabajo cuidadoso de CV a sitio web. El principio clave es crear material fuente revisable antes de generar páginas: primero extrae el CV a Markdown, luego decide qué es público, y después construye el sitio web a partir de contenido estructurado.
Flujo de Trabajo
1. Inspeccionar el Espacio de Trabajo
Revisa los archivos del proyecto actual antes de editar:
- Busca archivos de estado del flujo de trabajo como
WEBSITE_WORKFLOW.md,PROJECT_STATUS.mdo similares. - Encuentra el archivo fuente del CV/perfil: normalmente
.pdf,.tex,.docxo un CV en texto/Markdown. - Verifica si ya existe un sitio web:
package.json,astro.config.*,src/,public/,dist/. - Revisa ligeramente el estado de Git con
git status --shortcuando sea útil.
No asumas que el proyecto está vacío.
2. Leer e Inspeccionar el CV
Si la fuente es un PDF:
- Usa la habilidad de PDF.
- Extrae el texto con
pdfplumberu otra herramienta de texto PDF confiable. - Renderiza las páginas a imágenes cuando sea posible e inspecciónalas visualmente para no malinterpretar el diseño y los límites de las secciones.
- Espera que la extracción de texto PDF tenga artefactos de espaciado/iconos; límpialos manualmente en la salida estructurada.
Si la fuente es LaTeX:
- Lee el archivo
.texdirectamente. - Trata los comandos de sección, macros y listas como estructura.
- No requieras compilación local de LaTeX a menos que el usuario solicite regenerar el PDF.
Si la fuente es .docx:
- Usa la habilidad de documentos para extraer estructura y contenido.
3. Extraer a Markdown Revisable
Crea un archivo Markdown fuente antes de construir las páginas del sitio web. Prefiere:
content/cv_extracted.md
Incluye secciones estructuradas como:
- Identidad
- Contacto público
- Contacto/detalles privados u ocultos
- Perfil
- Idiomas
- Experiencia técnica
- Habilidades profesionales
- Experiencia laboral
- Educación
- Publicaciones
- Proyectos
- Potencial de presentación web para cada proyecto
Mantén este archivo factual. Es el material fuente, no el texto de marketing final.
4. Preguntar o Confirmar Decisiones Públicas/Privadas
Antes de poner detalles personales en un sitio web público, confirma:
- Correo electrónico público
- Si mostrar el número de teléfono
- Si mostrar la fecha de nacimiento
- Si mostrar la dirección completa
- Si mostrar detalles de residencia/permiso/visa/licencia
- Qué enlaces son públicos u ocultos: GitHub, LinkedIn, Google Scholar, ORCID, ResearchGate, etc.
- Audiencia preferida: industria, academia, mixta, clientes, reclutadores, colaboradores
- Preferencia visual: minimalista, académica, portafolio técnico expresivo, etc.
Postura de privacidad predeterminada:
- Oculta fecha de nacimiento, número de teléfono, dirección completa, permiso de residencia, licencia de conducir y detalles sensibles similares a menos que el usuario los quiera explícitamente públicos.
- Prefiere correo electrónico público, ciudad/país y enlaces profesionales seleccionados.
5. Redactar la Estructura del Sitio Web
Crea un borrador de estructura antes de comenzar a construir o editar páginas intensivamente. Prefiere:
WEBSITE_STRUCTURE_DRAFT.md
Incluye:
- Dirección de diseño
- Audiencia prevista
- Navegación
- Lista de páginas
- Propósito de cada página
- Contenido sugerido por página
- Preguntas o decisiones abiertas
- Recomendación técnica
Una buena primera estructura:
- Inicio
- Acerca de
- CV
- Proyectos
- Contacto
Para perfiles con mucha investigación, deja espacio para páginas de presentación académica web posteriores.
6. Crear el Sitio Web
Usa Astro por defecto para un sitio web personal con mucho contenido a menos que el usuario solicite otra pila.
Estructura sugerida:
src/
pages/
index.astro
about.astro
cv.astro
projects.astro
contact.astro
content/
profile.ts
projects.ts
layouts/
BaseLayout.astro
styles/
global.css
public/
Construye el contenido del sitio web a partir de archivos fuente estructurados, no esparciendo texto del CV codificado en todas partes.
Archivos de contenido recomendados:
src/content/profile.tspara identidad, perfil, experiencia, educación, publicaciones.src/content/projects.tspara entradas de proyectos y notas de presentación posteriores.
Copia activos públicos en public/:
- CV en PDF, si el usuario quiere un CV descargable.
- Imagen de retrato, si está disponible y aprobada.
- Imágenes o figuras de proyectos más adelante.
7. Diseñar la Primera Versión
Para un primer sitio personal:
- Haz que la primera pantalla sea la identidad/perfil real, no una página de aterrizaje de marketing.
- Utiliza activos visuales reales cuando estén disponibles.
- Mantén la información de contacto consciente de la privacidad.
- Construye páginas que se puedan escanear rápidamente pero que se puedan expandir más adelante.
- Para audiencias de la industria, enfatiza la utilidad en ingeniería, flujos de trabajo de I+D, profundidad técnica y capacidades transferibles.
- Para audiencias académicas, enfatiza preguntas de investigación, métodos, publicaciones y flujo de presentación.
Evita sobreajustar la primera versión. Deja lugares claros para futuras páginas de presentación de proyectos.
8. Verificar Localmente
Ejecuta:
npm.cmd install
npm.cmd run build
npm.cmd run dev
En Windows/PowerShell, prefiere npm.cmd si npm está bloqueado por la política de ejecución de scripts.
Si la telemetría de Astro intenta escribir fuera del espacio de trabajo, configura scripts en package.json como:
"dev": "set ASTRO_TELEMETRY_DISABLED=1&& astro dev",
"build": "set ASTRO_TELEMETRY_DISABLED=1&& astro build",
"preview": "set ASTRO_TELEMETRY_DISABLED=1&& astro preview"
Verifica:
- La construcción se completa correctamente.
- Las rutas locales devuelven 200.
- Los activos públicos se cargan.
- No se muestran accidentalmente detalles sensibles.
- Se realiza una revisión visual en el navegador cuando esté disponible, o el usuario revisa manualmente.
9. Actualizar Archivos de Estado y Readme
Actualiza un archivo de estado/dashboard si el proyecto lo usa, por ejemplo:
PROJECT_STATUS.md
Archivos de soporte útiles:
readme_website.txt: cómo editar, previsualizar, construir y enviar el sitio web.readme_git.txt: configuración de Git y comandos comunes.WEBSITE_WORKFLOW.md: flujo de trabajo a largo plazo.
Mantén el estado conciso. No agregues detalles ruidosos de Git a menos que el usuario lo solicite.
Expectativas de Salida
Al final de la primera iteración, el proyecto debe tener:
- Markdown del CV extraído.
- Borrador de la estructura del sitio web.
- Un sitio Astro funcional.
- Contenido separado del código de página/diseño.
- Una construcción exitosa.
- Una URL de previsualización local.
- Notas claras sobre lo que queda pendiente.