Communitygithub.com

tangshengming/site_personnel

Générer un premier site web personnel à partir d'un CV ou d'une source de profil en extrayant le contenu structuré, en rédigeant des fichiers Markdown révisables, en confirmant les décisions de confidentialité/audience/design, en élaborant la structure du site, en échafaudant un site Astro et en le vérifiant localement. Utilisez-le lorsque l'utilisateur demande de générer un site web, de construire un site personnel à partir d'un CV, de convertir un CV PDF/LaTeX en portfolio, ou de reproduire le flux de travail CV-vers-site.

Qu'est-ce que site_personnel ?

Cette compétence permet de reproduire un flux de travail structuré et réfléchi pour transformer un CV (PDF, LaTeX, DOCX ou texte) en un site web personnel moderne, basé sur Astro. L'approche est incrémentale et centrée sur la révision humaine : avant de générer les pages, elle extrait d'abord le contenu du CV dans un fichier Markown révisable, puis demande à l'utilisateur de confirmer les choix de confidentialité, d'audience et de design. Cela évite de publier par erreur des informations sensibles et garantit que le contenu final correspond aux attentes. La compétence guide ensuite la création d'une structure de site (pages, navigation), l'échafaudage du projet Astro avec séparation claire entre le contenu et la présentation, et enfin la vérification locale (build, dev, vérification des routes). Elle est particulièrement utile pour les développeurs, chercheurs ou professionnels qui souhaitent créer rapidement un portfolio ou un site académique à partir d'un CV existant, sans se perdre dans les détails de configuration. Le résultat est un site Astro fonctionnel, prêt à être déployé, avec des notes claires sur ce qui reste à faire.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangshengming/personal_website/tree/HEAD/.codex/skills/generate-website

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érer un site web

Aperçu

Utilisez cette compétence pour reproduire un flux de travail minutieux de transformation d'un CV en site web. Le principe clé est de créer un matériau source révisable avant de générer les pages : d'abord extraire le CV en Markdown, puis décider ce qui est public, puis construire le site à partir d'un contenu structuré.

Flux de travail

1. Inspecter l'espace de travail

Vérifiez les fichiers du projet actuel avant de modifier :

  • Trouvez les fichiers de statut du workflow comme WEBSITE_WORKFLOW.md, PROJECT_STATUS.md ou similaires.
  • Trouvez le fichier source du CV/profil : généralement .pdf, .tex, .docx, ou un CV texte/Markdown.
  • Vérifiez si un site web existe déjà : package.json, astro.config.*, src/, public/, dist/.
  • Vérifiez l'état de Git brièvement avec git status --short si utile.

Ne supposez pas un projet vierge.

2. Lire et inspecter le CV

Si la source est un PDF :

  • Utilisez la compétence PDF.
  • Extrayez le texte avec pdfplumber ou un autre outil fiable d'extraction de texte PDF.
  • Rendez les pages en images lorsque c'est possible et inspectez-les visuellement pour ne pas mal interpréter la mise en page et les limites des sections.
  • Attendez-vous à ce que l'extraction de texte PDF produise des artefacts d'espacement/icônes ; nettoyez-les manuellement dans la sortie structurée.

Si la source est LaTeX :

  • Lisez directement le code source .tex.
  • Traitez les commandes de section, les macros et les listes comme de la structure.
  • Ne nécessitez pas de compilation LaTeX locale sauf si l'utilisateur demande une régénération du PDF.

Si la source est .docx :

  • Utilisez la compétence documents pour extraire la structure et le contenu.

3. Extraire en Markdown révisable

Créez un fichier source Markdown avant de construire les pages du site. Privilégiez :

content/cv_extracted.md

Incluez des sections structurées telles que :

  • Identité
  • Contact public
  • Coordonnées/détails privés ou cachés
  • Profil
  • Langues
  • Expertise technique
  • Compétences professionnelles
  • Expérience professionnelle
  • Formation
  • Publications
  • Projets
  • Potentiel de présentation sur le site web pour chaque projet

Conservez ce fichier factuel. C'est le matériau source, pas un texte marketing final.

4. Demander ou confirmer les décisions public/privé

Avant de mettre des informations personnelles sur un site web public, confirmez :

  • Adresse e-mail publique
  • Afficher ou non le numéro de téléphone
  • Afficher ou non la date de naissance
  • Afficher ou non l'adresse complète
  • Afficher ou non les détails de résidence/permis/visa/permis de conduire
  • Quels liens sont publics ou cachés : GitHub, LinkedIn, Google Scholar, ORCID, ResearchGate, etc.
  • Audience préférée : industrie, académique, mixte, clients, recruteurs, collaborateurs
  • Préférence visuelle : minimaliste, académique, portfolio technique expressif, etc.

Posture de confidentialité par défaut :

  • Cachez la date de naissance, le numéro de téléphone, l'adresse complète, le permis de résidence, le permis de conduire et autres informations sensibles similaires, sauf si l'utilisateur souhaite explicitement les rendre publics.
  • Privilégiez l'e-mail public, la ville/pays et les liens professionnels sélectionnés.

5. Rédiger la structure du site web

Créez un projet de structure avant d'échafauder ou de modifier lourdement les pages. Privilégiez :

WEBSITE_STRUCTURE_DRAFT.md

Incluez :

  • Direction du design
  • Public cible
  • Navigation
  • Liste des pages
  • Objectif de chaque page
  • Contenu suggéré par page
  • Questions ou décisions ouvertes
  • Recommandation technique

Une bonne première structure :

  • Accueil
  • À propos
  • CV
  • Projets
  • Contact

Pour les profils à forte composante recherche, laissez de la place pour des pages de présentation web académiques ultérieures.

6. Échafauder le site web

Utilisez Astro par défaut pour un site web personnel à contenu riche, sauf si l'utilisateur demande une autre pile.

Structure suggérée :

src/
  pages/
    index.astro
    about.astro
    cv.astro
    projects.astro
    contact.astro
  content/
    profile.ts
    projects.ts
  layouts/
    BaseLayout.astro
  styles/
    global.css
public/

Construisez le contenu du site à partir de fichiers sources structurés, pas en dispersant du texte de CV codé en dur partout.

Fichiers de contenu recommandés :

  • src/content/profile.ts pour l'identité, le profil, l'expertise, l'expérience, la formation, les publications.
  • src/content/projects.ts pour les entrées de projet et les notes de présentation ultérieures.

Copiez les ressources publiques dans public/ :

  • CV PDF, si l'utilisateur souhaite un CV téléchargeable.
  • Image de portrait, si disponible et approuvée.
  • Images ou figures de projet plus tard.

7. Concevoir la première version

Pour un premier site personnel :

  • Faites du premier écran l'identité/le profil réel, pas une page de destination marketing.
  • Utilisez des ressources visuelles réelles lorsqu'elles sont disponibles.
  • Gardez les informations de contact respectueuses de la vie privée.
  • Construisez des pages qui peuvent être parcourues rapidement mais développées plus tard.
  • Pour les publics de l'industrie, mettez l'accent sur l'utilité en ingénierie, les flux de travail R&D, la profondeur technique et les capacités transférables.
  • Pour les publics académiques, mettez l'accent sur les questions de recherche, les méthodes, les publications et le flux de présentation.

Évitez de surajuster la première version. Laissez des endroits clairs pour les futures pages de présentation de projet.

8. Vérifier localement

Exécutez :

npm.cmd install
npm.cmd run build
npm.cmd run dev

Sur Windows/PowerShell, préférez npm.cmd si npm est bloqué par la stratégie d'exécution des scripts.

Si la télémétrie d'Astro tente d'écrire en dehors de l'espace de travail, définissez des scripts dans package.json comme :

"dev": "set ASTRO_TELEMETRY_DISABLED=1&& astro dev",
"build": "set ASTRO_TELEMETRY_DISABLED=1&& astro build",
"preview": "set ASTRO_TELEMETRY_DISABLED=1&& astro preview"

Vérifiez :

  • La construction réussit.
  • Les routes locales retournent 200.
  • Les ressources publiques se chargent.
  • Aucun détail sensible n'est affiché par accident.
  • Une vérification visuelle du navigateur est effectuée si disponible, ou l'utilisateur révise manuellement.

9. Mettre à jour les fichiers de statut et README

Mettez à jour un fichier de tableau de bord/statut si le projet en utilise un, par exemple :

PROJECT_STATUS.md

Fichiers de support utiles :

  • readme_website.txt : comment éditer, prévisualiser, construire et valider le site web.
  • readme_git.txt : configuration Git et commandes courantes.
  • WEBSITE_WORKFLOW.md : workflow à long terme.

Gardez le statut concis. N'ajoutez pas de détails Git superflus sauf si l'utilisateur le demande.

Résultats attendus

À la fin d'un premier passage, le projet doit comporter :

  • Fichier source Markdown du CV extrait.
  • Projet de structure du site web.
  • Site Astro fonctionnel.
  • Contenu séparé du code de page/mise en page.
  • Une construction réussie.
  • Une URL de prévisualisation locale.
  • Des notes claires sur ce qui reste en attente.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills associés