Communitygithub.com

Personal Site Builder — du CV au site perso

Transforme un CV, des profils sociaux, un portfolio et des productions éparses en site personnel statique déployable : entretien et vérification des preuves, hiérarchie selon objectif × profondeur, 6 styles visuels (ou extraits d'un site de référence), génération, recette navigateur, déploiement uniquement avec accord.

Qu'est-ce que Personal Site Builder — du CV au site perso ?

Personal Website, étape 1 (composition) : spacezephyr-personal-site-builder. Contenu → structure → visuel → code, sans faits inventés et avec confidentialité par défaut ; sortie HTML/CSS/JS pur pour Cloudflare Pages, Vercel ou GitHub Pages. Ensuite : page À propos puis hub link-in-bio.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add SpaceZephyr/personal-site-builder

Demander à votre IA préférée

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

Documentation

Générateur de Site Personnel

Transformez « un CV + une liste de liens + des productions éparpillées » en un site statique structuré, visuellement cohérent et directement déployable.

Livrable : un ensemble de fichiers HTML/CSS/JS purement statiques (sans build, sans framework, CSS en un seul fichier), prêt à être déployé sur Cloudflare Pages / Vercel / GitHub Pages.

Principes Fondamentaux

  • L'ordre est impératif : d'abord le contenu → ensuite la structure → puis le visuel → enfin le code. Ne commencez pas par un template ou par demander des couleurs et des polices.
  • Distinguer quatre types d'informations : faits confirmés par l'utilisateur / résumé textuel de la source / texte rédigé par l'IA / inférences à confirmer. Ne pas inventer d'expériences, de chiffres, de clients, d'avis, d'identités ou de relations professionnelles.
  • Protéger la vie privée par défaut : obtenir une confirmation explicite avant de divulguer publiquement un numéro de téléphone, une adresse, un email personnel ou des documents clients.
  • Ne pas créer de sections vides pour remplir un modèle : si les informations sont insuffisantes, réduire la profondeur du contenu ou lister les éléments manquants. Ne pas utiliser de cas fictifs pour faire nombre.
  • Proposer des options avec recommandation : pour chaque point de décision, donner 2 à 3 options substantiellement différentes ainsi qu'une recommandation claire. Ne pas rejeter tout le choix sur l'utilisateur.
  • Le déploiement est une action de publication : ne l'exécuter qu'avec l'autorisation explicite de l'utilisateur.

Flux de Travail

① Définir le périmètre → ② Collecter les informations → ③ Définir la hiérarchie de l'information → ④ Définir le style visuel → ⑤ Générer → ⑥ Valider → ⑦ Déployer après autorisation

① Définir le périmètre

Déterminez d'abord s'il s'agit d'une création ou d'une refonte d'un site existant.

  • S'il y a un projet existant : lisez la structure des répertoires, les pages actuelles, les sources de contenu, les commandes de build, la configuration de déploiement et l'état git. Réutilisez la pile technique et les contraintes de design existantes, ne repartez pas de zéro.
  • Nouvelle création : par défaut, site statique responsive et léger. N'introduisez un framework ou un backend que si un CMS, une connexion ou des données dynamiques sont réellement nécessaires.

Posez ensuite une seule question pour définir la direction :

« À qui ce site est-il principalement destiné ? Qu'attendez-vous de lui après l'avoir visité ? »

Ne posez pas de questions sur les couleurs, les polices ou les animations à cette étape.

② Collecter les informations

Lisez references/intake.md (contient la checklist minimale de démarrage, l'ordre progressif des questions, les champs des entités de contenu, la hiérarchie des preuves, les règles de confidentialité, la liste des sources consultables).

Points clés :

  • La première réponse doit être légère. L'utilisateur a déjà dit ce qu'il a ; la première réponse ne doit que lui demander de l'envoyer. Après avoir lu ce premier lot, posez la question suivante. Ne posez qu'une seule question à la fois, la plus impactante pour l'étape suivante ; ne lancez pas une liste de dix questions.
  • Lisez d'abord ce qui peut l'être, ne demandez pas. CV (Read / docx / pdf skill), GitHub, blog, articles WeChat (WebFetch), plateformes nécessitant une connexion (claude-in-chrome). En cas de mur de connexion, CAPTCHA ou anti-scraping, arrêtez immédiatement et demandez à l'utilisateur de fournir un fichier exporté, du texte, une liste de liens ou des captures d'écran.
  • Les chiffres priment sur les adjectifs, et uniquement avec des métriques vérifiables. « 10 produits, 50 000 utilisateurs, près de 200 compétences » vaut mieux que « une vaste expérience » ; n'ajoutez pas d'estimations non vérifiables.
  • Le contenu en double sur plusieurs plateformes est fusionné en une seule entité de contenu, en conservant plusieurs liens sources ; en cas de conflit d'informations, conservez les deux versions et demandez à l'utilisateur de confirmer.

Après la collecte, produisez une liste de confirmation des informations (déjà obtenues / à confirmer / manquantes / suggestion de complément). Ne passez à l'étape suivante qu'après confirmation de l'utilisateur.

③ Définir la hiérarchie de l'information

Lisez references/architectures.md. Utilisez une décision sur deux axes :

Axe 1 : Objectif du site (choisissez un objectif principal, au maximum un secondaire)

Le profil de l'utilisateur concerne principalementObjectif principal
Expérience professionnelle, compétences, diplômes, pour postulerConversion vers l'emploi
Projets / design / photographie / vidéo, beaucoup de supports visuelsPortfolio
Une histoire de vie + centres d'intérêt + valeurs, peu de réalisations concrètesPage personnelle
Articles écrits sur le long terme / livres lus / parcours, archivageJournal de bord
Souhaite du consulting, des articles commandés, du mentorat, des commandes commercialesGénération de leads
Comptes WeChat / X / Xiaohongshu / Podcast, avec une communauté et des actifs de contenuPage de créateur
A lancé des produits, des projets open source, veut que les gens les utilisent/achètentDéveloppeur indépendant

Axe 2 : Profondeur du contenu (déterminée par la quantité d'informations, non par le souhait)

  • N1 Carte de visite — Page unique, seulement identité / positionnement / action principale / 3 liens représentatifs. Peu d'informations ou besoin de rapidité.
  • N2 Preuve — Page d'accueil + pages de détails des projets/expériences. Nécessite des contributions personnelles, des processus, des résultats, des supports médiatiques.
  • N3 Système de contenu — Page d'accueil + détails + index par catégorie + archives + mécanisme de mise à jour continue. Nécessite une source de contenu stable et une volonté de mise à jour.

Si les informations ne suffisent pas pour N2, passez d'abord par N1 ; sans capacité de mise à jour continue, ne choisissez pas N3.

Utilisez le modèle de architectures.md pour produire 2 à 3 options réellement différentes (la différence doit provenir de la tâche du visiteur, pas seulement d'un changement de nom de section). Pour chaque option, indiquez : à qui elle s'adresse / promesse de la première page / action principale / navigation / ordre de la page d'accueil / quels éléments existants sont utilisés / ce qui doit être complété / principaux compromis. Recommandez clairement une option. Ne passez au visuel qu'après confirmation de l'utilisateur.

④ Définir le style visuel

Commencez par demander : « Avez-vous un site ou un design que vous aimez ? Si oui, envoyez-moi le lien ou une capture d'écran. » Un référence est bien plus précise que de faire choisir l'utilisateur parmi des adjectifs.

Trois chemins possibles, selon ce que l'utilisateur a :

  1. L'utilisateur a fourni une URL de référence / une capture d'écran / un guide de style → Lisez references/style-extraction.md. Ouvrez de préférence le site de référence avec claude-in-chrome, exécutez le script qui s'y trouve pour échantillonner les styles calculés réels (famille de polices, valeurs de couleurs, coins arrondis, ombres, largeur du conteneur), une fois en mode clair et une fois en mode sombre. Si impossible à ouvrir ou nécessite une connexion, passez à l'analyse par capture d'écran. Extrayez l'esprit, ne clonez pas l'intégralité du site, ne prenez pas son logo, son texte, ses illustrations ou sa mise en page originale.
  2. L'utilisateur a cité un nom de marque (« Faites-le comme Notion » ou « Style Apple ») → Appelez la compétence brand-design-md pour récupérer le DESIGN.md, et mappez-le aux variables :root de site.css.
  3. L'utilisateur n'a pas de référence → Lisez references/visual-styles.md, proposez 2 à 3 directions parmi les 6 styles intégrés, avec une raison de recommandation. Chaque direction doit inclure des valeurs de variables CSS prêtes à être copiées.

Si l'utilisateur a fourni plusieurs sites de référence, demandez d'abord : « Lequel préférez-vous pour l'ambiance générale ? Qu'aimez-vous spécifiquement chez les autres ? » — La plupart des gens aiment la mise en page de A et la palette de couleurs de B ; si vous faites l'intersection directement, vous obtiendrez un hybride incohérent.

Lorsque l'utilisateur mentionne WordPress / Framer / Webflow / Notion, inspirez-vous de leur organisation de l'information et de leur esprit, mais ne faites pas semblant de générer un thème ou un projet correspondant à ces plateformes.

Quel que soit le chemin choisi, ne modifiez que les variables :root, ne réécrivez pas la partie composants de site.css. Une fois la décision prise, passez au code.

⑤ Générer le site

Commencez par copier assets/starter/ :

  • site.css — Variables CSS + base typographique + composants de cartes/listes, thèmes clair/sombre. Modifier le style = modifier les variables :root, ne réécrivez pas tout le fichier.
  • nav.js — Barre supérieure fixe injectée en un seul fichier (commutation de thème sombre + masquage au défilement). Modifiez SITE_NAME / LINKS / THEME_KEY dans la zone de configuration en haut. Le 760px dans son CSS en ligne doit correspondre à --max dans site.css.
  • index.html — Squelette de la page d'accueil, ajoutez/supprimez des sections selon le plan.

Doit satisfaire :

  • La première page doit afficher le nom de la personne ou son appellation courante + son positionnement + une action principale ; une seule action principale, au maximum une action secondaire.
  • La navigation reflète l'architecture de l'information confirmée, ne copiez pas les sections des modèles de plateforme ; 4 à 6 éléments.
  • Pour les projets, mettez l'accent sur le problème / mon rôle / l'approche / le résultat, ne vous contentez pas de vignettes.
  • Les liens vers les réseaux sociaux doivent indiquer ce qu'on peut y voir, ne vous contentez pas d'une rangée d'icônes.
  • Chaque page sous xxx/index.html, partageant /site.css et /nav.js ; pas de CDN, de framework ou d'étape de build.
  • <title>, <meta name="description">, favicon, image de partage complets ; liens externes avec target="_blank" rel="noreferrer".
  • Navigation fluide sur desktop et mobile ; parcours principal réalisable au clavier ; structure sémantique et attributs alt complets ; prise en charge de prefers-reduced-motion.
  • Les images doivent être tirées de productions réelles / portraits / captures d'écran ; si des images manquent, demandez d'abord des éléments ; les images générées doivent être explicitement marquées comme générées.
  • N'utilisez pas de phrases comme « Ceci est mon site personnel » ou « Voici mes projets » comme éléments de design.

Typographie chinoise : hauteur de ligne ≥ 1,7, espacement entre paragraphes ≥ 18 px, la pile de polices doit inclure PingFang SC. Si des compétences de design frontend plus avancées sont nécessaires, faites appel à la compétence frontend-design.

⑥ Valider

Lisez references/delivery-checklist.md et passez en revue chaque point. Vérifiez au moins :

  • Page d'accueil, navigation, pages de détails, liens externes, action principale
  • Cinq largeurs : 360 / 390 / 768 / 1280 / 1440
  • Pas de débordement pour les noms et titres les plus longs ; comportement en cas de contenu vide, d'échec de chargement d'image, de lien externe mort
  • Pas d'erreur dans la console affectant l'utilisation ; pas de défilement horizontal inattendu ni de chevauchement de mise en page
  • Lisibilité dans les deux thèmes (clair et sombre) (contraste ≥ 4,5:1)
  • Pas de TODO résiduel, de chiffre fictif, de lien de test à l'intérieur du site
  • Les informations publiques correspondent à la liste confirmée par l'utilisateur

Utilisez python3 -m http.server pour un aperçu local, ou des captures d'écran avec claude-in-chrome, et laissez l'utilisateur confirmer avant publication.

⑦ Déployer après autorisation

Expliquez d'abord où le site sera publié, s'il sera public, quel dépôt/compte sera utilisé, quels domaines ou variables d'environnement seront modifiés, obtenez une autorisation explicite avant d'exécuter.

  • Pour un projet existant, réutilisez la méthode de déploiement actuelle ; pour un nouveau site statique, privilégiez Cloudflare Pages / Vercel / GitHub Pages (laissez la commande de build vide, définissez le répertoire de sortie comme la racine du site).
  • D'abord construire → ensuite publier → puis vérifier l'URL de production pour le contenu clé. Un aperçu réussi ne signifie pas que le nom de domaine personnalisé est effectif.
  • N'emballez pas les clés secrètes, les CV originaux ou les données exportées des plateformes dans le site.

Livraison Finale

Résumez de manière concise : l'objectif choisi et la profondeur du contenu / les pages et le contenu clé réalisés / l'URL d'accès / les résultats de la validation / le contenu non encore public ou à compléter. Ne masquez pas le code, la validation ou le déploiement non terminés par de longues descriptions.

Liste des Interdits

  • ❌ Page d'accueil surchargée de tout le contenu — la première page doit dire en 3 secondes « Qui êtes-vous + Que faites-vous + Comment vous joindre », tout le reste est secondaire
  • ❌ Phrases vides comme « Passionné par la technologie, en quête d'excellence » — remplacez par des faits et des chiffres vérifiables
  • ❌ Inventer des expériences, des projets, des chiffres, des avis clients que l'utilisateur n'a pas fournis
  • ❌ Poser une douzaine de questions à la fois ; ou sauter la confirmation des informations et du plan pour coder directement
  • ❌ Forcer le niveau N1 avec des informations insuffisantes en utilisant un blog vide et des cas fictifs pour faire nombre
  • ❌ Animations complexes, dégradés accumulés, une police différente pour chaque section — la crédibilité d'un site personnel vient de la retenue
  • ❌ Copier intégralement le site de référence en changeant le nom — on extrait l'esprit de la palette de couleurs/typographie/espacement, pas le logo, le texte, les illustrations ou la mise en page originale
  • ❌ Pusher / déployer / divulguer des coordonnées sans autorisation

Skills associés