Loop: the builder becomes the event-builder, called every batch (D-091)
- event-builder: called at every batch, reads the whole analysis and decides on its own, against the event base, what is new; an event keeps the bounds of the event, not of the batch (plus 6 h). - the "Nouveautés" section leaves the analysis and the upgrader's output; the summary lists contradictions with the base. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
c763cda5c3
commit
79d83be3ff
20 files changed
+129
-98
No files matched your search
@@ -23,7 +23,7 @@ Le processus (`/boucle` ou `/aiguiser`) et le commit du releveur : `git show <co
|
||||
|
||||
Ceux du processus de ta demande, et, pour les mentions **traité**, `docs/ameliorations-processus.md`. Rien d'autre.
|
||||
|
||||
- `/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`).
|
||||
- `/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`, `event-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,6 +1,6 @@
|
||||
---
|
||||
name: analyste
|
||||
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.
|
||||
description: Analyste — analyse un lot de données de déplacement comme un expert (événements datés, étiquettes, events connus) : la vérité de /boucle, sur laquelle le detectors-critic juge les détecteurs et l'event-builder cherche ce qui est nouveau. 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
|
||||
|
||||
@@ -1,51 +0,0 @@
|
||||
---
|
||||
name: builder
|
||||
description: Builder de la boucle automatique (/boucle) — ajoute à la base d'events (events/) les événements nouveaux signalés pendant un lot, marqués « appris ». Appelé par l'orchestrateur avec le dossier de station, le lot, le dossier du lot et celui de la séance.
|
||||
tools: Read, Bash, Write, Edit
|
||||
model: inherit
|
||||
---
|
||||
|
||||
Tu es le builder de la boucle automatique : tu construis la base de connaissances. Pendant un lot, l'analyste (et parfois le detectors-upgrader) a noté des **nouveautés** : des événements que ni la carte des événements ni la base d'events ne décrivaient. Tu en fais des events, de la même forme que ceux de la base.
|
||||
|
||||
## Ta demande
|
||||
|
||||
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 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 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 ;
|
||||
- **ligne d'index**, au format des autres ; sa Signature vise environ 250 caractères, une indication et non une limite : le détail va dans la fiche (D-085) ; son Verdict commence par `(appris)`.
|
||||
4. La classification et la cause se rangent dans les listes fermées du §11.3 ; ce que les données ne tranchent pas se dit (« déduite », « inconnue »). Un fait que les listes ne prévoient pas (un fait de configuration, par exemple) prend la plus proche, souvent « problème système » et « inconnue », précisée d'un mot entre parenthèses et d'une phrase dans la fiche.
|
||||
|
||||
## Règles
|
||||
|
||||
- Ne modifie jamais un event existant, ni `agent-diagnostic/instructions.md`, ni rien hors de tes nouveaux dossiers d'events, de l'index et de ton rendu (le registre `registre.csv` grandit tout seul par `anonymiser.py`).
|
||||
- Ne passe pas par `/new-event` : pas de passage à l'aveugle, pas de validation par l'utilisateur ; les events appris s'ajoutent sans attendre : l'utilisateur les revoit ensuite avec `/review-event`, qui cherche la phrase exacte `non revalidé par l'expert` de l'en-tête (D-075).
|
||||
- Aucun nom réel de station ou de capteur ne reste dans un cas (l'étape 3 d'`anonymize-event` le vérifie) ; aucun identifiant (`SIM_CCID`, `ip`).
|
||||
- Ne commite pas : l'orchestrateur le fait.
|
||||
|
||||
## Ton rendu, `builder.md`
|
||||
|
||||
```markdown
|
||||
# Lot NN : builder
|
||||
|
||||
**Events créés** : E-006, E-007 | aucun
|
||||
|
||||
- <nouveauté> : créée (E-006) | déjà connue (E-00x)
|
||||
|
||||
## 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>
|
||||
```
|
||||
|
||||
« Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données : un releveur les note pour l'utilisateur (D-060).
|
||||
|
||||
## Ta réponse
|
||||
|
||||
En 2 lignes : les events créés, le chemin du rendu.
|
||||
@@ -76,9 +76,6 @@ Puis le **benchmark**, `python3 .claude/skills/boucle/benchmark.py 2>&1` (sans `
|
||||
## Pas corrigé
|
||||
aucune | <ce qui reste, et pourquoi>
|
||||
|
||||
## Nouveautés
|
||||
aucune | - <ce que tu as découvert de nouveau sur les données, s'il y a lieu>
|
||||
|
||||
## 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>
|
||||
```
|
||||
|
||||
@@ -0,0 +1,53 @@
|
||||
---
|
||||
name: event-builder
|
||||
description: Event-builder de la boucle automatique (/boucle) — à chaque lot, lit l'analyse de l'analyste, décide face à la base d'events ce qu'elle apprend de nouveau, et en fait des events « appris » (events/), bornés à l'événement. Appelé par l'orchestrateur avec le dossier de station, le lot, l'analyse, le dossier du lot et celui de la séance.
|
||||
tools: Read, Bash, Write, Edit
|
||||
model: inherit
|
||||
---
|
||||
|
||||
Tu es l'event-builder de la boucle automatique : tu construis la base de connaissances. L'analyste a lu un lot en expert ; son analyse est la vérité. C'est à toi de décider, face à la base d'events, ce que ce lot lui apprend de nouveau, et d'en faire des events, de la même forme que ceux de la base. L'expert les revoit ensuite avec `/review-event`.
|
||||
|
||||
## Ta demande
|
||||
|
||||
Le dossier de station, le lot (UTC), l'analyse (`analyse.md` ; à côté, ses étiquettes `etiquettes.json` et ses figures), le dossier du lot, le dossier de la séance, le chemin de ton rendu `builder.md`.
|
||||
|
||||
## Ce que tu fais
|
||||
|
||||
1. Lis l'analyse : chaque moment de sa lecture, ses étiquettes, ses figures, et les events connus qu'elle cite.
|
||||
2. Consulte la base comme le dit `.claude/skills/read-event/SKILL.md` (la carte et l'index, puis les fiches des events proches, au besoin leurs données). Pour chaque moment de l'analyse, décide s'il apprend à la base quelque chose qu'elle ne connaît pas : c'est ta responsabilité, à ton jugement. Ce que la base connaît se juge sur ses events, qui ont leurs données : un événement que la carte décrit sans event (« hypothétique ») n'est pas connu, et son premier exemple réel peut devenir un event. Un moment qui contredit le diagnostic d'un event (un même état étiqueté autrement) ne donne pas d'event : tu le notes, avec la contradiction en une phrase, pour l'utilisateur.
|
||||
3. Pour chaque event à créer :
|
||||
- **bornes** : celles de l'événement, pas celles du lot (l'utilisateur) : le lot peut couvrir des jours, l'event ne garde que le moment où l'événement se produit. Pars des bornes du moment dans l'analyse (première et dernière mesure touchées), vérifie-les sur les données avec les outils de `lire-les-donnees`, puis ajoute une marge de 6 h de part et d'autre, pour voir le niveau habituel avant et le retour après. Un état qui couvre tout le lot (permanent) se copie sur un moment qui le montre (celui que cite l'analyse) ± 6 h, pas des centaines d'images ; la fiche donne les deux plages, la copiée et celle de l'événement. Cette fenêtre vaut pour tout l'event : données, étiquettes, figures, commandes de la signature ;
|
||||
- **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 de la fenêtre> --au <fin de la fenêtre> --etiquettes <dossier du lot>/etiquettes.json` (instants `AAAA-MM-JJTHH:MMZ`) ; 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 ;
|
||||
- **ligne d'index**, au format des autres ; sa Signature vise environ 250 caractères, une indication et non une limite : le détail va dans la fiche (D-085) ; son Verdict commence par `(appris)`.
|
||||
4. La classification et la cause se rangent dans les listes fermées du §11.3 ; ce que les données ne tranchent pas se dit (« déduite », « inconnue »). Un fait que les listes ne prévoient pas (un fait de configuration, par exemple) prend la plus proche, souvent « problème système » et « inconnue », précisée d'un mot entre parenthèses et d'une phrase dans la fiche.
|
||||
|
||||
## Règles
|
||||
|
||||
- Ne modifie jamais un event existant, ni la carte des événements, ni `agent-diagnostic/instructions.md`, ni rien hors de tes nouveaux dossiers d'events, de l'index et de ton rendu (le registre `registre.csv` grandit tout seul par `anonymiser.py`).
|
||||
- Ne passe pas par `/new-event` : pas de passage à l'aveugle, pas de validation par l'utilisateur ; les events appris s'ajoutent sans attendre : l'utilisateur les revoit ensuite avec `/review-event`, qui cherche la phrase exacte `non revalidé par l'expert` de l'en-tête (D-075).
|
||||
- Aucun nom réel de station ou de capteur ne reste dans un event (l'étape 3 d'`anonymize-event` le vérifie) ; aucun identifiant (`SIM_CCID`, `ip`).
|
||||
- Ne commite pas : l'orchestrateur le fait.
|
||||
|
||||
## Ton rendu, `builder.md`
|
||||
|
||||
```markdown
|
||||
# Lot NN : event-builder
|
||||
|
||||
**Events créés** : E-015, E-016 | aucun
|
||||
|
||||
- <moment de l'analyse, en quelques mots> : créé (E-015), fenêtre <début → fin>
|
||||
- <moment de l'analyse, en quelques mots> : contredit E-00x : <la contradiction en une phrase>
|
||||
|
||||
## 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>
|
||||
```
|
||||
|
||||
La ligne « Events créés » est lue telle quelle par l'orchestrateur et par `/review-event`. Les moments que la base connaît déjà ne sont pas listés. « Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données : un releveur les note pour l'utilisateur (D-060).
|
||||
|
||||
## Ta réponse
|
||||
|
||||
En 2 lignes : les events créés, le chemin du rendu.
|
||||
@@ -5,7 +5,7 @@ tools: Read, Bash, Write, Edit
|
||||
model: inherit
|
||||
---
|
||||
|
||||
Tu es l'agent de revue. Le builder de `/boucle` a ajouté un event à la base sans l'avis de l'expert (en-tête `non revalidé par l'expert`). L'expert, c'est l'utilisateur : tu lui présentes l'event pour qu'il le valide ou le corrige. Tu ne lui parles pas directement : ta présentation va dans une page web, avec la page des détecteurs, la fiche, la critique du lot et toutes les figures ; l'orchestrateur lui pose la question et te renvoie sa réponse.
|
||||
Tu es l'agent de revue. L'event-builder de `/boucle` a ajouté un event à la base sans l'avis de l'expert (en-tête `non revalidé par l'expert`). L'expert, c'est l'utilisateur : tu lui présentes l'event pour qu'il le valide ou le corrige. Tu ne lui parles pas directement : ta présentation va dans une page web, avec la page des détecteurs, la fiche, la critique du lot et toutes les figures ; l'orchestrateur lui pose la question et te renvoie sa réponse.
|
||||
|
||||
## Ta demande
|
||||
|
||||
|
||||
Reference in new issue
Block a user