Communitygithub.com

Rétro de Session

Analysez une session d'agent IA pour trouver des axes d'amélioration.

Qu'est-ce que Rétro de Session ?

Cette compétence, conçue pour les agents IA comme Claude Code, permet d'effectuer une rétrospective interactive d'une session de travail. Le but est d'améliorer l'efficacité de la collaboration entre l'utilisateur et l'agent en identifiant des opportunités d'optimisation dans les prompts, la documentation, les outils et les workflows. Le processus se déroule en plusieurs étapes : observation libre des faits marquants de la session, approfondissement interactif avec l'utilisateur (avec possibilité de déléguer certaines analyses à des sous-agents), discussion des résultats, et enfin synthèse des recommandations actionnables. L'accent est mis sur l'adaptation naturelle à la conversation et le respect du temps de l'utilisateur, sans jamais exécuter d'actions de modification de fichiers ou de code.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add VdustR/skills

Demander à votre IA préférée

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

Documentation

Que fait Rétro de Session ?

Analysez une session d'agent IA pour trouver des axes d'amélioration. La rétro se déroule par un dialogue interactif — observez ce qui s'est passé, discutez des conclusions avec l'utilisateur, puis présentez des recommandations actionnables.

L'objectif est d'améliorer l'efficacité de collaboration IA de l'utilisateur : de meilleurs prompts, une meilleure documentation, de meilleurs outils, de meilleurs workflows.

Démarrage rapide

Rétrospectivons cette session

/retro

Qu'aurais-je pu améliorer dans cette session ?

Revue de session — trouver des opportunités d'optimisation

Quand l'utiliser

  • À la fin d'une session de travail pour réfléchir et capturer les apprentissages
  • Après une session avec des frictions, des corrections ou des contournements
  • Quand on souhaite améliorer les instructions, compétences, hooks ou workflows de l'agent
  • Quand on est curieux de savoir quelles compétences de la communauté pourraient aider face à des schémas observés dans la session
  • Périodiquement pour maintenir des pratiques de développement saines

Comment ça fonctionne

Le déroulement ci-dessous est une indication typique — adaptez-vous naturellement à la conversation. Toutes les sessions n'ont pas besoin de chaque étape ; une session courte sans problème peut simplement nécessiter une rapide observation et passer à autre chose.

Observation

Passez en revue la conversation de la session et identifiez librement tout ce qui mérite d'être noté. Ne vous limitez pas à des catégories prédéfinies — laissez les observations émerger naturellement de ce qui s'est réellement passé.

Pour chaque observation, fournissez une conclusion en une ligne et une recommandation actionnable initiale. Même si l'utilisateur n'approfondit pas, chaque observation doit offrir un enseignement utile.

Après l'analyse libre, utilisez les 15 dimensions dans dimensions.md comme une liste de contrôle de sécurité — vérifiez si l'observation libre a pu manquer quelque chose. Ne mentionnez que les conclusions supplémentaires qui valent vraiment la peine d'être notées.

Incluez à la fois :

  • Conclusions réactives : les choses qui ont mal tourné ou ont été corrigées
  • Conclusions proactives : les choses qui ont bien fonctionné mais ne sont pas documentées, ou les bonnes pratiques qui pourraient être codifiées

Approfondissement interactif

Présentez les observations une par une avec un indicateur de progression (par ex. [2/6]). Pour chaque observation, donnez la recommandation initiale et demandez à l'utilisateur s'il souhaite approfondir.

L'utilisateur peut :

  • Répondre oui — noter pour approfondissement
  • Répondre non — passer à la suivante (la recommandation initiale reste valable)
  • Ajouter du contexte ou des corrections
  • Soulever des observations que l'IA a manquées
  • Dire "ça suffit" pour ignorer les suivantes et passer à la suite

Après avoir parcouru toutes les observations, si l'utilisateur en a sélectionné certaines pour approfondissement, évaluez quels éléments nécessitent réellement une recherche par sous-agent par rapport à ceux qui sont suffisamment clairs pour agir directement. Présentez cette évaluation et demandez à l'utilisateur de confirmer avant de lancer des sous-agents.

Chaque sous-agent suit le cycle décrit dans subagent-guide.md : rechercher l'observation en profondeur, analyser les causes profondes, concevoir des solutions concrètes, et présenter les conclusions avec une recommandation.

Résultats et discussion

Présentez les résultats de chaque sous-agent un par un avec une indication de progression. L'utilisateur peut :

  • Discuter du résultat et poser des questions de suivi
  • Accepter une option recommandée
  • Demander des modifications
  • Passer au résultat suivant

Recommandations d'actions

Après avoir discuté de tous les résultats, compilez les actions confirmées dans un résumé de recommandations. Pour chaque action, présentez quoi faire et pourquoi. Si l'utilisateur demande de persister (par ex. "écris-le"), générez un résumé en markdown dans le chat — n'écrivez pas de fichiers.

Fermez explicitement la rétro : dites à l'utilisateur que la rétro est terminée et que les actions recommandées lui appartiennent pour les initier quand il sera prêt.

Directives

À FAIRE

  • Laissez les observations émerger du contenu réel de la session, pas d'un modèle fixe
  • Donnez des enseignements actionnables pour chaque observation, même sans approfondissement
  • Respectez le temps de l'utilisateur — si une session était propre, dites-le et restez bref
  • Demandez la permission avant de lancer des sous-agents
  • Pour les corrections : cherchez si la cause profonde est une convention manquante, une documentation peu claire, ou une compétence qui doit être améliorée
  • Pour les bonnes pratiques : suggérez de les codifier avant qu'elles ne soient oubliées
  • Lors de l'analyse des compétences : vérifiez d'abord la propriété (auto-maintenue vs communautaire) pour donner des conseils appropriés
  • Présentez les conclusions avec une recommandation et un raisonnement

À NE PAS FAIRE

  • N'exécutez aucune action (par ex. commit, push, modification de fichiers). Cette compétence est uniquement destinée à l'analyse et aux recommandations
  • N'interprétez pas l'accord de l'utilisateur (par ex. "oui", "ça me semble bien", "vas-y") comme une demande d'exécution. Ces réponses ne sont que des accusés de réception
  • N'agissez sur aucune instruction avant que la rétro ne soit explicitement fermée. Seule une nouvelle instruction spécifique après la conclusion de la rétro est une demande valide d'action
  • Ne forcez pas une séquence rigide de phases — adaptez-vous à la conversation
  • Ne sur-analysez pas les sessions avec des problèmes minimes
  • Ne lancez pas de sous-agents sans la permission de l'utilisateur
  • Ne recommandez pas de changements sans en expliquer la raison
  • N'omettez pas l'option "ne rien faire / passer" lors de la présentation des choix
  • Ne portez pas de jugement sur les prompts ou le workflow de l'utilisateur — soyez constructif

Fichiers de référence

  • dimensions.md — 15 dimensions d'analyse utilisées comme liste de contrôle de sécurité
  • subagent-guide.md — Comment les sous-agents recherchent, analysent et présentent leurs conclusions

Remarques

  • Les 15 dimensions sont une liste de contrôle, pas une grille de notation. La plupart des sessions n'auront du signal que dans quelques dimensions.
  • Une analyse transversale des schémas entre sessions est disponible si l'utilisateur souhaite examiner plusieurs sessions — demandez le périmètre au début si ce n'est pas clair.
  • Outils connexes que l'utilisateur peut invoquer séparément après une rétro : hookify, claude-md-management, skill-creator, brainstorming. La rétro ne les invoque pas directement.

Skills associés