Communitygithub.com

tsumu-build-site

Compétence de conception. Crée un nouveau site web ou une landing page Tsumu entièrement modifiable, incluant des designs multi-pages, responsifs et animés, puis fournit automatiquement à l'utilisateur un lien d'importation Tsumu unique. Pas pour des modifications sur un site existant.

Qu'est-ce que tsumu-build-site ?

Cette compétence permet aux agents IA de concevoir et de livrer un site web Tsumu entièrement éditable à partir d'une demande utilisateur, en remplaçant une simple esquisse HTML ou un site vide. Elle suit un processus en deux phases : d'abord, l'agent conçoit librement un concept de site original (architecture de l'information, contenu, mise en page, identité visuelle) sans être contraint par le schéma Tsumu, puis il traduit cette conception en un `SiteDoc` natif en utilisant les outils MCP (comme `get_site_doc_spec` et `stage_site_doc`). Le livrable final est une URL d'importation privée que l'utilisateur utilise pour ouvrir le site généré dans Tsumu. Cette compétence est utile pour créer rapidement des sites professionnels et originales, car elle garantit que le résultat n'est pas un simple remplacement de contenu sur un modèle générique, mais une création unique. Elle fonctionne via le protocole MCP pour interagir avec l'API Tsumu, et l'agent doit impérativement suivre les spécifications du schéma pour éviter de deviner les formats de données. La compétence est spécifiquement conçue pour la création de nouveaux sites et ne doit pas être utilisée pour modifier des sites existants.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Créer un nouveau site web Tsumu

À utiliser lorsque l'utilisateur demande de créer un nouveau site web dans Tsumu. Le livrable est un site Tsumu réel et modifiable, pas une description de conception, une capture d'écran, une maquette HTML ou un site vide.

Livrable : un lien d'importation Tsumu privé

Pour un nouveau site demandé par l'utilisateur, le résultat réussi de stage_site_doc inclut une importUrl. C'est l'artefact de remise que le demandeur utilise pour ouvrir le site généré dans Tsumu. Incluez ce lien exact avec une brève description de ce qui a été construit ; aucune demande supplémentaire pour le lien n'est nécessaire. Le lien est privé et ne doit pas être copié dans des logs, des contextes non liés ou des services tiers. Ne jamais inventer ou reconstruire ce lien.

Un lien mis en scène n'est pas une preuve d'importation, de publication ou de déploiement. Ne prétendez pas que ces actions ont eu lieu.

Choisir le flux de travail

  • Créer un nouveau site : utilisez stage_site_doc directement, même si aucun site existant n'est appairé. L'utilisateur peut autoriser la création d'un nouveau site uniquement dans l'écran d'autorisation MCP sans code de connexion de site. Une autorisation de site appairé existante peut également mettre en scène un nouveau site.
  • Modifier le site existant de l'utilisateur à la place : activez tsumu-edit-site et utilisez les outils d'édition appairés. Ne mettez pas en scène une copie et n'écrasez pas le site existant.
  • Pas d'outil de mise en scène ou pas d'autorisation réussie : ne fabriquez pas d'URL. Si la création d'artefact est disponible, produisez un doc.json téléchargeable valide ; sinon, expliquez la fonctionnalité manquante et ce qui peut être fait.
  • create_site est destiné à créer un site vide local au navigateur dans un éditeur déjà appairé. Il ne télécharge pas une conception générée complète et nécessite de réappairer le nouveau site. Ne l'utilisez pas comme substitut à stage_site_doc.

Création en deux passes : concevoir librement, puis convertir en Tsumu

Phase 1 — créez un concept de site web original avant de travailler au format SiteDoc. Traitez la demande de l'utilisateur comme un cahier des charges de conception de site web, et non comme une instruction pour habiller un exemple de document JSON.

  1. Déterminez l'objectif du site, son public, le message clé, les pages, les priorités de contenu et l'action principale de l'utilisateur. Pour des demandes vagues comme "créez un joli site web", choisissez un concept distinctif et plausible de manière indépendante plutôt que de prendre par défaut l'exemple de portfolio ou de poser des questions inutiles. N'inventez pas d'adresses, de témoignages, de revendications de produits ou de prix réels.
  2. Concevez le site web comme si le schéma de nœuds Tsumu n'existait pas. Élaborez une architecture de l'information originale, le contenu page par page, les compositions de sections, la hiérarchie, la typographie, les couleurs, les éléments graphiques ou visuels, l'espacement et le comportement responsive. Évitez de répéter mécaniquement un modèle générique hero/fonctionnalités/témoignages/contact.
  3. Lorsque les outils et le temps le permettent, rédigez la conception complète sous forme de prototype HTML/CSS autonome (et des notes d'interaction claires) pour explorer librement la mise en page. Sinon, préparez un plan de page et de composants tout aussi spécifique. Il s'agit d'un artefact de conception intermédiaire, pas du livrable final ni d'une affirmation selon laquelle Tsumu peut importer du HTML arbitraire via stage_site_doc. N'exigez pas d'aperçu en direct si aucun n'est disponible.
  4. Critiquez l'ébauche par rapport au cahier des charges : a-t-elle une identité visuelle reconnaissable, un contenu crédible, des sections utiles, un parcours utilisateur clair et une mise en page mobile ? Affinez-la avant de consulter les exemples de mises en page SiteDoc.

Phase 2 — traduisez cette conception en un SiteDoc Tsumu natif et modifiable. Ce n'est que maintenant que vous consultez get_site_doc_spec, le guide de schéma et l'exemple minimal pour apprendre les formes de données valides, et non pour décider à quoi le site doit ressembler. Reconstruisez les pages et mises en page conçues en utilisant les éléments natifs, styles, ressources et interactions pris en charge par Tsumu. Préservez les compositions distinctives, la typographie, l'espacement, le contenu et les intentions responsives de la conception intermédiaire plutôt que de les réduire à un exemple recolorié. Si un détail n'est pas pris en charge, adaptez-le à la représentation éditable valide la plus proche ou divulguez la limitation ; n'inventez jamais de champs de schéma.

Vérification d'originalité : Comparez le SiteDoc converti avec la conception de la phase 1 avant la mise en scène. Si le site final est essentiellement l'exemple fourni avec des mots, couleurs ou images changés, la conversion a échoué : reconcevez la structure et la composition. Si l'utilisateur demande explicitement un modèle spécifique, suivez plutôt cette demande.

Convertir la conception originale en SiteDoc

Avant de construire un SiteDoc : appelez l'outil MCP en lecture seule get_site_doc_spec et inspectez à la fois son guide et son example. Faites cela après avoir planifié la conception originale mais avant de créer des pages, nœuds, styles, scripts SiteDoc ou la première tentative stage_site_doc. La référence est disponible avec une autorisation OAuth pour nouveau site uniquement. Ne la sautez pas simplement parce que le texte de la compétence a été chargé ; certains clients MCP ne récupèrent pas les références automatiquement. Si l'outil de spécification est indisponible, lisez references/site-doc.md et references/minimal-site.json à la place. Ne devinez jamais les formes de données.

  1. Traduisez le plan de page, le contenu et les compositions du site de la Phase 1 en SiteDoc. Ne commencez pas avec l'exemple JSON et ne remplacez pas son texte ou sa palette. Le guide et les exemples décrivent uniquement les propriétés et relations valides. Pour les fonctionnalités avancées, consultez les définitions de type actuelles de Tsumu (lib/types.ts, lib/presets.ts, lib/site-import-format.ts et skills/tsumu/references/site-doc.md) lorsqu'elles sont accessibles.
  2. Construisez un objet SiteDoc complet (pas une chaîne JSON, une page HTML ou un fichier compressé). Champs obligatoires : schemaVersion: 1, siteName non vide, pages, pageOrder, nodes, assets. La page d'accueil a slug: "". Les children de page et de nœud font référence aux ID des nœuds ; les nœuds sont des box, image, etc. modifiables. Le texte et les titres utilisent box.text, pas un nœud heading inventé.
  3. Créez des mises en page de page natives pertinentes correspondant à la structure conçue. Donnez aux nœuds des étiquettes sémantiques, des styles et des surcharges responsives appropriés. Préservez la hiérarchie réelle, l'espacement, le contraste typographique, les accents visuels et la variation de section de la Phase 1. Vérifiez les cibles de navigation, le texte alternatif, le contraste et le comportement mobile. Évitez les ressources cassées, les liens vides, le contenu d'espace réservé et les éléments hors écran.
  4. Si la conception inclut des animations, scripts, composants ou comportements de formulaire, consultez les définitions de type actuelles exactes et implémentez uniquement les structures prises en charge. Les cibles des éléments de script utilisent l'attrId HTML du nœud cible, pas son ID de nœud SiteDoc ; @self est uniquement pour un script attaché à un élément. Vérifiez chaque étape et condition imbriquée. N'inventez pas de propriétés de mouvement ou de script et ne décrivez pas un bouton inerte comme fonctionnel.
  5. stage_site_doc n'accepte que le SiteDoc complet en tant que doc (jusqu'à 12 Mio de JSON sérialisé). Il n'accepte pas le prototype HTML de la Phase 1, les ZIP ou les ressources binaires séparées. Utilisez assets: {} lorsque c'est possible, des images externes vérifiées lorsque c'est approprié, ou de petites ressources dataUrl intégrées dans la limite. N'inventez pas de chemins de stockage Tsumu.
  6. Passez en revue le SiteDoc résultant par rapport à la conception originale, et non par rapport à l'esthétique de l'exemple. Assurez-vous qu'il reste entièrement modifiable et structurellement valide ; si la conversion perd une mise en page ou un contenu distinctif, améliorez la hiérarchie des éléments natifs avant la mise en scène.

Vérifier et livrer

  • Avant la mise en scène, comparez les pages finales à la conception de la Phase 1 et confirmez qu'il s'agit d'un site web fidèle et composé de manière indépendante, et non d'un exemple minimal habillé. Gardez la conception intermédiaire privée à moins que l'utilisateur ne la demande ; livrez le SiteDoc ou le lien d'importation comme résultat final.
  • Avant la mise en scène, assurez-vous que chaque déclaration de conception visible est placée dans nodes[id].styles.base.default ou la surcharge responsive pertinente, et non dans un champ style, css ou className inventé. Les valeurs réelles des déclarations CSS doivent être des chaînes de caractères. Vérifiez les ID, les références, les arbres acycliques et les règles d'importation. Vérifiez la hiérarchie des pages, la réactivité et les interactions demandées dans la mesure où les outils le permettent. Ne dites pas que vous l'avez prévisualisé à moins que vous ne l'ayez réellement fait.
  • Appelez stage_site_doc({ doc: <complet SiteDoc> }) ; utilisez editorOrigin uniquement lorsque l'utilisateur demande une installation Tsumu auto-hébergée spécifique.
  • Une remise réussie d'un nouveau site inclut l'importUrl exacte de l'outil sous forme de lien cliquable pour le demandeur, ainsi qu'une brève explication selon laquelle l'ouverture de ce lien importe un nouveau site modifiable. Le lien n'est pas une URL de site publié.
  • En cas d'échec, énoncez l'erreur réelle et évitez d'affirmer que le site a été enregistré. Ne remplacez pas une action d'outil échouée par un lien inventé et ne passez pas silencieusement à un site existant.
  • Le lien contient un jeton d'accès privé dans son fragment d'URL, expire après une heure et est consommé après que Tsumu confirme une importation réussie. Ne le divulguez pas à d'autres personnes. Les importations échouées peuvent être réessayées après l'expiration du bail de réclamation temporaire de cinq minutes.

Exemple de remise (illustratif uniquement) : "Le site modifiable du café est mis en scène pour l'importation. Le lien d'importation Tsumu privé est disponible pendant l'heure suivante." La remise réelle inclut le vrai lien généré par l'outil lorsque la mise en scène réussit.

Skills associés