reflect

Vue d’ensemble de la skill reflect

À quoi sert reflect

reflect est une skill de Skill Validation pensée pour une relecture en second passage : elle prend une réponse terminée ou presque terminée et la met sous pression pour détecter les failles oubliées, les raisonnements fragiles ou les validations trop confiantes. La reflect skill est surtout utile quand vous avez besoin d’un filtre qualité rapide mais sceptique, pas d’une nouvelle solution.

Qui devrait l’installer

Utilisez reflect si vous relisez des travaux générés par IA, si vous livrez des réponses destinées à un usage en production, ou si vous avez besoin d’un contrôle discipliné du type « est-ce que ça peut passer ? ». Il convient aux agents capables de fournir la sortie précédente ainsi que le contexte de la tâche. Si vous cherchez de l’idéation ou de l’aide à la rédaction, cette skill n’est pas la bonne.

Ce qui la différencie

La skill repose sur le tri de la complexité, les vérifications de confiance et un retour orienté validation. En pratique, l’installation de reflect est surtout utile quand vous voulez que le modèle décide à quel point inspecter en profondeur, puis concentre son attention là où l’échec est le plus probable. Il s’agit moins de polir le style que de repérer les défauts avant qu’ils ne se propagent.

Comment utiliser la skill reflect

Installez reflect et pointez-la vers une réponse précédente

Installez la skill reflect dans votre environnement d’agent, puis invoquez-la avec la sortie cible que vous voulez faire relire. Le schéma d’installation du repo est npx skills add NeoLabHQ/context-engineering-kit --skill reflect. Pour de meilleurs résultats, fournissez le prompt d’origine, la réponse brouillon et tous les critères d’acceptation.

Donnez-lui la bonne forme d’entrée

reflect fonctionne mieux quand l’entrée précise la tâche, les enjeux et le seuil de confiance. Un bon prompt ressemble à ceci : « Reflect on this deployment note for correctness and omitted risks; deep reflect if less than 90% confidence. » Un mauvais prompt se limite à : « Check this. » Plus vos critères de passage/échec sont explicites, plus la relecture est utile.

Lisez d’abord ces fichiers

Commencez par SKILL.md ; il contient les règles de base, l’identité et la logique de tri qui déterminent le comportement de la skill. Si vous adaptez la skill dans un kit plus large, examinez aussi README.md, AGENTS.md et tous les fichiers de politique à l’échelle du repo pour que l’étape de réflexion corresponde à votre vrai workflow. Dans ce dépôt, SKILL.md est la principale source de vérité.

Utilisez la skill comme porte de validation

Un workflow pratique pour reflect usage est le suivant : rédiger une réponse, lancer reflect, puis ne réviser que les parties signalées comme risquées. N’essayez pas de lui faire réécrire l’ensemble sauf si la sortie d’origine est inutilisable. La meilleure utilisation de reflect guide est étroite : vérifier les affirmations, faire ressortir les contraintes manquantes et décider si le brouillon est assez sûr pour être livré.

FAQ sur la skill reflect

reflect est-elle un prompt d’écriture généraliste ?

Non. reflect n’est pas conçu pour produire un premier jet ; il sert à évaluer un jet existant. Si vous l’utilisez comme un prompt de génération classique, vous perdez l’avantage principal de la reflect skill : une relecture disciplinée après coup.

Dans quels cas reflect est-elle un mauvais choix ?

C’est un mauvais choix s’il n’y a aucune réponse préalable à évaluer, si la tâche est purement créative, ou si vous avez besoin d’une large phase d’idéation plutôt que d’une relecture centrée sur le rejet. Elle est aussi moins utile si vous ne pouvez pas fournir assez de contexte pour juger la justesse ou l’exhaustivité.

reflect est-elle adaptée aux débutants ?

Oui, si l’utilisateur peut fournir un brouillon et un objectif. Inutile de connaître tout le dépôt pour l’utiliser, mais il faut dire clairement ce que veut dire « bon ». Pour les débutants, le principal bénéfice est simplement de rendre explicites les critères de revue avant d’appeler reflect for Skill Validation.

En quoi diffère-t-elle d’un prompt ordinaire ?

Un prompt ordinaire demande généralement une solution. reflect demande une critique de cette solution dans l’incertitude, avec une attention plus forte portée aux manques et aux faux niveaux de confiance. Elle est donc plus adaptée au QA, aux vérifications d’acceptation et aux sorties à fort enjeu qu’à la génération de premier passage.

Comment améliorer la skill reflect

Renforcez les preuves que vous lui donnez

Les meilleurs résultats de reflect viennent d’entrées concrètes : la tâche d’origine, la réponse brouillon et les modes d’échec qui vous inquiètent le plus. Si le travail est technique, ajoutez les contraintes, les cas limites et le public cible. S’il s’agit de politique ou d’éditorial, ajoutez les règles à respecter.

Demandez le bon niveau de profondeur

Utilisez délibérément le déclencheur de confiance de la skill. Si le brouillon est simple, demandez une vérification rapide ; s’il est ambigu ou risqué, demandez une réflexion approfondie et des critères de rejet explicites. Cela évite à reflect de suranalyser des cas faciles ou de sous-contrôler des cas risqués.

Surveillez les modes d’échec courants

Les problèmes habituels sont une approbation vague, une critique sans fondement et l’absence de vérification par rapport aux contraintes réelles. Pour améliorer la sortie de reflect skill, demandez-lui de citer le problème précis, d’expliquer pourquoi il compte, et d’indiquer si le brouillon peut passer tel quel, doit être révisé ou doit être rejeté.

Itérez après la première relecture

Considérez la première réflexion comme un passage de triage, pas comme un verdict final. Révisez le brouillon, puis relancez reflect sur la version mise à jour pour confirmer que les corrections ont bien comblé les lacunes. C’est là que la skill prend toute sa valeur : moins de validations à tort, des corrections plus nettes et un garde-fou final plus solide.