MarkitUI: construir páginas
Convierte un brief, un mapa del sitio, una lista de páginas, un sitio web de referencia o un sitio web existente en páginas terminadas dentro del archivo Figma de MarkitUI del usuario. El flujo es siempre:
bloque de biblioteca → bloque de proyecto → página compuesta en un componente Breakpoint → marcos separados {Página} / xl y {Página} / base (y {Página} / md si el usuario quiere tablet) en una Sección por página → notas de entrega.
La documentación del propio archivo es la fuente de verdad. Al inicio de cada ejecución, lee los marcos de documentación Composing pages, Layout y Breakpoints en la página de Documentación, y el marco de documentación Navigation para la lista de categorías de bloques. Cuando el sitio tenga blog, changelog, historias de clientes o eventos, lee también el marco de documentación Archive pages en la página de Archive Components y el marco de documentación Assembling archive and detail pages en la página de Blog (Archive / Post). Si algo en esta habilidad está en desacuerdo con ellos, sigue el archivo.
Antes de empezar
- Trabaja solo en la copia del usuario de MarkitUI. Pide su enlace de Figma si no lo tienes.
- Escribir en Figma necesita el servidor MCP de Figma con acceso de escritura. Carga la guía del MCP de Figma para escribir en archivos (su habilidad
figma-use) antes de la primera edición, y crea una sesión primero si el servidor lo solicita. - Cambia de páginas de Figma como máximo una vez por script. Encuentra páginas, componentes y colecciones de variables por nombre, no por ID.
- Los bloques de biblioteca y los componentes base son definitivos. Nunca los edites para hacer que una página funcione. Si algo no se puede hacer con un bloque tal como está, díselo al usuario y pregunta.
Preguntas iniciales
Antes de cualquier planificación, pregunta lo que el prompt del usuario no aclare ya, en un mensaje (usa preguntas de opción múltiple cuando la interfaz las ofrezca). Omite una pregunta solo cuando el prompt la responda de manera inequívoca.
-
¿A partir de qué se deben construir las páginas?
- un brief o descripción del negocio
- un mapa del sitio o lista de páginas
- un sitio web de referencia a seguir (solo estructura, nuevo contenido)
- su sitio web existente para reconstruir (conserva su contenido)
- cualquier otra cosa que tengan: capturas de pantalla, un documento, sitios de la competencia, un wireframe
-
Variantes responsive: ¿cuántas variantes de breakpoint debe tener cada bloque y página?
- xl + base (escritorio y móvil; por defecto, los bloques de biblioteca están listos)
- xl + md + base (añade tablet: una variante md en cada bloque de proyecto y un marco md para cada página)
- md solo para algunas páginas (ellos nombran las páginas)
Proporciona la compensación de una línea de
references/responsive.md. Nunca añadas md sin un sí. -
Nombre del proyecto, usado en cada nombre de componente (ej.
Acme). -
Tipo de sitio: sitio web de marketing, tienda online, o ambos.
-
Dónde construir: una nueva página de Figma en el archivo (ej.
↳ Páginas Acme) a menos que el usuario nombre una. -
Contenido: el contenido real del usuario, contenido escrito al estilo de un sitio de referencia, o contenido placeholder creíble.
-
Para tiendas: país, moneda y formato de número, tasa de IVA o impuesto sobre ventas.
Luego recoge lo que necesite la fuente elegida: el brief, el mapa del sitio o la URL del sitio web (y para un sitio de referencia o existente, lee references/existing-site.md).
Usa bloques de proyecto por defecto. Usa bloques de biblioteca directamente solo si el usuario pide un prototipo rápido o una landing page única.
Flujo de trabajo
Fase 1: Plan de página (detente para aprobación). Lee references/page-planning.md. El plan indica los breakpoints que eligió el usuario. Inventaría la biblioteca, elige bloques para cada página y presenta la tabla del plan. Para páginas de Blog, Changelog, Historias de Clientes o Eventos y Webinars, lee references/content-types.md y planifica una página de archivo y una plantilla de detalle para cada una. Cuando la entrada sea un sitio web existente para reconstruir, lee primero references/existing-site.md; produce el mismo plan. Detente y espera la aprobación o cambios.
Fase 2: Bloques de proyecto. Lee references/project-blocks.md. Clona cada bloque de biblioteca elegido en un bloque de proyecto, renómbralo y adáptalo en el maestro. Construye también la barra de navegación, los menús y el pie de página como bloques de proyecto. Para bloques de archivo, configura los componentes de archivo (encabezado, barra lateral, paginación) en el maestro del bloque de proyecto como describe references/content-types.md. Si el usuario eligió md, lee references/responsive.md y añade una variante md a cada bloque de proyecto que usen las páginas md.
Fase 3: Compón las páginas. Lee references/composing.md y references/content.md. Construye cada página en xl dentro de un componente Breakpoint, duplícala para base (y md, siguiendo references/responsive.md), separa, nombra, envuelve en una Sección y distribuye en el lienzo.
Fase 4: Notas de entrega. Lee references/handoff.md. Añade la anotación de ruta a cada marco xl y anotaciones de comportamiento y contenido donde un marco estático no pueda mostrar lo que ocurre.
Verifica e informa. Lee references/checks.md. Ejecuta las comprobaciones del script, captura cada página en cada breakpoint que tenga, corrige lo que encuentres y luego informa.
Archivos de referencia: lee cada uno cuando llegue su fase
references/page-planning.md: anatomía de página, elección de bloques, tabla del plan. Fase 1.references/existing-site.md: reconstrucción de un sitio web existente. Fase 1, cuando la entrada sea un sitio en vivo.references/content-types.md: páginas de archivo y detalle para Blog, Changelog, Historias de Clientes y Eventos y Webinars; ArchiveHeader, ArchiveSidebar y ArchivePagination. Fases 1–3, cuando el sitio tenga alguno de ellos.references/project-blocks.md: clonación, nombrado, qué cambiar en el maestro, reglas de diseño. Fase 2.references/responsive.md: la opción md, añadir variantes md a bloques de proyecto, ensamblar páginas md con el componente Breakpoint. Preguntas iniciales, Fase 2 y Fase 3, cuando se elija md.references/composing.md: componente Breakpoint, xl y base, separación, nombrado, distribución en el lienzo. Fase 3.references/content.md: contenido, datos de tienda, fechas, imágenes. Fase 3.references/handoff.md: formatos de anotación de los que dependen los desarrolladores y la habilidad de generar código. Fase 4.references/checks.md: auditoría, capturas de pantalla y el informe. Última.
Innegociables
- Pregunta las preguntas iniciales que el prompt no responda, incluyendo las variantes responsive, antes de planificar.
- Detente después del plan y espera la aprobación. Nunca construyas páginas a partir de un plan no aprobado.
- Nunca edites bloques de biblioteca, componentes base o componentes de archivo; todos los cambios van en bloques de proyecto o anulaciones de instancia.
- Cada página tiene un marco xl y uno base (y un marco md si se eligió) construidos a partir de los mismos bloques, y el Breakpoint de cada bloque coincide con su marco.
- Todo se mantiene en variables y estilos de texto de MarkitUI. Sin colores crudos, espaciado, radios o configuraciones de fuente.
- Contenido real o creíble, nunca Lorem ipsum. Sin nombres de marca ni logotipos reales que no sean del usuario.
- Cada marco xl recibe una anotación de ruta en el formato exacto de
references/handoff.md.