Files
Support-Agent/.claude/skills/labels-learner/SKILL.md
T

49 lines
4.6 KiB
Markdown

---
name: labels-learner
description: Apprendre des étiquettes de l'expert (labeling/) — sur un phénomène, l'analyste mesure dans les données ce que disent les étiquettes, pose ses questions à l'expert jusqu'à avoir compris, puis passe ses conclusions au documentaliste, qui les fait entrer dans la documentation. Lancé par l'utilisateur seulement, avec /labels-learner.
disable-model-invocation: true
argument-hint: "<phénomène, en quelques mots>"
---
# Apprendre des étiquettes de l'expert
L'expert, c'est l'utilisateur : il étiquette des plages en texte libre, la cause et comment il l'a sue (`labeling/manual/<STATION>.jsonl`, D-098, D-102). Apprendre, ici, c'est documenter (D-099) : l'agent `analyste` mesure dans les données ce que disent les étiquettes d'un même phénomène et pose ses questions à l'expert ; quand il a compris, il écrit ses conclusions ; l'agent `documentaliste` les fait entrer dans la documentation. Tu es l'orchestrateur : tu choisis les étiquettes avec l'utilisateur, relaies les questions et les réponses, lances le documentaliste et commites. **Tu ne juges ni les conclusions ni la documentation toi-même.**
## 1. Les étiquettes du phénomène
Lis `labeling/manual/*.jsonl` (une ligne par étiquette : `debut`, `fin`, `description`) et retiens celles qui parlent du phénomène demandé (« $ARGUMENTS ») ; sans argument, demande-le. Annonce la liste, une ligne chacune (station, début, fin, dix mots de la description), et fais-la confirmer ou corriger par l'utilisateur (AskUserQuestion : « Ces étiquettes ? », Oui / J'en change). Au plus 5 : au-delà, garde les plus variées (stations différentes d'abord) et dis lesquelles restent pour une autre fois.
Le dossier de la leçon : `labeling/lecons/<AAAA-MM-JJ>_<phénomène en minuscules, tirets>/`. Écris-y `etiquettes.jsonl`, les lignes retenues telles quelles, avec un champ `station` en plus.
## 2. L'analyste mesure
L'outil Agent, `subagent_type: analyste`, prompt :
`Leçon des étiquettes de l'expert (/labels-learner, D-099), pas un lot de la boucle. Tes consignes : .claude/skills/labels-learner/analyste.md. Phénomène : <phénomène>. Étiquettes : <dossier de la leçon>/etiquettes.jsonl. Dossier de sortie : <dossier de la leçon>.`
Attends sa notification ; garde son identifiant. Il a écrit `<dossier de la leçon>/lecon.md` : ce qu'il a mesuré, puis ses questions (section 3). Ne recopie pas la leçon dans la conversation : dis en une ligne qu'elle est écrite (son chemin).
## 3. Les questions, jusqu'à ce qu'il ait compris
Tant que la section 3 de `lecon.md` a des questions sans réponse :
1. Pose-les à l'utilisateur, en texte, numérotées, telles que l'analyste les a écrites, chacune avec l'étiquette qu'elle cite ; il répond dans la conversation (« je ne sais pas » est une réponse).
2. Écris ses réponses, ses mots tels quels, sous chaque question dans `lecon.md` (`Réponse de l'expert : …`).
3. Envoie à l'analyste (SendMessage, son identifiant ; à défaut, un nouvel agent `analyste` avec le prompt de l'étape 2 suivi de « Reprise : les réponses sont dans lecon.md ») : `Réponses de l'expert écrites sous tes questions, dans lecon.md. Reprends tes consignes à l'étape 4.` Attends sa notification : de nouvelles questions, ou ses conclusions.
Au plus trois tours ; au-delà, dis-le à l'utilisateur et demande s'il faut continuer.
## 4. Le documentaliste
Quand la section 4 de `lecon.md` (« Conclusions ») est écrite : l'outil Agent, `subagent_type: documentaliste`, prompt : `Conclusions de l'analyste après les réponses de l'expert (/labels-learner, D-099) : <dossier de la leçon>/lecon.md, section 4 ; les réponses de l'expert sont sous les questions de la section 3.` Attends sa notification.
## 5. Fin
Relaie la section « Documentation » de `lecon.md` (une ligne par conclusion : où elle est entrée, ou pourquoi pas) et `git diff --stat`. Demande à l'utilisateur (AskUserQuestion, « La documentation te va ? ») : **Commiter** (par chemin : le dossier de la leçon et les fichiers que le documentaliste a modifiés, message `Labels lesson: <phénomène>` ; rien d'autre de l'arbre), **Corriger** (ses mots au documentaliste, SendMessage, puis la question à nouveau), ou **Plus tard** (rien n'est commité).
Puis les difficultés que l'analyste et le documentaliste ont remontées (`## Difficultés` et `## Difficultés du documentaliste` de `lecon.md`) : l'agent `releveur` (D-060), s'il y en a.
## Règles
- Ni détecteurs, ni base d'events ici : une étiquette marquante, propose `/new-event` en fin ; un détecteur à changer, une ligne pour `/events-learner`.
- Les étiquettes ne se modifient pas ici : elles sont à l'utilisateur (`labeling.py`).