reflect

Présentation de reflect skill

À quoi sert reflect

reflect est un skill de réévaluation en cours de conversation pour Claude : il met l’exécution en pause, relit l’échange à partir de l’objectif initial et formule un jugement franc sur la direction à prendre. Au lieu de s’enfoncer davantage dans les détails, reflect skill vérifie si la trajectoire actuelle a toujours du sens, quelles hypothèses la soutiennent, ce qui manque peut-être, et si la prochaine étape devrait être de continuer, de pivoter ou de s’arrêter temporairement.

Il est particulièrement utile pour le Decision Support, la planification, le travail produit, les boucles de débogage, les discussions de stratégie et tout échange long où l’avancée tactique peut masquer une dérive stratégique.

Utilisateurs et situations les plus adaptés

Installez reflect si vous demandez souvent à un assistant IA de vous aider sur des tâches en plusieurs étapes et que vous voulez disposer d’un mécanisme fiable de « vérification de bon sens ». Il convient aux utilisateurs qui formulent des demandes comme « prends du recul », « est-ce qu’on passe à côté de quelque chose ? », « est-ce qu’on complique trop ? », « élargis la perspective » ou « est-ce qu’on est toujours sur la bonne voie ? ».

Son meilleur cas d’usage n’est pas le résumé. Son vrai rôle est la correction de trajectoire : repérer le biais de confirmation, le raisonnement en coûts irrécupérables, l’ancrage, la dérive de complexité ou le biais de récence avant que la conversation ne s’engage trop loin dans la mauvaise direction.

Ce qui distingue reflect

Le skill est volontairement peu exigeant en informations d’entrée. Si la conversation précédente contient assez de contexte, il doit s’exécuter immédiatement plutôt que demander une longue préparation. Si le contexte est trop maigre, il pose une seule question de clarification vraiment nécessaire au lieu de transformer la réflexion en nouvel exercice de planification.

Ses références associées apportent une discipline utile : la réflexion doit relire depuis l’objectif initial, éviter d’inventer des problèmes simplement pour paraître rigoureuse, et se terminer par une recommandation concrète. Les scripts inclus sont aussi utiles pour les équipes qui veulent tester des transcriptions ou vérifier si les sorties de réflexion sont assez spécifiques.

Comment utiliser reflect skill

Installation de reflect et chemin du dépôt

Installez le skill depuis le dépôt GitHub avec :

npx skills add alirezarezvani/claude-skills --skill reflect

La source se trouve ici :

productivity/reflect/skills/reflect

Lisez d’abord SKILL.md, puis examinez ces fichiers pour comprendre le modèle de fonctionnement :

• references/cognitive_bias_canon.md
• references/conversation_reflection_practice.md
• references/honest_output_discipline.md
• scripts/bias_pattern_detector.py
• scripts/conversation_depth_analyzer.py
• scripts/directional_recommendation_validator.py

C’est un skill de raisonnement pur. Il ne nécessite ni API externe, ni base de données, ni outil propre à un fournisseur, au-delà d’un environnement de skills compatible.

Comment invoquer reflect en pratique

Utilisez une formulation directe dans une conversation active :

• “Reflect on where we are before we continue.”
• “Take a step back. Are we solving the right problem?”
• “Sanity check this plan for bias and drift.”
• “Are we overthinking this, or is the complexity justified?”
• “Use reflect for Decision Support: should we continue, pivot, or pause?”

Un bon prompt d’utilisation de reflect indique la pression de décision, pas seulement le sujet. Par exemple, au lieu de “reflect on this”, écrivez : “Reflect before we implement. Original goal: reduce onboarding friction. Current path: adding a multi-step configuration wizard. Check whether this is still aligned, what assumptions we are making, and whether we should continue, pivot, or pause.”

Entrées qui améliorent la qualité de sortie

Le skill donne ses meilleurs résultats lorsque la conversation contient déjà l’objectif initial, le plan actuel, les contraintes et les décisions récentes. Si ces éléments sont dispersés, reformulez-les brièvement avant d’invoquer reflect.

Modèle d’entrée utile :

• Objectif initial : ce que devait signifier la réussite
• Direction actuelle : ce que la conversation est en train d’optimiser
• Point de décision : ce à quoi vous êtes sur le point de vous engager
• Contraintes : échéances, tolérance au risque, besoins utilisateurs, limites techniques
• Préoccupation : dérive, complexité, biais, manque de preuves ou blocage

Cela aide le skill à comparer la trajectoire actuelle au cadre de départ, au lieu de simplement réagir aux derniers échanges.

Workflow facultatif avec scripts

Les scripts ne sont pas obligatoires, mais ils sont utiles pour une revue reproductible. Enregistrez une transcription en texte brut avec des tours User: et Assistant:, puis exécutez :

python scripts/conversation_depth_analyzer.py --conversation /tmp/transcript.txt

Utilisez bias_pattern_detector.py pour signaler des schémas de biais possibles, puis laissez l’IA exercer son jugement au lieu de traiter les résultats regex comme des preuves. Après avoir généré une réflexion, directional_recommendation_validator.py peut vérifier si la sortie se termine par une recommandation spécifique — continuer, pivoter ou s’arrêter — et évite les réassurances vagues.

FAQ sur reflect skill

reflect est-il simplement un meilleur prompt de résumé ?

Non. Un résumé condense ce qui s’est passé ; reflect juge si la conversation vise toujours le bon résultat. reflect skill doit faire ressortir les dérives, les preuves manquantes, les solutions surdimensionnées, les contraintes négligées ou l’élan injustifié. Si tout est réellement solide, il doit le dire avec des éléments à l’appui plutôt que fabriquer des objections.

Quand ne faut-il pas utiliser reflect ?

Ne l’utilisez pas pour des tâches simples et ponctuelles, des recherches factuelles ou des moments où il n’existe pas de contexte antérieur significatif à réévaluer. Il convient aussi mal si vous cherchez uniquement de l’encouragement ou un retour de style. Le skill est conçu pour interrompre l’élan, ce qui est précieux dans un travail complexe mais inutile pour des tâches triviales.

reflect est-il accessible aux débutants ?

Oui, car l’invocation peut être aussi simple que “reflect” ou “take a step back.” Les débutants profitent de sa conception peu exigeante en informations d’entrée, tandis que les utilisateurs avancés obtiennent de meilleurs résultats en fournissant l’objectif initial, la décision en cours et le mode d’échec suspecté.

Comment reflect pour le Decision Support aide les équipes

Pour le Decision Support, reflect apporte une pause structurée avant de s’engager. Il est utile avant de choisir une orientation produit, de finaliser une conception technique, de poursuivre une piste de débogage ou d’accepter une recommandation. Sa valeur est maximale lorsque le coût de continuer dans la mauvaise direction est plus élevé que celui de s’arrêter pour réévaluer.

Comment améliorer reflect skill

Donner à reflect un point de décision clair

La sortie faible la plus fréquente vient d’une invocation trop vague. “Reflect on our discussion” peut fonctionner, mais “Reflect before we choose option B; check for anchoring, missing counterevidence, and whether we should continue, pivot, or pause” donne au skill une cible plus nette.

Si un risque précis vous préoccupe, nommez-le. Par exemple : “I’m worried we are adding features because each one sounds reasonable individually. Check for complexity bias.”

Imposer une réévaluation fondée sur des preuves

Une bonne sortie de reflect doit citer des éléments concrets de la conversation : l’objectif initial, le moment où le cadrage a changé, l’hypothèse devenue dominante ou la décision qui doit être validée. Si la réponse paraît générique, demandez : “Redo the reflection using specific evidence from earlier turns and end with a concrete recommendation.”

Cela correspond à la discipline d’honnêteté du dépôt : pas de pessimisme vague, pas de réassurance vague, et pas de problèmes inventés.

Surveiller les modes d’échec fréquents

Les échecs courants de reflect consistent à se concentrer uniquement sur les derniers échanges, à résumer au lieu de juger, à trouver des problèmes sans preuves ou à terminer sans prochaine action claire. Un autre échec est l’excès de questions : le skill ne doit poser une clarification que lorsque la conversation est trop pauvre pour être réévaluée.

Vous pouvez corriger cela en disant : “Reread from the original goal, not just the recent implementation details. Identify the strongest reason to continue and the strongest reason to pivot.”

Itérer après la première recommandation

Traitez la première réflexion comme un point de contrôle décisionnel, pas comme la fin du travail. Si la recommandation est de continuer, demandez quelles preuves pourraient changer cette position. Si elle est de pivoter, demandez le plus petit pivot viable. Si elle est de s’arrêter, demandez quelles informations manquantes précises doivent être résolues avant de poursuivre.

C’est ce qui rend reflect pratique : l’objectif n’est pas d’ajouter de l’analyse, mais d’obtenir une meilleure prochaine action.