Que fait Sitesmith — Constructeur de site web conversationnel ?
Transformez quelques tours de conversation en un site web complet, éventuellement bilingue, et publiez-le. Vous produisez des données, pas du code : un seul fichier site.json qu'un modèle fixe et bien conçu génère. Cela garantit un rendu stable et réutilisable.
Quand l'utiliser
Lorsque l'utilisateur souhaite créer ou mettre à jour un site web, une page d'accueil, un site personnel ou professionnel, ou un portfolio — par exemple « crée-moi un site », « 我想做个网站 », « mets à jour ma page d'accueil », « fais une landing page pour ma boulangerie ».
Références rapides
Fichiers de référence — chargez avec skill_view("sitesmith", "<chemin>") uniquement en cas de besoin :
references/site.schema.json— le contrat que toutsite.jsonDOIT respecterreferences/sections.md— les 14 types de sections (dontposts) : quand les utiliser, champs, limites de textereferences/theme.md— les options de thème (modèle, couleurs, polices, rayon, densité)references/assets.md— la stratégie d'images (placeholder / unsplash ; jamais d'actifs inventés)references/examples/innoe.site.json— un exemple complet de page unique (few-shot)references/examples/multipage.site.json— un exemple multi-pages + blog (few-shot)
Scripts — exécutez via l'outil terminal :
| Action | Commande |
|---|---|
| Valider | node ${HERMES_SKILL_DIR}/scripts/validate.mjs <site.json> |
| Générer | node ${HERMES_SKILL_DIR}/scripts/render.mjs <site.json> <dossier-sortie> |
| Déployer | bash ${HERMES_SKILL_DIR}/scripts/deploy.sh <dossier-sortie> <domaine> |
Procédure
-
Collecte (3 à 5 tours, questions groupées — n'interrogez pas de façon dispersée).
- Nom de l'entreprise + une ligne sur ce qu'elle fait ; secteur d'activité + clients cibles.
- Objectif principal (appels / réservations / inscriptions / vente / mise en avant).
- Langues — par défaut, la langue de la conversation ; proposez le bilinguisme (ex. en + zh).
- Périmètre : une page ou plusieurs pages ? Par défaut, une seule page. S'ils veulent plus (ou mentionnent un blog), proposez l'ensemble standard (Accueil / À propos / Services / Blog / Contact) et laissez-les réduire — confirmez la liste des pages avant de construire.
- Top 3 à 5 services/produits ; ce qui les rend uniques ; des chiffres réels éventuels ; coordonnées + appel à l'action principal.
- Ambiance en un ou deux mots (→
theme) ; actifs (logo ? couleur de marque ? vraies photos ?). - Si l'utilisateur est laconique ou dit « fais joli », procédez avec des valeurs par défaut raisonnables (une page unique est la valeur par défaut sécuritaire).
-
Rédigez
site.jsonconforme àreferences/site.schema.json. Étudiez d'abord l'exemple correspondant (innoe.site.jsonpour une page unique,multipage.site.jsonpour plusieurs pages). Choisissez 5 à 8 sections par page qui correspondent au contenu réel (voirreferences/sections.mdpour la cartographie objectif → colonne vertébrale de sections).- Page unique : tout va dans les
sectionsde premier niveau. - Multi-pages : l'accueil reste dans les
sectionsde premier niveau ; ajoutezpages[](une entrée par sous-page, chacune avec ses propressections). La navigation se dérive automatiquement des pages. Un blog est une page avec une sectionposts(légère : cartes de titres, pas d'articles complets). Choisissez l'apparence (voirreferences/theme.md) : soit sélectionnez un modèle stylé (newchinese/cyber/portfolio) lorsque la marque a une esthétique forte et évidente, soit — par défaut — utiliseztemplate:"pro"et concevez vous-même une palette personnalisée (primary/accent/neutral/font/radius/density) à partir de l'ambiance de l'entreprise, afin que chaque site soit unique. Gérez chaque image selonreferences/assets.md.
- Page unique : tout va dans les
-
Validez. Exécutez
validate.mjs. En cas d'échec, lisez les erreurs, corrigez le JSON, relancez. Ne procédez jamais avec un fichier invalide. -
Générez. Exécutez
render.mjs <site.json> <dossier-sortie>→ un site statique dans<dossier-sortie>/dist. SiUNSPLASH_ACCESS_KEYest défini, le rendu remplace automatiquement les placeholdersunsplashpar de vraies photos (créditées) ; sans cela, des placeholders thématiques sont générés — les deux sont acceptables pour la livraison. -
Prévisualisez et itérez. Résumez en langage simple ce que vous avez construit (« un site bilingue de 5 pages : Accueil, À propos, Services, Journal, Contact » — ou « une page unique de 6 sections »). Précisez à l'utilisateur que le site reste entièrement modifiable — il peut vous demander à tout moment d'ajouter/supprimer des pages ou des sections, de réécrire du texte, de changer les couleurs ou d'ajouter des articles de blog. Appliquez les modifications en réémettant le
site.jsoncomplet, puis revalidez + regénérez. -
Déployez (uniquement après l'approbation de la prévisualisation par l'utilisateur). Exécutez
deploy.sh <dossier-sortie> <domaine>→ en ligne sur Nginx avec HTTPS. Signalez l'URL en ligne.
Pièges à éviter
- La sortie est des données, pas du code. Produisez uniquement
site.json. N'écrivez jamais de HTML/CSS à la main. - Le schéma fait loi. Les noms de champs et les valeurs d'énumération doivent correspondre exactement ; omettez les champs inconnus.
- Pas d'actifs inventés. Utilisez Media
type:"placeholder"(décoratif) ou"unsplash"avec unequery(photo de contenu) ; utilisez"image"uniquement avec une URL réelle fournie par l'utilisateur. Le logo par défaut esttype:"text"sauf si un fichier logo réel existe. - Privilégiez les icônes aux images pour les fonctionnalités/services — les noms Lucide s'affichent toujours et se recolorisent correctement.
- Chaque
LocalizedTextcontient toutes les langues du site. Traduisez de manière idiomatique ; ne laissez jamais un champ vide. - Ne surconstruisez pas. 5 à 8 sections. Alternez les arrière-plans des sections ; jamais deux
darkou deuxprimaryà la suite. Commencez toujours parhero, terminez parctaoucontact. - Pas d'affirmations risquées sur la conformité — pas de certifications, recommandations, subventions/aides gouvernementales, récompenses ou statistiques inventées que l'utilisateur n'a pas mentionnées.
- La page unique est la valeur par défaut. N'ajoutez
pages[]que lorsque l'utilisateur souhaite un site plus riche / multi-pages ou un blog — et confirmez d'abord la liste des pages avec lui. Le blog (posts) est une liste de titres, pas des articles complets ; dites-le, et précisez que les articles peuvent être ajoutés ultérieurement.
Vérification
validate.mjsse termine avec le code0(il affiche l'ordre résolu des sections).render.mjsproduit<dossier-sortie>/dist/index.html.- Après déploiement,
curl -I https://<domaine>renvoie200.