Communitygithub.com

tsumu-criar-site

Crie um novo site ou landing page Tsumu editável do zero, com design responsivo e animado, e receba um link de importação único.

O que é tsumu-criar-site?

Esta habilidade permite criar sites Tsumu completos e editáveis a partir de um pedido do usuário, indo além de simples rascunhos ou mockups. O processo é dividido em duas fases: primeiro, o agente projeta livremente a estrutura e o conteúdo do site (incluindo informações, layout, tipografia e responsividade), sem se preocupar com o esquema interno do Tsumu; depois, converte esse design original em um SiteDoc nativo, usando as ferramentas MCP `get_site_doc_spec` e `stage_site_doc`. O resultado final é um link privado de importação que o usuário utiliza para abrir o site no Tsumu e continuar editando. A habilidade enfatiza a originalidade do design e a fidelidade entre a concepção e o SiteDoc gerado, evitando repetir modelos genéricos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abshrimp/tsumu-mcp/tree/HEAD/plugins/claude/skills/tsumu-build-site

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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_doc diretamente, 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-site e 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.json vá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 para stage_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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.

  1. 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.ts e skills/tsumu/references/site-doc.md do Tsumu, quando acessíveis.
  2. Construa um objeto SiteDoc completo (não uma string JSON, página HTML ou arquivo compactado). Campos obrigatórios: schemaVersion: 1, siteName não vazio, pages, pageOrder, nodes, assets. A página inicial tem slug: "". children de páginas e nós referem-se a IDs de nós; nós são box editáveis, image, etc. Texto e títulos usam box.text, não um nó heading inventado.
  3. 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.
  4. 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 attrId HTML 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.
  5. stage_site_doc aceita apenas o SiteDoc completo como doc (até 12 MiB de JSON serializado). Ele não aceita o protótipo HTML da Fase 1, ZIPs ou ativos binários separados. Use assets: {} quando possível, imagens externas verificadas quando adequado, ou pequenos ativos dataUrl embutidos dentro do limite. Não invente caminhos de armazenamento do Tsumu.
  6. 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.default ou na substituição responsiva relevante, não em um campo style, css ou className inventado. 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> }); use editorOrigin apenas quando o usuário solicitar uma instalação Tsumu auto-hospedada específica.
  • Uma transferência bem-sucedida de novo site inclui o importUrl exato 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.

Habilidades Relacionadas