Récit d'Expérience
Objectif
Rédiger un récit transparent des résultats à partir de journaux d’expérience, de tableaux et de graphiques.
Cette compétence est délibérément étroite. Elle produit un artefact vérifiable plutôt que de prétendre achever un travail nécessitant des preuves manquantes.
Entrée requise
Commencez par collecter : hypothèse, configuration, métriques, résultats, artefacts, limites.
Si une entrée requise est manquante, demandez-la ou marquez explicitement l'hypothèse sous-jacente. Ne comblez jamais un vide factuel avec un détail plausible.
Workflow
- Énoncer d'abord l'hypothèse et la comparaison.
- Décrire uniquement les détails de configuration nécessaires à l'interprétation des résultats.
- Signaler la taille de l'effet et l'incertitude avant l'interprétation.
- Relier chaque conclusion à un artefact.
- Inclure les exécutions échouées et les conditions limites.
Contrat de sortie
Renvoyer : Une section de résultats qui sépare observation, interprétation et limitation.
Maintenir trois couches distinctes :
- Faits sources : ce qui a été fourni ou observé.
- Raisonnement : comment les faits ont été organisés ou interprétés.
- Décisions : ce que l'utilisateur doit approuver, modifier ou vérifier.
Contrôle qualité
Avant de délivrer, vérifier :
- La ligne de base et le découpage d'évaluation sont clairs.
- Les métriques sont définies avant les résultats.
- La conclusion ne dépasse pas le cadre de l'expérience.
Si une vérification échoue, signaler l'écart plutôt que d'abaisser silencieusement la norme.
Exemple de forme
Un récit d'expérience de classement rapporte les gains hors ligne, les intervalles de confiance et la validation en ligne manquante.
Limites
- Ne pas inventer de noms, mesures, citations, autorisations ou résultats.
- Limiter les informations privées ou sensibles à ce que la tâche exige.
- Privilégier un artefact petit et testable à une large liste de conseils génériques.