Ajouter un Membre du Laboratoire

Que fait Ajouter un Membre du Laboratoire ?

Cette compétence vous guide dans l'ajout d'un nouveau membre du laboratoire au site web avec un formatage, une rédaction de biographie et une gestion d'images appropriés.

Quand Utiliser Cette Compétence

Utilisez cette compétence lorsque :

• "Ajouter un nouveau membre du laboratoire"
• "Créer un profil pour [nom]"
• "Ajouter [nom] à la page de l'équipe"
• "Mettre à jour le rôle de [nom]"
• "Marquer [nom] comme ancien membre"
• Toute demande impliquant l'ajout ou la mise à jour de profils de membres de l'équipe

Flux de Travail Interactif

Étape 1 : Rassembler les Informations de Base

Demandez à l'utilisateur les détails essentiels :

Obligatoire :

• Nom complet
• Rôle (pi, postdoc, staff, phd, ms, ra, programmer, undergrad, highschool)

Optionnel (nous ferons des recherches si non fourni) :

• Adresse e-mail
• Nom d'utilisateur GitHub
• Profil LinkedIn
• Site web personnel
• Établissement/programme actuel (si étudiant)

Utilisez AskUserQuestion pour collecter ces informations si elles ne sont pas fournies dans la demande initiale.

Étape 2 : Recherche Web

Effectuez des recherches web pour rassembler des informations de fond :

1. Recherchez LinkedIn pour le parcours éducatif et professionnel

   • Requête : "[Nom complet] LinkedIn [établissement si connu]"
   • Extrayez : diplômes, établissements, postes antérieurs

2. Recherchez GitHub pour le nom d'utilisateur et les projets

   • Requête : "[Nom complet] GitHub [domaine de l'e-mail si connu]"
   • Extrayez : nom d'utilisateur, dépôts notables

3. Recherchez les pages institutionnelles pour les informations biographiques

   • Requête : "[Nom complet] [établissement] neurosciences/biologie/informatique"
   • Extrayez : intérêts de recherche, travaux actuels

4. Recherchez les publications si applicable (doctorant/postdoc)

   • Requête : "[Nom complet] [établissement] publications"
   • Extrayez : domaines de recherche

Présentez les résultats à l'utilisateur :

• Montrez ce que vous avez trouvé
• Demandez à l'utilisateur de confirmer l'exactitude
• Demandez des clarifications sur tout élément peu clair
• Demandez toute information critique manquante

Étape 3 : Rédiger la Biographie

En utilisant les informations rassemblées et le modèle adapté au rôle :

1. Déterminez la longueur de la biographie en fonction du rôle :

   • PI : 250-300 mots (détaillé)
   • Doctorant/Postdoc/Personnel : 100-150 mots
   • Master/AR/Programmeur : 80-120 mots
   • Étudiant de licence : 80-100 mots
   • Ancien membre : 50-250 mots (en fonction de l'ancienneté et des réalisations)

2. Suivez le modèle de biographie du répertoire templates/ :

   • Utilisez la troisième personne
   • Ton professionnel et académique
   • Incluez : formation, date d'arrivée, axe de recherche/travail actuel
   • Mentionnez les co-encadrants si applicable
   • Mettez en valeur l'expérience antérieure si pertinente
   • Notez les distinctions/bourses si remarquables

3. Présentez le projet à l'utilisateur :

   • Montrez la biographie rédigée
   • Demandez s'ils souhaitent apporter des modifications
   • Affinez en fonction des retours

Étape 4 : Gérer l'Image du Profil

1. Demandez une image à l'utilisateur :

   • "Avez-vous une photo de profil pour [nom] ?"
   • Si oui : "Veuillez fournir le chemin d'accès au fichier image"
   • Si non : "Nous pouvons utiliser un placeholder pour l'instant et l'ajouter plus tard"

2. Si une image est fournie, validez et optimisez-la :

   • Vérifiez la taille et les dimensions du fichier à l'aide de file ou sips
   • Spécifications cibles : 100-250 Ko, rapport hauteur/largeur raisonnablement carré
   • Si trop volumineuse (>500 Ko) ou mauvais rapport hauteur/largeur :
     • Proposez de redimensionner/optimiser à l'aide de scripts/optimize-image.sh
     • Utilisez sips (macOS) ou convert (ImageMagick) si disponibles

3. Générez le nom du fichier image :

   • Format : prenom-nom.jpg
   • Assurez-vous qu'il n'y a pas d'espaces ni de caractères spéciaux
   • Copiez dans le répertoire images/ avec le nom correct

Étape 5 : Générer le Fichier Membre

1. Créez le nom de fichier : _members/prenom-nom.md

2. Construisez le frontmatter :

   ---
   name: [Nom complet]
   image: images/[prenom-nom].jpg
   role: [rôle]
   description: [Texte d'affichage du rôle depuis roles.yaml]
   links:
     email: [email si fourni]
     github: [nom d'utilisateur si trouvé/fourni]
     linkedin: [profil si trouvé/fourni]
     home-page: [url si fourni]
   ---
   

   • Incluez uniquement les liens disponibles
   • Supprimez les champs de liens vides

3. Ajoutez le texte de la biographie (de l'étape 3)

4. Écrivez le fichier dans _members/prenom-nom.md

Étape 6 : Gérer les Anciens Membres (si applicable)

Si le rôle est alumni OU si l'utilisateur indique que cette personne part :

1. Demandez les détails de l'ancien membre :

   • Année de départ
   • Leur rôle au sein du laboratoire (si différent du rôle actuel)
   • Poste "suivant" (où ils vont)

2. Mettez à jour team/index.md :

   • Lisez la section actuelle des anciens membres
   • Ajoutez une entrée dans l'ordre chronologique (la plus récente en premier) :

     - ANNÉE : [**Nom**](/members/prenom-nom.html) (Description du rôle). **Suivant :** [Poste suivant]
     

   • Maintenez un formatage correct

Étape 7 : Valider

Exécutez les vérifications de validation :

• Le fichier membre existe dans _members/prenom-nom.md
• Le frontmatter YAML est valide
• Le rôle est valide (vérifiez par rapport à roles.yaml)
• Le fichier image existe (ou noté comme placeholder)
• La biographie a une longueur appropriée pour le rôle
• La biographie utilise la troisième personne
• Les liens sont correctement formatés
• Si ancien membre : team/index.md est mis à jour

Étape 8 : Présenter le Résumé

Montrez à l'utilisateur ce qui a été créé :

✓ Profil du membre créé pour [Nom]
✓ Fichier : _members/prenom-nom.md
✓ Rôle : [texte d'affichage du rôle]
✓ Image : images/prenom-nom.jpg [ou "Placeholder - ajouter plus tard"]
✓ Liens : [liste des liens inclus]
[✓ Liste des anciens membres mise à jour] [si applicable]

Aperçu de la biographie :
[100 premiers caractères de la biographie]...

Souhaitez-vous que je vous montre le contenu complet du fichier ?

Étape 9 : Commit Optionnel

Demandez à l'utilisateur s'il souhaite valider les modifications :

• Si oui : Créez un commit git avec un message approprié
• Si non : Laissez les modifications non indexées pour une révision manuelle

Consignes de Rédaction de la Biographie

Voix et Ton

• Toujours à la troisième personne : "Jane est doctorante..." (pas "Je suis...")
• Professionnel et académique : Formel mais pas guindé
• Factuel et axé sur les réalisations : Mettez l'accent sur les diplômes et le travail
• Temps présent pour le travail actuel : "travaille sur", "développe", "recherche"
• Temps passé pour les antécédents : "a reçu", "a travaillé", "a rejoint"

Éléments Essentiels

Tous les membres doivent inclure :

1. Rôle actuel et établissement
2. Date d'arrivée (mois et année)
3. Parcours éducatif (diplôme, spécialité, établissement)
4. Axe de recherche/travail actuel

Éléments supplémentaires par rôle :

PI :

• Établissement du doctorat et encadrants (avec hyperliens)
• Philosophie et approche de recherche
• Publications notables ou couverture médiatique
• Postes antérieurs
• Distinctions et récompenses majeures

Doctorant/Postdoc :

• Établissement de licence et/ou de master
• Intérêts de recherche spécifiques
• Co-encadrants si applicable
• Expérience de recherche antérieure si notable

Personnel/Programmeur :

• Expérience professionnelle antérieure (industrie ou académie)
• Expertise technique et domaines de prédilection
• Projets sur lesquels ils travaillent
• Nominations conjointes si applicable

Étudiants (Master/Licence) :

• Spécialité et année
• Intérêts de recherche
• Stages ou recherches antérieurs si applicable
• Distinctions/bourses si remarquables

Anciens Membres :

• Tout ce qui précède en fonction de leur rôle
• Mentors (surtout pour les stagiaires de courte durée)
• Réalisations durant leur séjour au laboratoire
• Restez concis pour les stagiaires d'été (50-80 mots)

Ce qu'il Faut Éviter

• Narration à la première personne (sauf éventuellement l'intro du PI)
• Détails excessifs sur les projets (limitez-vous à 1-2 phrases)
• Temps futur ou spéculation
• Langage décontracté ou argot
• Informations personnelles non liées à la recherche
• Redondance avec le frontmatter (nom, rôle déjà affichés)

Détails de la Gestion des Images

Spécifications Préférées

• Format : JPG (de préférence) ou PNG
• Taille : 100-250 Ko pour une optimisation web
• Rapport hauteur/largeur : Carré ou quasi-carré (1:1 ou 4:5)
• Dimensions minimales : 300x300 pixels
• Recommandé : 400x400 à 600x600 pixels
• Couleur : Espace colorimétrique RVB

Processus d'Optimisation

Si l'image nécessite une optimisation :

# Utilisez le script fourni
bash .claude/skills/add-member/scripts/optimize-image.sh entree.jpg sortie.jpg 500

Ou manuellement avec sips (macOS) :

# Redimensionner à 500px max, en conservant le rapport hauteur/largeur
sips -Z 500 entree.jpg --out sortie.jpg

# Convertir PNG en JPG
sips -s format jpeg entree.png --out sortie.jpg

Ou avec ImageMagick :

# Redimensionner et optimiser
convert entree.jpg -resize 500x500^ -quality 85 sortie.jpg

Convention de Nommage

• Utilisez le kebab-case : prenom-nom.jpg
• Pas d'espaces, de caractères spéciaux ou de majuscules
• Doit correspondre au slug du fichier membre
• Exemples : jane-doe.jpg, john-smith.jpg

Notes Spécifiques aux Rôles

Ajouter des Anciens Membres

Lors de l'ajout d'une personne qui est déjà partie :

1. Définissez role: alumni dans le frontmatter
2. Incluez leur rôle réel dans le texte de la biographie
3. Mettez à jour la section des anciens membres dans team/index.md avec :
   • L'année de leur départ
   • La description du rôle entre parenthèses
   • L'annotation "Suivant :" si connue

Gérer les Co-encadrants

Lorsque le membre a un co-encadrant :

1. Mentionnez-le dans la biographie : "co-encadré par [Nom]"
2. Incluez un hyperlien si possible : [Nom](url)
3. Notez-le dans le résumé lors de la présentation à l'utilisateur

Nominations Conjointes

Lorsque le membre a une affiliation conjointe :

1. Mentionnez-le dans la biographie : "conjointement avec le [Nom du Laboratoire]"
2. Incluez un hyperlien vers l'autre laboratoire si disponible
3. Notez clairement les IP collaborateurs

Étudiants Changeant de Rôle

Lorsqu'un étudiant passe de licence → master → doctorat :

1. Créer un nouveau fichier membre ? Non - gardez le même fichier
2. Mettez à jour le champ role: dans le frontmatter
3. Mettez à jour la biographie pour refléter le nouveau statut
4. Mettez à jour le champ description:
5. Envisagez d'ajouter une note sur la transition dans la biographie

Stagiaires d'Été

Membres de courte durée (2-3 mois) :

1. Pendant la période active : Ajoutez avec le rôle undergrad ou highschool
2. Au départ : Passez à role: alumni
3. Biographie : Peut être brève (50-80 mots) mais mettez en évidence :
   • L'établissement et le programme
   • Sur quoi ils ont travaillé
   • Qui les a encadrés
   • Toute réalisation notable

Gestion des Erreurs

Si la recherche web ne trouve rien :

• Demandez à l'utilisateur de fournir directement les informations
• Proposez de rédiger une biographie minimale et laissez-les l'étoffer

Si l'image a un mauvais format/taille :

• Proposez d'optimiser à l'aide des outils fournis
• Si les outils ne sont pas disponibles, fournissez des instructions manuelles
• Dans le pire des cas, utilisez un placeholder et notez-le dans le résumé

En cas de doute sur le rôle :

• Présentez les options de rôle depuis roles.yaml
• Utilisez AskUserQuestion pour clarifier

Si un membre en double existe :

• Vérifiez s'il s'agit d'une mise à jour ou d'un nouveau membre
• Demandez à l'utilisateur s'il souhaite mettre à jour l'existant ou en créer un nouveau

Liste de Vérification de Validation

Avant de finaliser, vérifiez :

• Le nom complet correspond entre le nom de fichier, le frontmatter et la biographie
• Le rôle est valide (un parmi : pi, postdoc, staff, phd, ms, ra, programmer, undergrad, highschool, alumni)
• Le nom du fichier image respecte la convention (kebab-case, .jpg)
• La biographie est à la troisième personne tout du long
• La longueur de la biographie est appropriée pour le rôle (voir les directives)
• La date d'arrivée est mentionnée dans la biographie (mois et année)
• Le parcours éducatif est inclus
• Tous les liens sont correctement formatés
• Le frontmatter YAML est valide (testez avec un analyseur)
• Si ancien membre : team/index.md est mis à jour correctement
• Pas d'espace blanc en fin de ligne ni de problèmes de formatage

Voir Aussi

• reference.md - Documentation détaillée sur le format et les modèles de fichiers membres
• examples.md - Exemples de flux de travail pour différents scénarios
• templates/ - Modèles de biographie pour chaque type de rôle