Criar um novo site Tsumu
Use quando o usuário pedir para criar um novo site no Tsumu. A entrega é um site Tsumu real e editável, não uma descrição de design, captura de tela, mockup HTML ou site vazio.
Entrega: um link de importação Tsumu privado
Para um novo site solicitado pelo usuário, o resultado bem-sucedido de stage_site_doc inclui um importUrl. Este é o artefato de transferência que o solicitante usa para abrir o site gerado no Tsumu. Inclua esse link exato com uma breve descrição do que foi construído; nenhuma solicitação adicional pelo link é necessária. O link é privado e não deve ser copiado para logs, contextos não relacionados ou serviços de terceiros. Nunca invente ou reconstrua-o.
Um link preparado não é prova de importação, publicação ou implantação. Não afirme que essas ações ocorreram.
Escolha o fluxo de trabalho
- Criar um novo site: use
stage_site_docdiretamente, mesmo se nenhum site existente estiver pareado. O usuário pode autorizar apenas a criação de novo site na tela OAuth do MCP sem um código de conexão de site. Uma autorização de site pareado existente também pode preparar um novo site. - Editar o site existente do usuário: ative
tsumu-editar-sitee use as ferramentas do editor pareado. Não prepare uma cópia nem sobrescreva o site existente. - Sem ferramenta de preparação ou sem autorização bem-sucedida: não invente uma URL. Se a criação de artefatos estiver disponível, produza um
doc.jsonválido para download; caso contrário, explique a capacidade ausente e o que pode ser feito. create_siteé para criar um site vazio local no navegador em um editor já pareado. Ele não faz upload de um design completo gerado e requer parear o novo site novamente. Não o use como substituto parastage_site_doc.
Criação em duas etapas: projete livremente, depois converta para Tsumu
Fase 1 — crie um conceito de site original antes de trabalhar no formato SiteDoc. Trate o pedido do usuário como um briefing de design de site, não como uma instrução para reestilizar um documento JSON de exemplo.
- Decida o propósito do site, público-alvo, mensagem-chave, páginas, prioridades de conteúdo e ação principal do usuário. Para pedidos vagos como "crie um site bonito", escolha um conceito distinto e plausível de forma independente, em vez de usar o portfólio de exemplo padrão ou fazer perguntas desnecessárias. Não invente endereços reais, depoimentos, alegações de produtos ou preços.
- Projete o site como se o esquema de nós do Tsumu não existisse. Elabore uma arquitetura de informação original, conteúdo página por página, composições de seção, hierarquia, tipografia, cores, imagens ou elementos gráficos, espaçamento e comportamento responsivo. Evite repetir mecanicamente um template genérico de herói/recursos/depoimentos/contato.
- Quando ferramentas e tempo permitirem, elabore o design completo como um protótipo HTML/CSS independente (com notas claras de interação) para explorar o layout livremente. Caso contrário, prepare um blueprint de página e componente igualmente específico. Este é um artefato de design intermediário, não a entrega final ou uma afirmação de que o Tsumu pode importar HTML arbitrário através de
stage_site_doc. Não exija uma prévia ao vivo se nenhuma estiver disponível. - Critique o rascunho em relação ao briefing: ele tem uma identidade visual reconhecível, conteúdo crível, seções com propósito, uma jornada de usuário clara e um layout para dispositivos móveis? Refine-o antes de consultar layouts de exemplo de SiteDoc.
Fase 2 — traduza esse design para um SiteDoc Tsumu nativo e editável. Agora consulte get_site_doc_spec, o guia de esquema e o exemplo mínimo para aprender as formas de dados válidas, não para decidir como o site deve parecer. Reconstrua as páginas e layouts projetados usando os elementos nativos suportados pelo Tsumu, estilos, ativos e interações. Preserve as composições distintas, tipografia, espaçamento, conteúdo e intenções responsivas do design intermediário, em vez de reduzi-lo a um exemplo recolorido. Se um detalhe não for suportado, adapte-o para a representação editável válida mais próxima ou divulgue a limitação; nunca invente campos de esquema.
Verificação de originalidade: Compare o SiteDoc convertido com o design da Fase 1 antes de preparar. Se o site final for essencialmente o exemplo agrupado com palavras, cores ou imagens alteradas, a conversão falhou: redesenhe a estrutura e composição. Se o usuário solicitar explicitamente um template específico, siga esse pedido.
Converta o design original em SiteDoc
Antes de construir qualquer SiteDoc: chame a ferramenta MCP somente leitura get_site_doc_spec e inspecione tanto seu guide quanto example. Faça isso após planejar o design original, mas antes de criar qualquer página, nó, estilo, script ou a primeira tentativa de stage_site_doc do SiteDoc. A referência está disponível com uma autorização OAuth apenas para novo site. Não pule esta etapa apenas porque o texto da Skill foi carregado; alguns clientes MCP não buscam referências automaticamente. Se a ferramenta de especificação não estiver disponível, leia references/site-doc.md e references/minimal-site.json. Nunca adivinhe formas de dados.
- Traduza o mapa de páginas, conteúdo e composições do site da Fase 1 para SiteDoc. Não comece com o JSON de exemplo e substitua seu texto ou paleta. O guia e exemplos descrevem apenas propriedades e relacionamentos válidos. Para recursos avançados, consulte os atuais
lib/types.ts,lib/presets.ts,lib/site-import-format.tseskills/tsumu/references/site-doc.mddo Tsumu, quando acessíveis. - Construa um objeto
SiteDoccompleto (não uma string JSON, página HTML ou arquivo compactado). Campos obrigatórios:schemaVersion: 1,siteNamenão vazio,pages,pageOrder,nodes,assets. A página inicial temslug: "".childrende páginas e nós referem-se a IDs de nós; nós sãoboxeditáveis,image, etc. Texto e títulos usambox.text, não um nóheadinginventado. - Crie layouts de página nativos significativos que correspondam à estrutura projetada. Atribua aos nós rótulos semânticos adequados, estilos e substituições responsivas. Preserve a hierarquia real, espaçamento, contraste tipográfico, acentos visuais e variação de seção da Fase 1. Verifique destinos de navegação, texto alternativo, contraste e comportamento em dispositivos móveis. Evite ativos quebrados, links vazios, conteúdo de espaço reservado e elementos fora da tela.
- Se o design incluir animações, scripts, componentes ou comportamento de formulários, consulte as definições de tipo exatas atuais e implemente apenas estruturas suportadas. Os alvos do elemento de script usam o
attrIdHTML do nó alvo, não seu ID de nó SiteDoc;@selfé apenas para um script anexado a um elemento. Verifique cada etapa e condição aninhada. Não invente propriedades de movimento ou script nem descreva um botão inerte como funcional. stage_site_docaceita apenas o SiteDoc completo comodoc(até 12 MiB de JSON serializado). Ele não aceita o protótipo HTML da Fase 1, ZIPs ou ativos binários separados. Useassets: {}quando possível, imagens externas verificadas quando adequado, ou pequenos ativosdataUrlembutidos dentro do limite. Não invente caminhos de armazenamento do Tsumu.- Revise o SiteDoc resultante em relação ao design original, não em relação à estética do exemplo. Certifique-se de que permanece totalmente editável e estruturalmente válido; se a conversão perder layout ou conteúdo distinto, melhore a hierarquia de elementos nativos antes de preparar.
Verifique e entregue
- Antes de preparar, compare as páginas finais com o design da Fase 1 e confirme que são um site fiel e composto de forma independente, não um exemplo mínimo reestilizado. Mantenha o design intermediário privado, a menos que o usuário o solicite; entregue o SiteDoc ou link de importação como resultado final.
- Antes de preparar, garanta que toda declaração de design visível esteja colocada em
nodes[id].styles.base.defaultou na substituição responsiva relevante, não em um campostyle,cssouclassNameinventado. Os valores reais das declarações CSS devem ser strings. Verifique IDs, referências, árvores acíclicas e as regras de importação. Verifique a hierarquia de páginas, responsividade e interações solicitadas na medida que as ferramentas permitirem. Não diga que você visualizou a menos que realmente o tenha feito. - Chame
stage_site_doc({ doc: <SiteDoc completo> }); useeditorOriginapenas quando o usuário solicitar uma instalação Tsumu auto-hospedada específica. - Uma transferência bem-sucedida de novo site inclui o
importUrlexato da ferramenta como um link clicável para o solicitante, além de uma breve explicação de que abri-lo importa um novo site editável. O link não é uma URL de site publicado. - Se falhar, informe o erro real e evite afirmar que o site foi salvo. Não substitua uma ação de ferramenta falha por um link inventado nem mude silenciosamente para um site existente.
- O link contém um token de acesso privado no fragmento da URL, expira após uma hora e é consumido após o Tsumu confirmar a importação bem-sucedida. Não o divulgue a outros. Importações com falha podem ser repetidas após o término da concessão temporária de cinco minutos.
Exemplo de transferência (apenas ilustrativo): "O site editável do café está preparado para importação. O link de importação Tsumu privado está disponível para a próxima hora." A transferência real inclui o link gerado pela ferramenta real quando a preparação é bem-sucedida.