HarryXC09/resume-portfolio-skill

Clonación de Portafolio Curricular

Toma este directorio como raíz del proyecto. Conserva React, animaciones de desplazamiento con GSAP, diseño de tarjetas y estética responsiva. Cuando el usuario solicite crear un sitio web personal, primero verifica los materiales y luego completa todo el sitio basándote en su currículum real. Este repositorio contiene código fuente ejecutable; no requiere un agente específico, servicio en la nube ni clave API.

Primera Recepción

1. Lee references/materials.md y ejecuta node scripts/intake.mjs. Este script crea los directorios fijos de materiales e indica qué elementos faltan.
2. Explica de una vez, en el idioma del usuario: coloca el currículum en inputs/resume/; los videos de acción en inputs/videos/; las fotos en inputs/photos/; los logotipos de escuelas y empresas en inputs/logos/; los modelos opcionales en inputs/models/. Proporciona las recomendaciones de toma del material, recordando que la iluminación del fondo verde debe ser uniforme y que la persona debe evitar vestir verde.
3. Revisa los materiales enviados. Espera si falta el currículum; no inventes datos. Si faltan algunos videos, analiza primero el currículum y completa el texto. Informa al usuario qué secciones usarán temporalmente fotos o tomas repetidas y qué materiales aún necesita completar. Los directorios vacíos y las imágenes de placeholder no cuentan como materiales del usuario.
4. Lee references/adaptation.md. Realiza la extracción de hechos, el mapeo de contenido, el procesamiento de materiales, el reemplazo de componentes y la verificación en el navegador. Cuando el usuario indique que los materiales están listos, vuelve a ejecutar intake; no preguntes repetidamente si desea continuar.
5. Usa template/resume-portfolio-content-template-general.docx como tabla de entrada de texto. Sigue el diseño de cuatro columnas optimizado por el mantenedor. Primero completa identidad, Acerca de, educación/experiencia laboral e información de contacto; luego completa con alta densidad modules[]. Los modules[] en la tabla de Word no presuponen una industria; el agente debe seleccionar tipos según el currículum: experiencia en proyectos, portafolio personal, premios y honores, investigación, tesis, casos de clientes o práctica profesional. El borrador inicial puede incluir 3 módulos, el primero con un máximo de 4 entradas. Después de la confirmación humana, se pueden reducir. El repositorio utiliza template/resume-portfolio-layout-source.docx como fuente de diseño sin metadatos personales. Para reconstruir una versión genérica de campos, ejecuta python scripts/adapt_user_word_template.py; no sobrescribas el archivo fuente.

Hechos y Contenido

• El texto original del currículum es la fuente de hechos de la persona. Registra cada hecho a publicar con la página/párrafo original en work/facts.md. Distingue entre títulos formales, etapas de estudio, participación vs. liderazgo, publicaciones publicadas vs. enviadas. Ante conflictos o fechas poco claras, pregunta solo sobre las carencias que afectan la salida.
• src/content/profile.js es la única entrada de datos para el texto y los números de medios de la página. La tabla de Word es la entrada de edición del usuario; profile.json es solo un producto intermedio de conversión y no debe mantenerse en paralelo con la página a largo plazo. En clonaciones regulares, modifica primero estos datos. Si la estructura no se adapta, ajusta los componentes; no fuerces seis habilidades o cuatro experiencias.
• Genera texto conciso en chino y una traducción fiel al inglés. Conserva la dirección profesional real de la persona. "Clinical", "Research", "Publication" son solo espacios visuales del demo original, no limitaciones de industria. Para perfiles no académicos, mapea estos conceptos a experiencia en proyectos, portafolio personal, premios y honores, casos de clientes o práctica profesional, y actualiza simultáneamente títulos, pies de imagen y descripciones de modelos. El material visual genérico de medicina/microscopio/tumores no debe interpretarse como calificaciones del principiante.
• La información de contacto externa la proporciona el usuario y se publica según su indicación. No publiques teléfonos, fechas de nacimiento, direcciones, documentos de identidad no especificados. El currículum original y los videos originales permanecen solo en inputs; no se copian a public.

Materiales y Entrega

Usa npm run media para procesar los MP4 con fondo verde numerados del 01 al 07; los parámetros y el mapeo de tomas están en materials. Después del procesamiento, verifica bordes, tono de piel y uniones de bucle. Los parámetros del script son un punto de partida; no son una garantía de calidad para cualquier fondo verde.

Ejecuta secuencialmente: npm ci, npm run intake, conversión de Word / mapeo de contenido, npm run media, npm run build, npm run preview. Usa herramientas de navegador disponibles para verificar escritorio y móvil, bilingüe, carrusel, desplazamiento, video transparente y degradación sin modelo. Primero despliega la vista previa en un hosting estático o una dirección local accesible. El usuario hace clic para verificar y solicitar cambios. Las modificaciones vuelven primero a la tabla de Word, luego se sincronizan con profile y la página web. Solo después de que el usuario confirme explícitamente, realiza el despliegue formal. Verifica el reemplazo con un perfil de un nuevo usuario realmente diferente, buscando todos los nombres, instituciones, información de contacto y textos placeholder. No declares la clonación completa solo porque el build fue exitoso.

Ciclo Estandarizado y Puntos Críticos

Después de descargar el proyecto, primero recopila los materiales en inputs/, luego lee los hechos del currículum y completa la tabla de Word. Después de procesar materiales y mapear contenido, construye el sitio estático y proporciona al usuario una dirección de vista previa. Las solicitudes de modificación del usuario se escriben de vuelta en la tabla de Word y se reconstruye. Finalmente, despliega después de la confirmación explícita. El sitio estático por defecto no depende de un servidor backend, pero los videos, fuentes y modelos 3D aún afectan el tamaño del paquete, la velocidad de carga inicial y la cuota de hosting.

Los puntos críticos comunes incluyen: formato complejo del currículum que lleva a una extracción incompleta de hechos, sangrado de color en bordes de fondo verde, logotipos sin licencia pública, videos o GLB demasiado grandes, algunos agentes sin biblioteca de análisis de DOCX, hosting estático que no maneja archivos grandes o SPA fallback. Las soluciones son: mantener índices de hechos con página/párrafo, degradar primero con fotos, registrar la fuente de los materiales, comprimir WebM/GLB, usar scripts/word_to_profile.py y Python empaquetado, colocar materiales grandes en almacenamiento de objetos o CDN estática, y realizar verificación real en navegador después de cada build.

Entrega: vista previa local, código fuente del sitio completo, índice de uso de materiales y resultados de verificación. Por defecto, no subas nuevos materiales del usuario ni despliegues automáticamente. Al publicar o subir, sigue la autorización actual del usuario. Las secciones placeholder por falta de materiales deben listarse explícitamente.