Construir Sitio Personal
Objetivo
Coordinar el conjunto de habilidades del sitio personal en un flujo de trabajo confiable.
Esta es una habilidad de orquestación, no una habilidad de implementación. Debe enrutar a las habilidades especializadas correctas, hacer cumplir las puertas de calidad y mantener el flujo de trabajo en movimiento hasta que la solicitud actual alcance su punto de parada natural.
No dupliques las reglas de implementación detalladas de las habilidades hijas. Carga y sigue las habilidades hijas cuando se alcance su paso.
Para solicitudes orientadas al usuario de "de la idea al sitio personal" o de lanzamiento con un clic, prefiere from-idea-to-personal-site. Usa esta habilidad como el coordinador de ruta de nivel inferior cuando el siguiente paso o la elección de la habilidad hija sea el problema principal.
Contrato
Entradas:
- Solicitud del usuario, carpeta del sitio o carpeta de salida deseada, referencias, materiales de identidad, materiales de contenido y destino de publicación opcional.
- Estado actual del flujo de trabajo cuando el usuario pregunta qué hacer a continuación.
Salidas:
- Ruta de flujo de trabajo elegida y habilidades hijas ejecutadas.
- Un sitio estático local, sitio existente validado, contenido importado, edición enfocada o preparación para publicación según la solicitud.
- Resumen de transferencia con carpeta del sitio, estado de vista previa/publicación, validación realizada y pasos manuales restantes.
Límites:
- No implementes detalles de habilidades hijas directamente cuando una habilidad hija especializada sea aplicable.
- No ejecutes todas las habilidades hijas por defecto; elige la cadena más corta que satisfaga la solicitud.
- No publiques, hagas push, crees proyectos, vincules dominios ni cambies DNS a menos que se solicite explícitamente.
- No omitas
review-static-sitedespués de la generación, recreación, personalización, importación de publicaciones o ediciones amplias.
Puerta de éxito:
- La cadena de habilidades hijas elegida alcanza el punto de parada natural del usuario: dirección seleccionada, sitio construido, contenido agregado, sitio validado, edición completada o implementación preparada/realizada.
- Las puertas de calidad requeridas pasan o el usuario acepta explícitamente las limitaciones documentadas.
Si la puerta falla:
- Enruta la puerta fallida a la habilidad hija responsable más pequeña.
- Vuelve a ejecutar la validación afectada.
- Detente e informa del bloqueador solo cuando falte contenido del usuario, credenciales faltantes, activos no disponibles o acciones de cuenta externa impidan el progreso.
Habilidades Hijas
Usa estas habilidades como los bloques de construcción del flujo de trabajo:
search-blog-theme: descubre y compara direcciones de temas para sitios web personales/blogs.find-style-references: busca e inspecciona sitios web/plantillas/capturas de pantalla reales para una dirección elegida y produce un breve resumen de referencia listo para construir.make-personal-site: crea un sitio personal estático original sin dependencias.copy-website-style: recrea el estilo, diseño, movimiento y tipos de página de un sitio web de referencia específico.personalize-site: reemplaza el contenido de marcador de posición/demo/fuente con el contenido propio del usuario.add-blog-posts: importa Markdown, notas de Obsidian, borradores de Word, publicaciones HTML antiguas, imágenes, matemáticas, enlaces y otros escritos a un sitio existente.edit-site-part: realiza cambios locales enfocados en una sección, componente, bloque de copia, detalle de estilo o interacción específicos.review-static-site: valida la salida estática en busca de enlaces, tipos de página, renderizado del navegador, codificación, residuos de marcadores de posición, compatibilidad de apertura directa y corrección de rutas.publish-static-site: prepara o realiza la implementación en GitHub Pages, Cloudflare Pages, Netlify o Vercel.
Si el nombre de una habilidad hija cambia, prefiere la habilidad instalada localmente con el propósito coincidente.
Matriz de Contrato de Habilidades Hijas
Usa esta matriz para decidir transferencias y bucles de reparación:
| Habilidad hija | Entrada requerida | Salida esperada | Puerta de éxito | Si la puerta falla |
|---|---|---|---|---|
search-blog-theme | Gusto del usuario, propósito, referencias o palabras clave | 3-5 direcciones, URLs de referencia verificadas, una recomendación | La dirección es lo suficientemente específica para construir | Buscar más referencias, afinar la metáfora o hacer una pregunta de preferencia |
find-style-references | Dirección de estilo elegida, tipo de sitio, palabras de ambiente o ejemplos | 4-8 referencias reales, observaciones del navegador, resumen de diseño listo para construir | Múltiples ángulos de búsqueda y al menos 3 referencias sólidas inspeccionadas cuando sea posible | Ampliar la búsqueda, inspeccionar referencias más sólidas o volver a search-blog-theme |
make-personal-site | Dirección, pistas de contenido/perfil, alcance de página, carpeta de salida | Sitio estático simple con páginas representativas, activos, EDITING.md | Tipos de página requeridos, rutas relativas, fuente UTF-8, vista previa local | Arreglar estructura/rutas/activos, luego review-static-site |
copy-website-style | URL/captura de pantalla/plantilla de destino y alcance | Recreación de estilo estático con mapa de página, marcadores de posición/contenido de usuario, EDITING.md | Diseño/movimiento/tipos de página característicos coinciden con la fidelidad solicitada | Reinspeccionar el objetivo, iterar la recreación, luego review-static-site |
personalize-site | Sitio existente más identidad/contenido del usuario | Identidad reemplazada, enlaces, metadatos, activos, limpieza de marcadores de posición/fuente | Contenido del usuario visible y residuos eliminados | Reinventariar las ubicaciones de contenido o usar edit-site-part para el ajuste del diseño |
add-blog-posts | Sitio existente más publicaciones/activos de origen | Nuevas páginas de publicaciones, índices/datos actualizados, activos copiados, notas de edición | Las publicaciones se renderizan, enlaces/activos/matemáticas/contenido enriquecido funcionan | Arreglar conversión/índice/activos o usar edit-site-part para problemas de presentación local |
edit-site-part | Sitio existente más página/región/cambio de destino | Edición pequeña y enfocada de código/contenido/estilo/interacción | La misma región del navegador muestra el cambio solicitado sin roturas no relacionadas | Reasignar fuente y hacer una edición correctiva más pequeña |
review-static-site | Raíz estática, alcance esperado, cadenas prohibidas/referencia opcionales | Hallazgos o correcciones, resultado de auditoría/navegador, estado de aprobación/rechazo | No quedan bloqueadores | Enrutar el bloqueador a la habilidad hija responsable más pequeña |
publish-static-site | Raíz de implementación validada más plataforma/modo elegidos | Configuraciones/archivos de implementación, URL en vivo opcional, verificación posterior a la implementación | Carpeta correcta implementada y URL en vivo funciona | Arreglar bloqueadores locales, configuraciones de implementación o pasos de cuenta/DNS |
Principios Operativos
- Enruta primero, luego ejecuta. Decide la cadena correcta antes de hacer ediciones amplias.
- Mantén la salida de cada paso utilizable por el siguiente paso.
- Prefiere HTML/CSS/JS simple y cero dependencias para esta versión a menos que el usuario solicite explícitamente otra pila.
- No conviertas un sitio personal o blog en una página de destino de marketing.
- No inventes hechos personales detallados cuando falten datos del usuario.
- Reemplaza la identidad de la fuente copiada por defecto en las recreaciones de estilo.
- Usa enlaces y activos relativos a la página por defecto; evita rutas absolutas locales del sitio como
/assets/...o/posts/.... - Valida con
review-static-sitedespués de cualquier generación, recreación, personalización, importación de publicaciones o edición amplia. - Detente en un sitio local validado a menos que el usuario solicite explícitamente publicar.
- No crees repositorios, hagas push de código, implementes, vincules dominios ni cambies DNS a menos que el usuario lo solicite explícitamente.
Recepción
Recopila solo la información necesaria para la siguiente decisión. No entrevistes al usuario en exceso.
Entradas útiles:
- Carpeta de salida deseada o carpeta del sitio existente.
- Si el usuario quiere un sitio nuevo, una recreación de una referencia, importación de contenido, personalización, una edición local, validación o publicación.
- URLs de referencia, capturas de pantalla, plantillas o palabras de tema.
- Materiales de identidad del usuario: nombre, biografía, enlaces, currículum, proyectos, avatar/logo, página de inicio antigua, perfil de GitHub.
- Materiales de contenido: Markdown, notas de Obsidian, documentos de Word, publicaciones antiguas, carpetas de imágenes o texto pegado.
- Destino de publicación: GitHub Pages, Cloudflare Pages, Netlify, Vercel o solo orientación.
Si la solicitud es lo suficientemente clara, procede. Haz una pregunta concisa solo cuando múltiples rutas producirían un trabajo muy diferente.
Enrutador
Elige el flujo de trabajo según el estado actual del usuario:
- Idea vaga o "encuéntrame un estilo": usa
search-blog-theme, luegofind-style-referencesantes de una construcción original. - Dirección elegida y sin sitio de destino específico: usa
find-style-references, luegomake-personal-site. - URL/captura de pantalla/plantilla de destino específica para coincidir estrechamente: usa
copy-website-style. - Sitio generado existente que aún tiene marcadores de posición o identidad copiada: usa
personalize-site. - Sitio existente más nuevos artículos/notas/documentos: usa
add-blog-posts. - Sitio existente más un pequeño cambio visual/de copia/diseño/interacción: usa
edit-site-part. - "Revisa este sitio", "¿es lo suficientemente bueno?", "antes de publicar": usa
review-static-site. - "Implementa", "publica", "GitHub Pages", "Cloudflare Pages", "Netlify", "Vercel": usa
publish-static-site, después dereview-static-site.
Cuando el usuario solicite una construcción completa con un clic, elige la cadena más corta que maneje las entradas reales. No ejecutes todas las habilidades hijas solo porque existen.
Ejemplos de Ruta
Usa estos ejemplos para estabilizar el enrutamiento:
| Patrón de solicitud del usuario | Ruta |
|---|---|
| "Quiero un blog personal distintivo, ayúdame a elegir un estilo" | search-blog-theme |
| "Encuentra referencias reales para este estilo elegido antes de construir" | find-style-references |
| "Hazme un sitio personal en esta dirección elegida" | find-style-references -> make-personal-site -> review-static-site |
| "Construye un blog personal completo desde cero" | search-blog-theme si es necesario -> find-style-references -> make-personal-site -> personalize-site si existe contenido -> review-static-site |
| "Usa esta URL como referencia y recréala" | copy-website-style -> personalize-site -> review-static-site |
| "Copia este sitio web pero reemplaza el contenido de la persona con el mío" | copy-website-style -> personalize-site -> review-static-site |
| "Aquí está mi sitio generado, reemplaza los marcadores de posición con mi biografía/proyectos/enlaces" | personalize-site -> review-static-site |
| "Agrega este artículo de Markdown/Obsidian/Word al sitio" | add-blog-posts -> review-static-site |
| "Cambia esta sección/color/título/tarjeta/menú" | edit-site-part; agrega review-static-site solo si la estructura compartida o los activos cambiaron |
| "Verifica si este sitio está listo" | review-static-site |
| "Implementa esto en Cloudflare Pages/GitHub Pages/Netlify/Vercel" | review-static-site -> publish-static-site |
| "Funciona localmente a través de HTTP pero no al hacer doble clic en index.html" | review-static-site; arregla fallas de puerta de ruta antes de publicar |
Tuberías Estándar
De la Idea al Sitio Original
Úsalo cuando el usuario solo tenga un objetivo aproximado o preferencia de estilo.
search-blog-themesi la dirección visual no está clara.find-style-referencespara basar la dirección elegida en sitios web/plantillas/capturas de pantalla reales.make-personal-sitepara crear el sitio estático.personalize-sitesi el usuario proporcionó identidad/contenido o el sitio tiene marcadores de posición que deben llenarse.review-static-sitecomo la puerta de control de calidad estricta.- Detente con instrucciones de vista previa local a menos que se haya solicitado la publicación.
De la Referencia al Sitio Personal
Úsalo cuando el usuario proporcione una URL de destino, captura de pantalla, plantilla v0, diseño de Figma o sitio web existente para coincidir.
copy-website-stylepara recrear el diseño, movimiento, tipos de página e interacciones.personalize-sitepara reemplazar la identidad de destino y el contenido de marcador de posición.add-blog-postssi el usuario proporcionó contenido de escritura.review-static-sitecomo la puerta de control de calidad estricta.- Detente con instrucciones de vista previa local a menos que se haya solicitado la publicación.
Blog Primero el Contenido
Úsalo cuando la entrada más sólida del usuario sean artículos, notas, Markdown, archivos de Word o un archivo de escritura antiguo.
- Usa
search-blog-themesolo si no existe sitio/tema. - Usa
find-style-referencessi se necesita un nuevo sistema visual original. - Usa
make-personal-sitesi aún no existe un sitio estático. - Usa
add-blog-postspara importar el contenido al sistema de publicaciones del sitio existente. - Usa
personalize-sitesi el contenido de identidad/perfil sigue siendo genérico. - Usa
review-static-sitecomo la puerta de control de calidad estricta. - Detente con instrucciones de vista previa local a menos que se haya solicitado la publicación.
Mejora de Sitio Existente
Úsalo cuando el usuario ya tenga una carpeta de sitio generado.
- Inspecciona el sitio y
EDITING.mdsi está presente. - Usa
personalize-sitepara el reemplazo de identidad/contenido. - Usa
add-blog-postspara importaciones de artículos. - Usa
edit-site-partpara cambios de diseño o copia enfocados. - Usa
review-static-sitecuando el cambio afecte la navegación, tipos de página, activos, codificación, preparación para publicación o más de una página.
Sitio Listo para Publicar
Úsalo cuando el usuario solicite publicar o implementar.
- Usa
review-static-siteprimero. - Arregla bloqueadores o enruta a la habilidad hija relevante si la revisión encuentra problemas.
- Usa
publish-static-sitesolo después de que el sitio pase las verificaciones locales necesarias o el usuario acepte riesgos conocidos. - Verifica la URL en vivo cuando ocurra la implementación.
Puertas de Calidad
El flujo de trabajo no termina hasta que las puertas relevantes pasen o el usuario acepte una limitación explícita.
Puerta de tema:
- La dirección visual o la referencia es lo suficientemente específica para construir.
- Si la construcción es original y se basa en palabras de gusto, se han buscado referencias de estilo reales desde múltiples ángulos y se han inspeccionado al menos 3 referencias sólidas cuando sea posible, o el usuario renunció explícitamente a ese paso.
- El enfoque elegido coincide con el tipo de sitio del usuario: blog, portafolio, página de inicio de investigación, jardín digital, notas, enlaces o híbrido.
Puerta de estructura:
- Existen los tipos de página requeridos, no solo la página de inicio.
- Los sitios similares a blogs incluyen al menos una página de artículo/detalle y un punto de entrada de lista/archivo.
- La navegación apunta a páginas generadas reales.
Puerta de contenido:
- La identidad/contenido proporcionado por el usuario aparece en los lugares previstos.
- El contenido solo de marcador de posición está claramente marcado o reemplazado.
- La identidad del sitio de origen copiado se elimina de las recreaciones de estilo a menos que el usuario la posea o tenga permiso.
Puerta de ruta:
- Los enlaces y activos locales del sitio son relativos a la página por defecto.
- Las páginas anidadas usan la profundidad correcta
../. - HTML, CSS
url(...), enlaces generados por JavaScript, archivos de datos, imágenes de portada, fuentes y activos de proveedor evitan rutas absolutas accidentales. - La apertura directa de
index.htmlno debe perder CSS, JS, imágenes ni navegación.
Puerta de codificación:
- Todo el código fuente HTML, CSS, JS y de datos es UTF-8 sin BOM.
- No se utilizan caracteres escapados o entidades HTML para caracteres fuera de ASCII cuando está disponible la codificación UTF-8 adecuada.
- Los metadatos de idioma (atributo
langen<html>) coinciden con el contenido real. - Las páginas mixtas (por ejemplo, publicaciones de blog en inglés en un sitio español) pueden tener metadatos de idioma en el nivel de la página.
- Las entradas mixtas (por ejemplo, publicaciones con caracteres japoneses, árabes o cirílicos) se renderizan correctamente.
Puerta del navegador:
- El sitio se abre en navegadores de escritorio y móviles modernos (Chrome, Firefox, Safari, Edge) sin errores de consola de JavaScript.
- El estilo visual no se rompe por diferencias de navegador.
- Las interacciones planificadas (menús, acordeones, galerías, clics/desplazamiento suave) funcionan.
- Las páginas tienen un tamaño, espaciado y legibilidad razonables en tamaños de ventana de escritorio y dispositivos móviles comunes.
- Las páginas de error 404 personalizadas se sirven correctamente sin ruptura de CSS/ruta.
- El contenido importado que depende de JavaScript, iframes embebidos o fuentes externas se carga en contextos de archivo local. Si no, se documenta explícitamente como una limitación conocida.
Puerta de preparación para publicación:
- Todas las puertas anteriores pasan.
- La estrategia de implementación coincide con la plataforma del usuario: construcción desde la fuente adecuada, configuración de ruta y metadatos.
- No hay dependencias de construcción que la plataforma no pueda ejecutar.
- Los activos, fuentes y API de terceros se sirven desde rutas/URLs que funcionarán en producción.
- Las variables de entorno requeridas están documentadas.