Que fait Document de valorisation à partir de l'historique Git ?
Objectif : transformer ce que vous avez réellement livré en un brouillon que vous pouvez éditer, sans inventer d'impact. Un document de valorisation liste le travail et les résultats ; cette compétence collecte le travail et marque chaque résultat manquant comme une lacune à combler.
Étape 1 : collecter les preuves
Demandez la fenêtre temporelle (par défaut : les 6 derniers mois) et les dépôts. Ensuite, avec GitHub CLI connecté :
gh search prs --author @me --merged --merged-at ">=AAAA-MM-JJ" --json title,url,closedAt,repository --limit 200
Pour le code qui n'est pas sur GitHub, utilisez git log --author="<nom ou email>" --since="AAAA-MM-JJ" --no-merges --pretty="%h %ad %s" --date=short dans chaque dépôt. Demandez aussi à l'utilisateur de coller tout ce que Git ne peut pas montrer : incidents traités, mentorat, revues effectuées, présentations, documentation, astreintes, décisions de conception, compliments de collègues.
Ne lisez pas les dépôts privés que l'utilisateur n'a pas nommés. Ne devinez pas les noms, les équipes ou les chiffres.
Étape 2 : grouper, ne pas encore résumer
Regroupez les éléments par thèmes (par exemple : fiabilité, nouvelles fonctionnalités, performances, outils, mentorat, travail inter-équipes). Listez chaque élément sous son thème avec date et lien. Fusionnez les doublons (une PR de fonctionnalité et ses correctifs ultérieurs).
Étape 3 : rédiger chaque thème
Pour chaque thème, écrivez :
- Ce que j'ai fait : une ou deux phrases avec des verbes simples, en utilisant uniquement ce que les titres, les diffs et les notes de l'utilisateur supportent.
- Résultat : seulement si un nombre, une citation ou un résultat a été fourni. Sinon, écrivez
[LACUNE : qu'est-ce qui a changé pour les utilisateurs ou l'équipe ? une métrique avant/après ?]. - Preuves : liens.
- Signal de portée (si pris en charge) : a dirigé, a fait seul, a travaillé entre équipes, était d'astreinte, a revu les autres.
Étape 4 : terminer par les lacunes et les questions
Terminez par une liste de chaque [LACUNE], classée par l'impact qu'elle aurait sur le dossier, et les trois questions dont les réponses apporteraient le plus. Proposez de transformer la version finale en auto-évaluation, en plan de dossier de promotion ou en points pour CV.
Règles
- N'inventez jamais de métriques, pourcentages, noms de clients, titres ou portée. Une lacune visible vaut mieux qu'un chiffre inventé.
- N'enjolivez pas : « a contribué à » reste « a contribué à ». Faites correspondre les verbes aux preuves.
- Gardez le crédit de l'utilisateur honnête : si une PR était un effort d'équipe, précisez quelle partie était la sienne.
- Restez discret sur les détails privés ou confidentiels, sauf si l'utilisateur dit que le document est interne.
- Produisez du Markdown que l'utilisateur peut coller dans ses notes.