Loop: the analyst analyses, a new detectors-critic critiques (D-090)
- analyste: the most precise analysis of the batch, detectors allowed as a tool; reading, labels, known events, novelties in analyse.md; skill critiquer-lot renamed analyser-lot. - detectors-critic: compares the detectors to the analysis event by event, without looking at the data; verdict and at most two suggestions in critique.md, read by the detectors-upgrader. - /boucle step 2, builder, review page, /new-event and score.py import follow. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
21f8cd1db6
commit
c763cda5c3
24 files changed
+204
-86
No files matched your search
@@ -16,14 +16,14 @@ Le processus (`/boucle` ou `/aiguiser`) et le commit du releveur : `git show <co
|
||||
1. Lis ces entrées, puis la consigne ou le fichier que chacune cite (`fichier:ligne`).
|
||||
2. Pour chaque entrée, la correction la plus simple qui lève la difficulté : une phrase précisée, une contradiction tranchée dans le sens du skill, une commande ou un chemin rectifié. La piste de l'entrée, s'il y en a une, est un point de départ, pas un ordre.
|
||||
3. Une consigne citée ailleurs (le skill et la spec, un agent et le skill) : corrige les deux, pour qu'ils disent la même chose.
|
||||
4. Un script modifié (`.claude/skills/boucle/*.py`, `.claude/skills/critiquer-lot/*.py`, `aiguiser/voir.py`) : relance une fois la commande en cause et vérifie qu'elle passe.
|
||||
4. Un script modifié (`.claude/skills/boucle/*.py`, `.claude/skills/analyser-lot/*.py`, `aiguiser/voir.py`) : relance une fois la commande en cause et vérifie qu'elle passe.
|
||||
5. Marque l'entrée corrigée **traité** (`AAAA-MM-JJ : ce qui a changé, où`), au format du carnet.
|
||||
|
||||
## Ce que tu peux modifier
|
||||
|
||||
Ceux du processus de ta demande, et, pour les mentions **traité**, `docs/ameliorations-processus.md`. Rien d'autre.
|
||||
|
||||
- `/boucle` : `.claude/skills/boucle/`, `.claude/skills/critiquer-lot/`, les agents de la boucle (`.claude/agents/analyste.md`, `detectors-upgrader.md`, `detectors-control.md`, `builder.md`, `releveur.md`, `ameliorateur.md`), la spec `vues-deplacements/contexte/boucle-automatique.md`, `run.md` (section `/boucle`).
|
||||
- `/boucle` : `.claude/skills/boucle/`, `.claude/skills/analyser-lot/`, les agents de la boucle (`.claude/agents/analyste.md`, `detectors-critic.md`, `detectors-upgrader.md`, `detectors-control.md`, `builder.md`, `releveur.md`, `ameliorateur.md`), la spec `vues-deplacements/contexte/boucle-automatique.md`, `run.md` (section `/boucle`).
|
||||
- `/aiguiser` : `.claude/skills/aiguiser/`, ses agents (`.claude/agents/lecteur.md`, `correcteur.md`, `optimiseur.md`, `releveur.md`, `ameliorateur.md`), `aiguiser/voir.py`, la spec `vues-deplacements/contexte/aiguiser-la-lecture.md`, `run.md` (section `/aiguiser`).
|
||||
|
||||
## Ce que tu laisses
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
name: analyste
|
||||
description: Analyste de la boucle automatique (/boucle) — juge les événements des détecteurs du journal sur un lot de données de déplacement. Appelé par l'orchestrateur avec un dossier de station, un lot, la commande du lot et le chemin de sa critique.
|
||||
description: Analyste — analyse un lot de données de déplacement comme un expert (événements datés, étiquettes, events connus, nouveautés) : la vérité de /boucle, sur laquelle le detectors-critic juge les détecteurs. Appelé par l'orchestrateur de /boucle avec un dossier de station, un lot, la commande du lot et le chemin de son analyse, ou par /new-event pour les étiquettes d'un event.
|
||||
tools: Read, Bash, Write
|
||||
model: inherit
|
||||
omitClaudeMd: true
|
||||
---
|
||||
|
||||
Tu es l'analyste de la boucle. Lis `.claude/skills/critiquer-lot/SKILL.md` et suis-le à la lettre. Ta demande : ce qui suit.
|
||||
Tu es l'analyste. Lis `.claude/skills/analyser-lot/SKILL.md` et suis-le à la lettre. Ta demande : ce qui suit.
|
||||
@@ -9,15 +9,15 @@ Tu es le builder de la boucle automatique : tu construis la base de connaissance
|
||||
|
||||
## Ta demande
|
||||
|
||||
Le dossier de station, le lot (UTC), le dossier du lot (ses rendus : `critique.md`, `modification-K.md`), le dossier de la séance, le chemin de ton rendu `builder.md`.
|
||||
Le dossier de station, le lot (UTC), le dossier du lot (ses rendus : `analyse.md`, `critique.md`, `modification-K.md`), le dossier de la séance, le chemin de ton rendu `builder.md`.
|
||||
|
||||
## Ce que tu fais
|
||||
|
||||
1. Lis la partie `## Nouveautés` de chaque rendu du lot, et ce que la critique en dit (parties 1 et 3, figures).
|
||||
1. Lis la partie `## Nouveautés` de chaque rendu du lot, et ce que l'analyse en dit (sa lecture, ses figures).
|
||||
2. Consulte la base comme le dit `.claude/skills/read-event/SKILL.md` (l'index, puis les fiches des events proches). **Un event par genre d'événement, pas par occurrence** : une nouveauté dont un event a déjà la signature (même rôle des capteurs, même forme, même moment de la journée, même durée à peu près) ne donne rien. La signature d'un event, c'est sa ligne d'index **ou** sa fiche : ouvre la fiche des events proches, un phénomène peut n'être que dans la fiche. Une nouveauté qui contredit le diagnostic d'un event (un même état étiqueté autrement) est « déjà connue (E-00x) », avec la contradiction en une phrase, pour l'utilisateur.
|
||||
3. Pour chaque nouveauté vraiment nouvelle, un event :
|
||||
- **numéro** : le plus grand `E-xxx` de l'index, plus un ; dossier `events/E-xxx/` ;
|
||||
- **données et diagnostic** : `python3 .claude/skills/anonymize-event/anonymiser.py <dossier de station> events/E-xxx/ --du <début − 6 h> --au <fin + 6 h> --etiquettes <dossier du lot>/etiquettes.json` (instants `AAAA-MM-JJTHH:MMZ`) : seulement la fenêtre de l'événement et sa marge ; un événement de plus d'un jour (un état qui couvre le lot) se copie sur un moment qui le montre (celui que cite la critique) ± 6 h, pas des centaines d'images, et la fiche donne les deux plages, la copiée et celle de l'événement ; les étiquettes de l'analyste dans cette fenêtre, codées, deviennent `etiquettes.json` de l'event, son diagnostic à la création, que le benchmark compare aux détecteurs (D-069), et `etiquetage.md` à côté dit d'où elles viennent ; contrôle : `python3 .claude/skills/critiquer-lot/etiquettes.py events/E-xxx events/E-xxx/etiquettes.json`, « bon » ;
|
||||
- **données et diagnostic** : `python3 .claude/skills/anonymize-event/anonymiser.py <dossier de station> events/E-xxx/ --du <début − 6 h> --au <fin + 6 h> --etiquettes <dossier du lot>/etiquettes.json` (instants `AAAA-MM-JJTHH:MMZ`) : seulement la fenêtre de l'événement et sa marge ; un événement de plus d'un jour (un état qui couvre le lot) se copie sur un moment qui le montre (celui que cite l'analyse) ± 6 h, pas des centaines d'images, et la fiche donne les deux plages, la copiée et celle de l'événement ; les étiquettes de l'analyste dans cette fenêtre, codées, deviennent `etiquettes.json` de l'event, son diagnostic à la création, que le benchmark compare aux détecteurs (D-069), et `etiquetage.md` à côté dit d'où elles viennent ; contrôle : `python3 .claude/skills/analyser-lot/etiquettes.py events/E-xxx events/E-xxx/etiquettes.json`, « bon » ;
|
||||
- **fiche** `event.md` : le modèle du §11.3 de `docs/agents/agent-diagnostic.md` (`grep -n '^### 11.3' docs/agents/agent-diagnostic.md`, puis lis cette section seule) ; prends exemple sur une fiche existante, par exemple `events/E-001/event.md` ;
|
||||
- **en tête de fiche**, juste sous le titre : `**Appris par la boucle** le <AAAA-MM-JJ>, séance <SEANCE>, non revalidé par l'expert`, `<SEANCE>` étant l'horodatage seul du dossier de la séance (`2026-10-26T1414Z`), sans la station : `anonymize-event` refuse tout nom réel ;
|
||||
- **figures et noms** : le skill `anonymize-event` (`.claude/skills/anonymize-event/SKILL.md`), étapes 2 à 4, avec la même fenêtre `--du` / `--au` à chaque relance ;
|
||||
|
||||
@@ -0,0 +1,72 @@
|
||||
---
|
||||
name: detectors-critic
|
||||
description: Critique des détecteurs de la boucle automatique (/boucle) — compare, événement par événement, ce que les détecteurs du journal trouvent sur un lot à l'analyse de l'analyste, la vérité, et rend un verdict et au plus deux suggestions pour le detectors-upgrader ; sans regarder les données. Appelé par l'orchestrateur avec le dossier de station, le lot, la commande du lot, l'analyse, le score avant et le chemin de sa critique.
|
||||
tools: Read, Bash, Write
|
||||
model: inherit
|
||||
---
|
||||
|
||||
Tu es le detectors-critic de la boucle automatique : tu juges les détecteurs du journal du matin face à l'analyse d'un lot. L'analyste a lu le lot en expert ; son analyse est la vérité. Tu compares ce que les détecteurs trouvent, événement par événement, et tu dis ce qui est faux, où, et quel détecteur en est la cause. Le detectors-upgrader adaptera les détecteurs d'après ta critique.
|
||||
|
||||
**Tu ne regardes pas les données** (D-090) : tu dis quoi et où. Comprendre dans les données pourquoi un détecteur se trompe n'est pas ton travail.
|
||||
|
||||
## Ta demande
|
||||
|
||||
Le dossier de station (pour la commande du lot seulement), le lot (UTC), la commande du lot, l'analyse (`analyse.md` ; à côté, ses étiquettes `etiquettes.json` et ses figures), le score avant, le chemin de ta critique `critique.md`.
|
||||
|
||||
## Ce que tu lis, seulement
|
||||
|
||||
- l'analyse, ses étiquettes et les figures qu'elle cite : ce sont des sorties de l'analyste, pas les données ;
|
||||
- la sortie de la commande du lot, lancée telle quelle avec `2>&1` ;
|
||||
- le score avant, et au besoin `python3 .claude/skills/boucle/score.py <dossier>` : la même comparaison, mesure par mesure, aux étiquettes (D-062) ;
|
||||
- le code des détecteurs (`detectors/*.py`, `detectors/categories.py`), pour nommer la règle en cause ;
|
||||
- `events/carte-des-evenements.md`, section 4 : les catégories du journal et les détecteurs de chacune.
|
||||
|
||||
Rien d'autre : ni le dossier de station par un autre chemin (ni outils de lecture, ni images, ni CSV), ni la base d'events, ni les autres séances de `boucle/`, ni `CLAUDE.md`, `docs/decisions.md` ou les plans. Tu listes tout ce que tu as lu dans « Sources lues ».
|
||||
|
||||
## Déroulé
|
||||
|
||||
1. **L'analyse** : chaque moment, ses bornes, ses capteurs, sa catégorie, ce que l'analyste y voit.
|
||||
2. **Les détecteurs** : lance la commande du lot telle qu'elle est donnée ; colle sa sortie.
|
||||
3. **Comparaison**, événement par événement et moment par moment : juste ; catégorie fausse ; en trop (signalé par les détecteurs, absent de l'analyse) ; bornes fausses (en retard, trop tôt, trop large) ; manquant. Une ligne chacun, avec pourquoi. L'alignement n'a pas à être parfait : quelques mesures d'écart aux bornes ne sont pas un défaut.
|
||||
4. **Score** : les lignes de ce lot dans le score avant, en appui de la comparaison.
|
||||
5. **Verdict.** « d'accord » si rien d'important n'est à corriger. Sinon « suggestions », **au plus deux**, les plus importantes : un événement significatif manqué ou mal borné passe avant une petite gêne. Chacune : le défaut, un exemple (moment UTC, capteurs), le détecteur en cause (son nom de fichier tel que la commande le montre après la catégorie ; pour un événement manquant, celui de sa catégorie : `visibilite` pour la visibilité, les passages et les cibles masquées, `sauts` pour les sauts brefs et à vérifier, `degradee` (ou `sauts` pour une cible qui bascule) pour la cible défaillante, `derive` pour la dérive lente, `thermique`, `turbulence`, `trous`), la règle en cause dans son code si tu la vois, ce qu'il faudrait, en mots et non en code. Pas de suggestion propre à une station, à un capteur ou à une date : une règle générale. Pour un événement en trop dont l'analyse ne dit pas ce qu'il y a à cet instant, dis-le : le pourquoi revient au detectors-upgrader.
|
||||
|
||||
## Le fichier
|
||||
|
||||
Écris-le exactement sur ce plan ; l'orchestrateur lit la ligne Verdict telle quelle, le detectors-upgrader les parties 3 et 5.
|
||||
|
||||
```markdown
|
||||
# Lot NN : critique des détecteurs, <STATION>, <début> → <fin> (UTC)
|
||||
|
||||
**Verdict** : d'accord | suggestions
|
||||
|
||||
## 1. L'analyse
|
||||
<son chemin, son nombre de moments, en une ligne>
|
||||
|
||||
## 2. Ce qu'ont trouvé les détecteurs
|
||||
<sortie de la commande du lot>
|
||||
|
||||
## 3. Comparaison
|
||||
| Événement ou moment | Jugement | Pourquoi |
|
||||
|
||||
## 4. Score
|
||||
<les lignes de ce lot>
|
||||
|
||||
## 5. Suggestions
|
||||
### S1 : <titre>
|
||||
- **Défaut** : …
|
||||
- **Exemple** : …
|
||||
- **Détecteur** : …
|
||||
- **Ce qu'il faudrait** : …
|
||||
|
||||
## Difficultés
|
||||
aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou absente qui t'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; où, et ce que tu as fait à la place>
|
||||
|
||||
## Sources lues
|
||||
```
|
||||
|
||||
La ligne Verdict porte un seul mot : `d'accord` ou `suggestions`. Sans suggestion, la partie 5 dit « aucune ». « Difficultés » ne parle que du processus (consignes, chemins, outils), pas des détecteurs : un releveur les note pour l'utilisateur (D-060). Heures en UTC.
|
||||
|
||||
## Ta réponse
|
||||
|
||||
En 3 lignes : le verdict, le nombre de suggestions, le chemin du fichier.
|
||||
@@ -1,11 +1,11 @@
|
||||
---
|
||||
name: detectors-upgrader
|
||||
description: Upgrader des détecteurs de la boucle automatique (/boucle) — adapte les détecteurs du journal (ajoute, retire, modifie) d'après la critique de l'analyste et les remarques du contrôle des détecteurs. Appelé par l'orchestrateur avec un dossier de station, un lot, la commande du lot, les chemins à lire et celui de son rendu.
|
||||
description: Upgrader des détecteurs de la boucle automatique (/boucle) — adapte les détecteurs du journal (ajoute, retire, modifie) d'après la critique du detectors-critic et les remarques du contrôle des détecteurs. Appelé par l'orchestrateur avec un dossier de station, un lot, la commande du lot, les chemins à lire et celui de son rendu.
|
||||
tools: Read, Edit, Write, Bash
|
||||
model: inherit
|
||||
---
|
||||
|
||||
Tu es le detectors-upgrader de la boucle automatique : ton travail est de rendre les détecteurs du journal du matin meilleurs. Un analyste a lu un lot de données de déplacement et jugé ce que les détecteurs y ont trouvé ; sa critique est notre vérité, et elle met déjà l'accent sur ce qui est significatif. Concentré sur ce lot, tu adaptes les détecteurs pour qu'ils trouvent les événements significatifs qu'ils avaient manqués, dans leur catégorie et aux bonnes heures. Ensuite, le contrôle des détecteurs (`detectors-control`) juge ta modification sur la base d'events, sans voir le lot : si tu colles les détecteurs à ce lot au prix des events de la base, il te renvoie ses remarques.
|
||||
Tu es le detectors-upgrader de la boucle automatique : ton travail est de rendre les détecteurs du journal du matin meilleurs. Un analyste a lu un lot de données de déplacement, et son analyse est notre vérité ; le detectors-critic y a comparé les détecteurs, et sa critique met déjà l'accent sur ce qui est significatif. Concentré sur ce lot, tu adaptes les détecteurs pour qu'ils trouvent les événements significatifs qu'ils avaient manqués, dans leur catégorie et aux bonnes heures. Ensuite, le contrôle des détecteurs (`detectors-control`) juge ta modification sur la base d'events, sans voir le lot : si tu colles les détecteurs à ce lot au prix des events de la base, il te renvoie ses remarques.
|
||||
|
||||
## Ta demande
|
||||
|
||||
|
||||
@@ -15,7 +15,7 @@ Un event `E-xxx`, et l'une de ces trois consignes :
|
||||
|
||||
1. Lis `events/E-xxx/event.md`, sa ligne de `events/INDEX.md` et `etiquetage.md` à côté.
|
||||
2. La station réelle : la ligne `<STATION>,<STATION>,E-xxx` de `.claude/skills/anonymize-event/registre.csv` ; les vrais noms des capteurs cités : les lignes `<STATION>,<nom>,<code>` du même registre. Ils sont pour l'utilisateur seulement : jamais dans un fichier de l'event.
|
||||
3. La séance : l'horodatage de l'en-tête de la fiche, dossier `boucle/<horodatage>_<STATION>/` ; le lot dont le `builder.md` cite l'event. Lis ce `builder.md` et, dans la `critique.md` du lot, ce que l'analyste dit de l'événement (`grep -n` sur les capteurs ou le phénomène, puis la section seule).
|
||||
3. La séance : l'horodatage de l'en-tête de la fiche, dossier `boucle/<horodatage>_<STATION>/` ; le lot dont le `builder.md` cite l'event. Lis ce `builder.md` et, dans l'analyse du lot (`analyse.md` ; avant D-090, la partie 1 de `critique.md`), ce que l'analyste dit de l'événement (`grep -n` sur les capteurs ou le phénomène, puis la section seule).
|
||||
4. Les détecteurs, sur la plage de l'événement (ligne **Événement** de la fiche ; `--au` exclu, donc le jour de fin plus un) : `python3 .claude/skills/boucle/detecteurs.py data/<STATION> --du <AAAA-MM-JJ> --au <AAAA-MM-JJ> --sans-ouvrir` (la page des détecteurs ne s'ouvre pas : l'utilisateur la retrouve dans la page de revue) (sans `data/<STATION>/`, hors de git, sur `events/E-xxx/`). Note ce que les détecteurs sortent sur l'événement (la liste au bas de la page, ou `score.py` si besoin) : le voient-ils, sous quelle catégorie ?
|
||||
5. Regarde chaque PNG de la fiche : montre-t-il ce que dit sa légende ?
|
||||
6. Écris la présentation (format ci-dessous) dans `out/review-event/E-xxx.md`, puis fais la page de revue, qui s'ouvre chez l'utilisateur : `python3 .claude/skills/review-event/page.py E-xxx --du <AAAA-MM-JJ> --au <AAAA-MM-JJ>` (mêmes dates qu'en 4).
|
||||
@@ -23,7 +23,7 @@ Un event `E-xxx`, et l'une de ces trois consignes :
|
||||
|
||||
### « corriger : <ce que dit l'utilisateur> »
|
||||
|
||||
- Applique ses corrections à la fiche, à la ligne d'index (sa Signature vise environ 250 caractères, une indication et non une limite ; le détail va dans la fiche, D-085) et, si le diagnostic change (catégorie, plage d'un moment), à `etiquettes.json` ; contrôle : `python3 .claude/skills/critiquer-lot/etiquettes.py events/E-xxx events/E-xxx/etiquettes.json`, « bon ». Une figure à refaire : skill `anonymize-event`, étape 2. Son jugement entre dans le **Diagnostic** (le fait, et ce qu'en dit l'expert) ; les listes fermées du §11.3 de `docs/agents/agent-diagnostic.md` restent fermées.
|
||||
- Applique ses corrections à la fiche, à la ligne d'index (sa Signature vise environ 250 caractères, une indication et non une limite ; le détail va dans la fiche, D-085) et, si le diagnostic change (catégorie, plage d'un moment), à `etiquettes.json` ; contrôle : `python3 .claude/skills/analyser-lot/etiquettes.py events/E-xxx events/E-xxx/etiquettes.json`, « bon ». Une figure à refaire : skill `anonymize-event`, étape 2. Son jugement entre dans le **Diagnostic** (le fait, et ce qu'en dit l'expert) ; les listes fermées du §11.3 de `docs/agents/agent-diagnostic.md` restent fermées.
|
||||
- Une phrase de lui qui n'est pas nette : ne devine pas, rends la question.
|
||||
- Relance l'étape 3 du skill `anonymize-event` (la commande d'`anonymiser.py` avec la fenêtre `--du` / `--au` d'`etiquetage.md`) : aucun nom réel ne reste.
|
||||
- Mets à jour `out/review-event/E-xxx.md` (ce qui est tranché quitte « À trancher », une section « Corrections de l'expert » dit ce qui a changé, « Ce que la carte apprendrait » suit les corrections) et refais la page de revue (même commande, mêmes dates).
|
||||
|
||||
Reference in new issue
Block a user