Lev-it/lev-skills

Triage

Déplacer les tickets sur le suivi de tickets du projet à travers une petite machine à états de rôles de triage.

Chaque commentaire ou ticket posté sur le suivi de tickets pendant le triage doit commencer par cette clause de non-responsabilité :

> *Ceci a été généré par IA pendant le triage.*

Documentation de référence

• AGENT-BRIEF.md — comment rédiger des briefs d'agent durables
• OUT-OF-SCOPE.md — comment fonctionne la base de connaissances .out-of-scope/

Rôles

Deux rôles de catégorie :

• bug — quelque chose est cassé
• enhancement — nouvelle fonctionnalité ou amélioration

Cinq rôles d'état :

• needs-triage — le mainteneur doit évaluer
• needs-info — en attente d'informations supplémentaires du rapporteur
• ready-for-agent — entièrement spécifié, prêt pour un agent AFK
• ready-for-human — nécessite une implémentation humaine
• wontfix — ne sera pas traité

Chaque ticket trié doit porter exactement un rôle de catégorie et un rôle d'état. Si les rôles d'état sont en conflit, signalez-le et demandez au mainteneur avant de faire quoi que ce soit d'autre.

Ce sont des noms de rôles canoniques — les libellés réels des étiquettes utilisées dans le suivi de tickets peuvent différer. La correspondance devrait vous avoir été fournie. Exécutez /setup-matt-pocock-skills si ce n'est pas le cas.

Transitions d'état : un ticket sans étiquette va normalement d'abord à needs-triage ; de là, il passe à needs-info, ready-for-agent, ready-for-human ou wontfix. needs-info revient à needs-triage une fois que le rapporteur répond. Le mainteneur peut passer outre à tout moment — signalez les transitions qui semblent inhabituelles et demandez avant de continuer.

Invocation

Le mainteneur invoque /triage et décrit ce qu'il veut en langage naturel. Interprétez la demande et agissez. Exemples :

• "Montre-moi tout ce qui nécessite mon attention"
• "Regardons le ticket #42"
• "Déplacer #42 vers ready-for-agent"
• "Qu'est-ce qui est prêt pour que les agents le prennent en charge ?"

Afficher ce qui nécessite de l'attention

Interrogez le suivi de tickets et présentez trois catégories, de la plus ancienne à la plus récente :

1. Sans étiquette — jamais trié.
2. needs-triage — évaluation en cours.
3. needs-info avec activité du rapporteur depuis les dernières notes de triage — nécessite une réévaluation.

Affichez les comptes et un résumé d'une ligne par ticket. Laissez le mainteneur choisir.

Trier un ticket spécifique

1. Rassembler le contexte. Lisez l'intégralité du ticket (corps, commentaires, étiquettes, rapporteur, dates). Analysez toutes les notes de triage précédentes pour ne pas poser à nouveau des questions déjà résolues. Explorez la base de code à l'aide du glossaire du domaine du projet, en respectant les ADR dans la zone concernée. Lisez .out-of-scope/*.md et signalez tout rejet antérieur qui ressemble à ce ticket.

2. Recommander. Dites au mainteneur votre recommandation de catégorie et d'état avec un raisonnement, ainsi qu'un bref résumé de la base de code pertinent pour le ticket. Attendez les instructions.

3. Reproduire (bugs uniquement). Avant tout questionnement, tentez de reproduire : lisez les étapes du rapporteur, tracez le code pertinent, exécutez des tests ou des commandes. Rapportez ce qui s'est passé — reproduction réussie avec le chemin de code, échec de la reproduction ou détails insuffisants (un fort signal needs-info). Une reproduction confirmée rend le brief d'agent beaucoup plus solide.

4. Questionner (si nécessaire). Si le ticket a besoin d'être affiné, exécutez les compétences /grilling et /domain-modeling ensemble — questionnez le ticket un point à la fois, en précisant les termes du domaine et en mettant à jour CONTEXT.md/les ADR en direct à mesure que les décisions sont prises.

5. Appliquer le résultat :

   • ready-for-agent — publiez un commentaire de brief d'agent (AGENT-BRIEF.md).
   • ready-for-human — même structure qu'un brief d'agent, mais notez pourquoi il ne peut pas être délégué (jugements, accès externes, décisions de conception, tests manuels).
   • needs-info — publiez les notes de triage (modèle ci-dessous).
   • wontfix (bug) — explication polie, puis fermeture.
   • wontfix (enhancement) — écrivez dans .out-of-scope/, faites un lien depuis un commentaire, puis fermez (OUT-OF-SCOPE.md).
   • needs-triage — appliquez le rôle. Commentaire facultatif s'il y a une progression partielle.

Remplacement rapide d'état

Si le mainteneur dit "déplacer #42 vers ready-for-agent", faites-lui confiance et appliquez le rôle directement. Confirmez ce que vous êtes sur le point de faire (changements de rôle, commentaire, fermeture), puis agissez. Sautez le questionnement. Si vous passez à ready-for-agent sans session de questionnement, demandez s'il souhaite rédiger un brief d'agent.

Modèle de notes de triage (Needs-info)

## Notes de triage

**Ce que nous avons établi jusqu'à présent :**

- point 1
- point 2

**Ce dont nous avons encore besoin de vous (@rapporteur) :**

- question 1
- question 2

Capturez tout ce qui a été résolu pendant le questionnement sous "établi jusqu'à présent" afin que le travail ne soit pas perdu. Les questions doivent être spécifiques et exploitables, pas "veuillez fournir plus d'informations".

Reprendre une session précédente

Si des notes de triage précédentes existent sur le ticket, lisez-les, vérifiez si le rapporteur a répondu à toutes les questions en suspens, et présentez une image mise à jour avant de continuer. Ne reposez pas des questions déjà résolues.