Post-mortem technique d'un ticket (un champ + pointeurs)
L'utilisateur met tout dans un seul champ et pointe les autres champs d'analyse vers celui-ci, pour ne rien dire deux fois. Reproduire ce workflow.
Configuration
Lire ~/.config/skills/analyse-causes/config.md avant toute chose. Il définit le tracker et ses outils, le motif de clé de projet et de ticket, le format des champs, la langue et les titres du rapport, le champ de rédaction, les champs déviés avec leur texte pointeur, et les champs de lien MR. S'il est manquant, dire à l'utilisateur de copier config.example.md (à côté de ce fichier) vers ~/.config/skills/analyse-causes/config.md, de le remplir, puis s'arrêter.
Cible : le ticket passé en argument, sinon le correctif en cours dans la session (diff / branche / MR).
Ce qu'il faut produire
Un rapport complet, dans la langue configurée, en markdown, avec deux sections sous les titres configurés :
- Cause racine - le POURQUOI technique. NE PAS reformuler la situation initiale (symptôme / description du ticket). Revenir à l'origine réelle : choix de conception,
constante/fichier:ligne, hypothèse erronée. Jamais le symptôme visible. - Correctif - ce qui a changé et pourquoi cela supprime la cause racine. Factuel : mécanisme choisi, fichiers/constantes touchés, comportement résultant. Pas de lien MR ici : il va dans les champs de lien MR configurés.
Règles : concis, courtes puces, termes exacts (constantes, fonctions, fichier:ligne), vérifiés sur le code réel. Pas de tiret cadratin (U+2014) – utiliser trait d'union, virgule, ou reformuler.
Procédure
- Identifier le ticket : argument = clé correspondant au motif configuré ; sinon le correctif en cours (diff / branche / MR de la session).
- Lire le ticket via l'outil configuré si nécessaire, mais ne pas copier sa description.
- Tracer la cause racine dans le code et lister les modifications du correctif (git diff / MR).
- Rédiger le rapport complet.
- Afficher le rapport, puis écrire les champs dans le format configuré :
- champ de rédaction <- le rapport complet
- chaque champ dévié <- un document d'un paragraphe avec le texte pointeur configuré Si aucun ticket n'est ciblé (correctif en session sans clé), seulement afficher le rapport et proposer de remplir les champs.