Crear un nuevo sitio web en Tsumu
Úsalo cuando el usuario solicite crear un sitio web nuevo en Tsumu. El entregable es un sitio Tsumu real y editable, no una descripción de diseño, captura de pantalla, maqueta HTML o sitio vacío.
Entregable: un enlace de importación privado de Tsumu
Para un sitio nuevo solicitado por el usuario, el resultado exitoso de stage_site_doc incluye un importUrl. Este es el artefacto de entrega que quien solicita usa para abrir el sitio generado en Tsumu. Incluye ese enlace exacto con una breve descripción de lo que se creó; no es necesario solicitar el enlace adicionalmente. El enlace es privado y no debe copiarse en registros, contextos no relacionados ni servicios de terceros. Nunca inventes ni reconstruyas el enlace.
Un enlace preparado no es prueba de importación, publicación o despliegue. No afirmes que esas acciones han ocurrido.
Elegir el flujo de trabajo
- Crear un nuevo sitio: usa
stage_site_docdirectamente, incluso si no hay un sitio existente vinculado. El usuario puede autorizar solo la creación de un nuevo sitio en la pantalla de autorización OAuth de MCP sin un código de conexión de sitio. Una autorización de sitio vinculado existente también puede preparar un nuevo sitio. - Editar el sitio existente del usuario: activa
tsumu-edit-sitey utiliza las herramientas de edición vinculadas. No prepares una copia ni sobrescribas el sitio existente. - Sin herramienta de preparación o sin autorización exitosa: no fabriques una URL. Si la creación de artefactos está disponible, produce un
doc.jsondescargable válido; de lo contrario, explica la capacidad faltante y qué se puede hacer. create_sitees para crear un sitio vacío local en el navegador, en un editor ya vinculado. No sube un diseño completo generado y requiere vincular el nuevo sitio nuevamente. No lo uses como sustituto destage_site_doc.
Creación en dos fases: diseña libremente, luego convierte a Tsumu
Fase 1: crea un concepto de sitio web original antes de trabajar en el formato SiteDoc. Trata la solicitud del usuario como un brief de diseño web, no como una instrucción para reemplazar el contenido de un documento JSON de ejemplo.
- Decide el propósito del sitio, la audiencia, el mensaje clave, las páginas, las prioridades de contenido y la acción principal del usuario. Para solicitudes vagas como "crea un sitio web bonito", elige un concepto distintivo y verosímil de forma independiente, sin recurrir al portafolio de ejemplo ni hacer preguntas innecesarias. No inventes direcciones reales, testimonios, afirmaciones sobre productos ni precios.
- Diseña el sitio web como si el esquema de nodos de Tsumu no existiera. Crea una arquitectura de información original, contenido página por página, composiciones de secciones, jerarquía, tipografía, colores, imágenes o elementos gráficos, espaciado y comportamiento responsivo. Evita repetir mecánicamente la plantilla genérica de héroe/características/testimonios/contacto.
- Cuando las herramientas y el tiempo lo permitan, redacta el diseño completo como un prototipo HTML/CSS autónomo (y notas claras de interacción) para explorar el layout libremente. De lo contrario, prepara un plano de página y componente igualmente específico. Este es un artefacto de diseño intermedio, no el entregable final ni una afirmación de que Tsumu puede importar HTML arbitrario a través de
stage_site_doc. No exijas una vista previa en vivo si no está disponible. - Evalúa el borrador contra el brief: ¿tiene una identidad visual reconocible, contenido creíble, secciones con propósito, un recorrido de usuario claro y un layout móvil? Refínalo antes de consultar ejemplos de layouts SiteDoc.
Fase 2: traduce ese diseño a un SiteDoc nativo y editable de Tsumu. Solo ahora consulta get_site_doc_spec, la guía del esquema y el ejemplo mínimo para aprender las formas de datos válidas, no para decidir cómo debería verse el sitio. Reconstruye las páginas y layouts diseñados utilizando los elementos nativos, estilos, recursos e interacciones compatibles con Tsumu. Conserva las composiciones distintivas, la tipografía, el espaciado, el contenido y las intenciones responsivas del diseño intermedio, en lugar de reducirlo a un ejemplo con colores cambiados. Si un detalle no es compatible, adáptalo a la representación editable válida más cercana o revela la limitación; nunca inventes campos del esquema.
Verificación de originalidad: compara el SiteDoc convertido con el diseño de la Fase 1 antes de prepararlo. Si el sitio final es esencialmente el ejemplo incluido con palabras, colores o imágenes cambiados, la conversión ha fallado: rediseña la estructura y la composición. Si el usuario solicita explícitamente una plantilla específica, sigue esa solicitud.
Convertir el diseño original en SiteDoc
Antes de construir cualquier SiteDoc: llama a la herramienta MCP de solo lectura get_site_doc_spec e inspecciona tanto su guide como su example. Hazlo después de planificar el diseño original pero antes de crear cualquier página, nodo, estilo, script o el primer intento de stage_site_doc. La referencia está disponible con una autorización OAuth de solo sitio nuevo. No la saltes solo porque se cargó el texto del Skill; algunos clientes MCP no obtienen las referencias automáticamente. Si la herramienta de especificación no está disponible, lee references/site-doc.md y references/minimal-site.json. Nunca adivines las formas de los datos.
- Traduce el mapa de páginas, contenido y composiciones del sitio de la Fase 1 a SiteDoc. No empieces con el JSON de ejemplo y reemplaces su copia o paleta. La guía y los ejemplos describen únicamente propiedades y relaciones válidas. Para funciones avanzadas, consulta los archivos actuales de Tsumu
lib/types.ts,lib/presets.ts,lib/site-import-format.tsyskills/tsumu/references/site-doc.mdcuando estén accesibles. - Construye un objeto
SiteDoccompleto (no una cadena JSON, página HTML o archivo comprimido). Campos obligatorios:schemaVersion: 1,siteNameno vacío,pages,pageOrder,nodes,assets. La página de inicio tieneslug: "". Loschildrende páginas y nodos se refieren a IDs de nodos; los nodos sonbox,image, etc. editables. El texto y los encabezados usanbox.text, no un nodoheadinginventado. - Crea diseños de página nativos significativos que coincidan con la estructura diseñada. Asigna a los nodos etiquetas semánticas, estilos y anulaciones responsivas adecuadas. Conserva la jerarquía real, el espaciado, el contraste tipográfico, los acentos visuales y la variación de secciones de la Fase 1. Verifica los destinos de navegación, texto alternativo, contraste y comportamiento móvil. Evita recursos rotos, enlaces vacíos, contenido placeholder y elementos fuera de la pantalla.
- Si el diseño incluye animaciones, scripts, componentes o comportamiento de formularios, consulta las definiciones de tipo actuales exactas e implementa solo las estructuras compatibles. Los objetivos de elementos de script usan el
attrIdHTML del nodo destino, no su ID de nodo SiteDoc;@selfes solo para un script adjunto a un elemento. Verifica cada paso y condición anidados. No inventes propiedades de movimiento o scripts, ni describes un botón inerte como funcional. stage_site_docacepta solo el SiteDoc completo comodoc(hasta 12 MiB de JSON serializado). No acepta el prototipo HTML de la Fase 1, ZIPs o recursos binarios separados. Usaassets: {}cuando sea posible, imágenes externas verificadas cuando sea adecuado, o pequeños recursosdataUrlincrustados dentro del límite. No inventes rutas de almacenamiento de Tsumu.- Revisa el SiteDoc resultante contra el diseño original, no contra la estética del ejemplo. Asegúrate de que siga siendo completamente editable y estructuralmente válido; si la conversión pierde el layout o contenido distintivo, mejora la jerarquía de elementos nativos antes de prepararlo.
Verificar y entregar
- Antes de preparar, compara las páginas finales con el diseño de la Fase 1 y confirma que son un sitio web fiel y compuesto de forma independiente, no un ejemplo mínimo con cambios superficiales. Mantén el diseño intermedio privado a menos que el usuario lo solicite; entrega el SiteDoc o el enlace de importación como resultado final.
- Antes de preparar, asegúrate de que cada declaración de diseño visible se coloque en
nodes[id].styles.base.defaulto en la anulación responsiva correspondiente, no en un campo inventadostyle,cssoclassName. Los valores de las declaraciones CSS reales deben ser cadenas. Verifica IDs, referencias, árboles acíclicos y las reglas de importación. Verifica la jerarquía de páginas, la capacidad de respuesta y las interacciones solicitadas en la medida que las herramientas lo permitan. No digas que lo previsualizaste a menos que realmente lo hayas hecho. - Llama a
stage_site_doc({ doc: <SiteDoc completo> }); usaeditorOriginsolo cuando el usuario solicite una instalación específica autoalojada de Tsumu. - Una entrega exitosa de un sitio nuevo incluye el
importUrlexacto de la herramienta como un enlace en el que se puede hacer clic para quien lo solicita, además de una breve explicación de que al abrirlo se importa un nuevo sitio editable. El enlace no es una URL de sitio publicado. - Si falla, indica el error real y evita afirmar que el sitio se guardó. No reemplaces una acción de herramienta fallida con un enlace inventado ni cambies silenciosamente a un sitio existente.
- El enlace contiene un token de acceso privado en el fragmento de su URL, caduca después de una hora y se consume después de que Tsumu confirme la importación exitosa. No lo reveles a otros. Las importaciones fallidas pueden reintentarse después de que expire el arrendamiento temporal de reclamación de cinco minutos.
Ejemplo de entrega (solo ilustrativo): "El sitio editable de la cafetería está preparado para importar. El enlace de importación privado de Tsumu está disponible durante la próxima hora." La entrega real incluye el enlace real generado por la herramienta cuando la preparación es exitosa.