Créer un site personnel
Objectif
Coordonner la suite de compétences pour site personnel en un workflow fiable.
Ceci est une compétence d'orchestration, pas une compétence d'implémentation. Elle doit orienter vers les compétences spécialisées appropriées, appliquer des portes de qualité et faire avancer le workflow jusqu'à ce que la demande atteigne son point d'arrêt naturel.
Ne dupliquez pas les règles d'implémentation détaillées des sous-compétences. Chargez et suivez les sous-compétences lorsque leur étape est atteinte.
Pour les demandes utilisateur de type "de l'idée au site personnel" ou de lancement en un clic, privilégiez from-idea-to-personal-site. Utilisez cette compétence comme coordinateur de routage de bas niveau lorsque la prochaine étape ou le choix de la sous-compétence est le problème principal.
Contrat
Entrées :
- Demande utilisateur, dossier du site ou dossier de sortie souhaité, références, identité, contenu, et cible de publication optionnelle.
- État actuel du workflow lorsque l'utilisateur demande la prochaine action.
Sorties :
- Itinéraire de workflow choisi et sous-compétences exécutées.
- Un site statique local, un site existant validé, un contenu importé, une modification ciblée ou une préparation à la publication selon la demande.
- Résumé de transfert avec le dossier du site, le statut de prévisualisation/publication, la validation effectuée et les étapes manuelles restantes.
Limites :
- N'implémentez pas les détails des sous-compétences directement lorsqu'une sous-compétence spécialisée s'applique.
- N'exécutez pas toutes les sous-compétences par défaut ; choisissez la chaîne la plus courte qui satisfait la demande.
- Ne publiez pas, ne poussez pas, ne créez pas de projets, n'attachez pas de domaines et ne modifiez pas le DNS sauf demande explicite.
- Ne sautez pas
review-static-siteaprès la génération, la recréation, la personnalisation, l'importation d'articles ou les modifications importantes.
Porte de succès :
- La chaîne de sous-compétences choisie atteint le point d'arrêt naturel de l'utilisateur : direction sélectionnée, site construit, contenu ajouté, site validé, modification terminée ou déploiement préparé/effectué.
- Les portes de qualité requises sont franchies ou l'utilisateur accepte explicitement les limitations documentées.
En cas d'échec :
- Acheminez la porte défaillante vers la plus petite sous-compétence responsable.
- Réexécutez la validation affectée.
- Arrêtez-vous et signalez le blocage uniquement lorsqu'un contenu utilisateur manquant, des identifiants manquants, des actifs indisponibles ou des actions externes sur un compte empêchent la progression.
Sous-compétences
Utilisez ces compétences comme éléments de base du workflow :
search-blog-theme: découvrir et comparer des directions de thèmes pour site personnel/blog.find-style-references: rechercher et inspecter des sites web/réels/modèles/captures d'écran pour une direction choisie et produire un brief de référence prêt à construire.make-personal-site: créer un site statique personnel original sans dépendances.copy-website-style: recréer le style, la mise en page, le mouvement et les types de pages d'un site web de référence spécifique.personalize-site: remplacer l'identité du site d'exemple/de démonstration/source par le contenu propre de l'utilisateur.add-blog-posts: importer des notes Markdown, Obsidian, des brouillons Word, d'anciens articles HTML, des images, des maths, des liens et d'autres écrits dans un site existant.edit-site-part: effectuer des modifications locales ciblées sur une section, un composant, un bloc de copie, un détail de style ou une interaction spécifique.review-static-site: valider la sortie statique pour les liens, les types de pages, le rendu navigateur, l'encodage, les résidus d'exemples, la compatibilité d'ouverture directe et la correction des chemins.publish-static-site: préparer ou effectuer le déploiement vers GitHub Pages, Cloudflare Pages, Netlify ou Vercel.
Si le nom d'une sous-compétence change, privilégiez la compétence installée localement ayant le même objectif.
Matrice de contrat des sous-compétences
Utilisez cette matrice pour décider des transferts et des boucles de réparation :
| Sous-compétence | Entrée requise | Sortie attendue | Porte de succès | En cas d'échec |
|---|---|---|---|---|
search-blog-theme | Goût de l'utilisateur, objectif, références ou mots-clés | 3 à 5 directions, URL de référence vérifiées, une recommandation | La direction est suffisamment spécifique pour construire | Recherchez plus de références, affinez la métaphore, ou posez une question de préférence |
find-style-references | Direction de style choisie, type de site, mots d'ambiance ou exemples | 4 à 8 références réelles, observations navigateur, brief de conception prêt à construire | Plusieurs angles de recherche et au moins 3 références solides inspectées si possible | Élargissez la recherche, inspectez des références plus solides, ou revenez à search-blog-theme |
make-personal-site | Direction, indices de contenu/profil, périmètre des pages, dossier de sortie | Site statique simple avec pages représentatives, actifs, EDITING.md | Types de pages requis, chemins relatifs, source UTF-8, prévisualisation locale | Corrigez la structure/les chemins/les actifs, puis review-static-site |
copy-website-style | URL/capture d'écran/modèle cible et périmètre | Recréation statique du style avec plan de page, espaces réservés/contenu utilisateur, EDITING.md | La mise en page/le mouvement/les types de pages signature correspondent à la fidélité demandée | Réinspectez la cible, itérez la recréation, puis review-static-site |
personalize-site | Site existant plus identité/contenu utilisateur | Identité, liens, métadonnées, actifs remplacés, nettoyage des espaces réservés/source | Le contenu utilisateur est visible et les résidus supprimés | Réinventoriez les emplacements de contenu ou utilisez edit-site-part pour l'ajustement de mise en page |
add-blog-posts | Site existant plus articles/actifs source | Nouvelles pages d'articles, index/données mis à jour, actifs copiés, notes d'édition | Les articles s'affichent, les liens/actifs/maths/contenu riche fonctionnent | Corrigez la conversion/l'index/les actifs ou utilisez edit-site-part pour les problèmes de présentation locale |
edit-site-part | Site existant plus page/région/changement cible | Petite modification ciblée de code/contenu/style/interaction | La même région du navigateur montre le changement demandé sans casse non liée | Remappez la source et effectuez une correction plus petite |
review-static-site | Racine statique, périmètre attendu, chaînes/références interdites optionnelles | Constats ou corrections, résultat d'audit/navigateur, état de succès/échec | Aucun blocage persistant | Acheminez le blocage vers la plus petite sous-compétence responsable |
publish-static-site | Racine de déploiement validée plus plateforme/mode choisi | Paramètres/configurations de déploiement, URL live optionnelle, vérification post-déploiement | Le dossier correct est déployé et l'URL live fonctionne | Corrigez les blocages locaux, les paramètres de déploiement ou les étapes de compte/DNS |
Principes de fonctionnement
- Acheminez d'abord, exécutez ensuite. Décidez de la chaîne correcte avant d'effectuer des modifications importantes.
- Gardez la sortie de chaque étape utilisable par l'étape suivante.
- Préférez le HTML/CSS/JS simple et aucune dépendance pour cette version, sauf si l'utilisateur demande explicitement une autre pile.
- Ne transformez pas un site personnel ou un blog en page d'atterrissage marketing.
- N'inventez pas de détails personnels détaillés lorsque les données utilisateur sont manquantes.
- Remplacez par défaut l'identité de la source copiée dans les recréations de style.
- Utilisez des liens et actifs relatifs à la page par défaut ; évitez les chemins absolus à la racine du site comme
/assets/...ou/posts/.... - Validez avec
review-static-siteaprès toute génération, recréation, personnalisation, importation d'articles ou modification importante. - Arrêtez-vous à un site local validé, sauf si l'utilisateur demande explicitement de publier.
- Ne créez pas de dépôts, ne poussez pas de code, ne déployez pas, n'attachez pas de domaines et ne modifiez pas le DNS sauf demande explicite.
Accueil
Collectez uniquement les informations nécessaires à la prochaine décision. Ne surmenez pas l'utilisateur avec des questions.
Entrées utiles :
- Dossier de sortie souhaité ou dossier du site existant.
- Si l'utilisateur souhaite un nouveau site, une recréation d'une référence, une importation de contenu, une personnalisation, une modification locale, une validation ou une publication.
- URL de référence, captures d'écran, modèles ou mots de thème.
- Matériaux d'identité utilisateur : nom, bio, liens, CV, projets, avatar/logo, ancienne page d'accueil, profil GitHub.
- Matériaux de contenu : Markdown, notes Obsidian, documents Word, anciens articles, dossiers d'images ou texte collé.
- Cible de publication : GitHub Pages, Cloudflare Pages, Netlify, Vercel, ou uniquement des conseils.
Si la demande est suffisamment claire, procédez. Ne posez une question concise que lorsque plusieurs itinéraires produiraient un travail très différent.
Routeur
Choisissez le workflow en fonction de l'état actuel de l'utilisateur :
- Idée vague ou "trouve-moi un style" : utilisez
search-blog-theme, puisfind-style-referencesavant une construction originale. - Direction choisie et aucun site cible spécifique : utilisez
find-style-references, puismake-personal-site. - URL/capture d'écran/modèle cible spécifique à reproduire fidèlement : utilisez
copy-website-style. - Site généré existant qui contient encore des espaces réservés ou une identité copiée : utilisez
personalize-site. - Site existant plus de nouveaux articles/notes/documents : utilisez
add-blog-posts. - Site existant plus un petit changement visuel/de copie/de mise en page/d'interaction : utilisez
edit-site-part. - "Vérifie ce site", "est-ce assez bien", "avant publication" : utilisez
review-static-site. - "Déploie", "publie", "GitHub Pages", "Cloudflare Pages", "Netlify", "Vercel" : utilisez
publish-static-site, aprèsreview-static-site.
Lorsque l'utilisateur demande une construction complète en un clic, choisissez la chaîne la plus courte qui traite les entrées réelles. N'exécutez pas toutes les sous-compétences simplement parce qu'elles existent.
Exemples d'itinéraires
Utilisez ces exemples pour stabiliser le routage :
| Modèle de demande utilisateur | Itinéraire |
|---|---|
| "Je veux un blog personnel distinctif, aide-moi à choisir un style" | search-blog-theme |
| "Trouve des références réelles pour ce style choisi avant de construire" | find-style-references |
| "Fais-moi un site personnel dans cette direction choisie" | find-style-references -> make-personal-site -> review-static-site |
| "Construis un blog personnel complet de zéro" | search-blog-theme si nécessaire -> find-style-references -> make-personal-site -> personalize-site si du contenu existe -> review-static-site |
| "Utilise cette URL comme référence et recrée-la" | copy-website-style -> personalize-site -> review-static-site |
| "Copie ce site web mais remplace le contenu de la personne par le mien" | copy-website-style -> personalize-site -> review-static-site |
| "Voici mon site généré, remplace les espaces réservés par ma bio/mes projets/mes liens" | personalize-site -> review-static-site |
| "Ajoute cet article Markdown/Obsidian/Word au site" | add-blog-posts -> review-static-site |
| "Change cette section/cette couleur/ce titre/cette carte/ce menu" | edit-site-part ; ajoutez review-static-site uniquement si la structure partagée ou les actifs ont changé |
| "Vérifie si ce site est prêt" | review-static-site |
| "Déploie ceci sur Cloudflare Pages/GitHub Pages/Netlify/Vercel" | review-static-site -> publish-static-site |
| "Ça fonctionne localement via HTTP mais pas en double-cliquant sur index.html" | review-static-site ; corrigez les échecs de porte de chemin avant de publier |
Pipelines standards
De l'idée au site original
À utiliser lorsque l'utilisateur a seulement un objectif vague ou une préférence de style.
search-blog-themesi la direction visuelle n'est pas claire.find-style-referencespour ancrer la direction choisie dans des sites web/modèles/captures d'écran réels.make-personal-sitepour créer le site statique.personalize-sitesi l'utilisateur a fourni une identité/du contenu ou si le site comporte des espaces réservés à remplir.review-static-sitecomme porte d'assurance qualité stricte.- Arrêtez-vous avec des instructions de prévisualisation locale, sauf si la publication a été demandée.
De la référence au site personnel
À utiliser lorsque l'utilisateur fournit une URL cible, une capture d'écran, un modèle v0, un design Figma ou un site web existant à reproduire.
copy-website-stylepour recréer la mise en page, le mouvement, les types de pages et les interactions.personalize-sitepour remplacer l'identité cible et le contenu d'espace réservé.add-blog-postssi l'utilisateur a fourni du contenu écrit.review-static-sitecomme porte d'assurance qualité stricte.- Arrêtez-vous avec des instructions de prévisualisation locale, sauf si la publication a été demandée.
Blog axé sur le contenu en premier
À utiliser lorsque la contribution la plus forte de l'utilisateur est constituée d'articles, de notes, de fichiers Markdown, Word ou d'archives d'anciens écrits.
- Utilisez
search-blog-themeuniquement si aucun site/thème n'existe. - Utilisez
find-style-referencessi un nouveau système visuel original est nécessaire. - Utilisez
make-personal-sitesi aucun site statique n'existe encore. - Utilisez
add-blog-postspour importer le contenu dans le système d'articles du site existant. - Utilisez
personalize-sitesi le contenu d'identité/profil reste générique. - Utilisez
review-static-sitecomme porte d'assurance qualité stricte. - Arrêtez-vous avec des instructions de prévisualisation locale, sauf si la publication a été demandée.
Amélioration d'un site existant
À utiliser lorsque l'utilisateur possède déjà un dossier de site généré.
- Inspectez le site et
EDITING.mds'il est présent. - Utilisez
personalize-sitepour le remplacement d'identité/contenu. - Utilisez
add-blog-postspour les importations d'articles. - Utilisez
edit-site-partpour les modifications ciblées de conception ou de copie. - Utilisez
review-static-sitelorsque la modification affecte la navigation, les types de pages, les actifs, l'encodage, la préparation à la publication ou plus d'une page.
Site prêt à publier
À utiliser lorsque l'utilisateur demande à publier ou déployer.
- Utilisez
review-static-sited'abord. - Corrigez les blocages ou acheminez vers la sous-compétence pertinente si la révision trouve des problèmes.
- Utilisez
publish-static-siteuniquement après que le site a passé les vérifications locales nécessaires ou que l'utilisateur accepte les risques connus. - Vérifiez l'URL live lorsque le déploiement a lieu.
Portes de qualité
Le workflow n'est pas terminé tant que les portes pertinentes ne sont pas franchies ou que l'utilisateur n'accepte pas une limitation explicite.
Porte de thème :
- La direction visuelle ou la référence est suffisamment spécifique pour construire.
- Si la construction est originale et basée sur des mots de goût, des références de style réelles ont été recherchées sous plusieurs angles et au moins 3 références solides ont été inspectées si possible, ou l'utilisateur a explicitement renoncé à cette étape.
- L'approche choisie correspond au type de site de l'utilisateur : blog, portfolio, page d'accueil de recherche, jardin numérique, notes, liens ou hybride.
Porte de structure :
- Les types de pages requis existent, pas seulement la page d'accueil.
- Les sites de type blog incluent au moins une page d'article/détail et un point d'entrée de liste/archive.
- La navigation pointe vers des pages générées réelles.
Porte de contenu :
- L'identité/le contenu fourni par l'utilisateur apparaît aux endroits prévus.
- Le contenu d'espace réservé uniquement est clairement marqué ou remplacé.
- L'identité de la source copiée est supprimée des recréations de style, sauf si l'utilisateur en est propriétaire ou en a l'autorisation.
Porte de chemin :
- Les liens et actifs locaux au site sont relatifs à la page par défaut.
- Les pages imbriquées utilisent la profondeur
../correcte. - Le HTML, les
url(...)CSS, les liens générés par JavaScript, les fichiers de données, les images de couverture, les polices et les actifs de fournisseur évitent les chemins absolus à la racine accidentels. - L'ouverture directe de
index.htmlne doit pas perdre le CSS, le JS, les images ou la navigation.
Porte d'encodage :
- Les fichiers source sont en UTF-8.
- Les caractères spéciaux (accents, symboles, guillemets courbes, émojis, mathématiques) s'affichent correctement.
- Les pages déclarent
<meta charset="UTF-8">.
Porte de rendu :
- Les pages s'affichent de manière cohérente dans Firefox, Chrome et Safari, y compris la navigation, les listes/archives, les articles individuels, les pages de projet, la page À propos et les pages d'erreur 404.
- Les dispositions réactives se dégradent correctement sur les écrans étroits sans débordement horizontal, texte illisible ou navigation cassée.
- Les images se chargent, la typographie est lisible et les interactions (hover des liens, accordéons, basculements de composants) fonctionnent.
Porte de publication :
- Le site est déjà validé ou l'utilisateur accepte le risque de publier sans validation.
- La plateforme de déploiement a été choisie.
- Les identifiants, domaines ou configurations de dépôt sont en place lorsque le déploiement réel est demandé.
Échecs et traitement
Si une sous-compétence signale un échec ou un blocage :
- Inspectez la sortie pour confirmer que l'échec est réel.
- Acheminez vers la sous-compétence la plus petite capable de réparer la porte défaillante.
- Réexécutez la validation.
- Signalez à l'utilisateur uniquement les blocages qui nécessitent des entrées, des identifiants, des actifs ou des actions de sa part.
- Ne passez pas à l'étape suivante tant que la porte n'est pas franchie ou que l'utilisateur n'accepte pas le blocage.
Conseils d'orchestration
- Par défaut, construisez dans le répertoire de travail actuel, sauf si l'utilisateur spécifie un dossier de sortie.
- Présumez que les sous-compétences sont disponibles localement. Si une sous-compétence est manquante, utilisez la commande d'outil du système hôte pour installer ou générer des compétences, ou signalez à l'utilisateur les compétences manquantes.
- Si une sous-compétence produit un dossier de site, transmettez ce dossier à la sous-compétence suivante comme entrée de dossier cible.
- Lorsqu'une sous-compétence crée ou met à jour
EDITING.md, transmettez les notes d'édition aux prochaines sous-compétences qui en ont besoin. - Suivez
EDITING.mdd'un site existant pour décider quelles parties peuvent être modifiées en toute sécurité et quelles règles de construction s'appliquent. - Si l'entrée de l'utilisateur manque de détails pour une sous-compétence, posez une question concise qui débloque la prochaine étape. Évitez les listes de vérification.
Limites connues
- Cette compétence ne peut pas attacher de domaines personnalisés, modifier les enregistrements DNS ou configurer les paramètres du panneau de contrôle de la plateforme de déploiement. Ces étapes nécessitent une action manuelle de l'utilisateur.
- Cette compétence ne peut pas créer ou configurer des dépôts GitHub. Si une sous-compétence nécessite un dépôt, guidez l'utilisateur à travers la création et les autorisations.
- Les bibliothèques CSS ou JavaScript tierces, les cadres, les processeurs ou les générateurs de site sont hors de propos pour cette version. Utilisez du HTML/CSS/JS simple.
- L'importation d'articles nécessite des fichiers bruts lisibles ou du texte collé. Les formats propriétaires verrouillés (.pages, .pub, .psd verrouillé) peuvent ne pas être importables.