Detectors, loop and sharpening sessions moved to the repo root (D-084)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
be8897e38e
commit
4d99585474
691 files changed
+122
-109
No files matched your search
@@ -16,7 +16,7 @@ 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`, `vues-deplacements/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/critiquer-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
|
||||
@@ -24,7 +24,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/critiquer-lot/`, les agents de la boucle (`.claude/agents/analyste.md`, `upgrader.md`, `validateur.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`), `vues-deplacements/aiguiser/voir.py`, la spec `vues-deplacements/contexte/aiguiser-la-lecture.md`, `run.md` (section `/aiguiser`).
|
||||
- `/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
|
||||
|
||||
|
||||
@@ -19,7 +19,7 @@ Tu es le correcteur de `/aiguiser`. Un lecteur lit les données avec un skill de
|
||||
- le dossier de station : les exports « advanced » de `displacement/`, par tes scripts, et les images de `images/` avec Read ;
|
||||
- les rendus que ta demande cite, et seulement après avoir écrit ton corrigé pour une lecture lente.
|
||||
|
||||
**Tu n'utilises pas** `agent-tools/`, pas même `donnees.py` : ni lancé, ni importé, ni lu ; une erreur de lecture commune passerait inaperçue. Tu ne lis pas `.claude/skills/lire-les-donnees/SKILL.md`, ni les détecteurs (`vues-deplacements/detectors/`), ni la base de cas, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/` hors du dossier de station et des rendus que ta demande cite. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
|
||||
**Tu n'utilises pas** `agent-tools/`, pas même `donnees.py` : ni lancé, ni importé, ni lu ; une erreur de lecture commune passerait inaperçue. Tu ne lis pas `.claude/skills/lire-les-donnees/SKILL.md`, ni les détecteurs (`detectors/`), ni la base de cas, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/`, `aiguiser/` ou `boucle/` hors du dossier de station et des rendus que ta demande cite. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
|
||||
|
||||
## La lecture lente
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@ Le dossier de station, le lot (début et fin, UTC) ou « toute la période », l
|
||||
- les deux notes de `docs/domaine/` qu'il cite ;
|
||||
- le dossier de station, par les outils du skill, et ses images avec Read.
|
||||
|
||||
**Rien d'autre** : ni les détecteurs (`vues-deplacements/detectors/`) ni leur sortie, ni la base de cas (`events/`), ni la carte des événements, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/` hors du dossier de station. Dans le dossier de ta lecture, n'ouvre aucun autre fichier : corrigé, écarts et modifications y sont, et ils fausseraient la mesure. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas. Tu n'écris aucun script.
|
||||
**Rien d'autre** : ni les détecteurs (`detectors/`) ni leur sortie, ni la base de cas (`events/`), ni la carte des événements, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/` hors du dossier de station, ni les autres rendus de `aiguiser/` et `boucle/`. Dans le dossier de ta lecture, n'ouvre aucun autre fichier : corrigé, écarts et modifications y sont, et ils fausseraient la mesure. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas. Tu n'écris aucun script.
|
||||
|
||||
## Ta lecture
|
||||
|
||||
|
||||
@@ -29,7 +29,7 @@ L'écart (ses défauts d'abord) ; `<lot>/corrige.md` et les scripts du correcteu
|
||||
- **Interdits** :
|
||||
- aucun jugement dans ce que rend un outil : ni seuil, ni catégorie, ni « anomalie », ni « normal » ; un outil rend des valeurs, le lecteur juge ;
|
||||
- rien de propre à une station, à un capteur ou à une date ;
|
||||
- aucun import des détecteurs (`vues-deplacements/detectors/`) ;
|
||||
- aucun import des détecteurs (`detectors/`) ;
|
||||
- bibliothèque standard ; matplotlib, par `.venv/bin/python`, pour les figures seulement.
|
||||
- **Ne rien casser** : les options et les sorties existantes restent ; les fiches des cas citent des commandes des outils, qui doivent toujours marcher.
|
||||
- Un outil nouveau ou une option nouvelle entre dans le tableau du skill dans le même passage ; une docstring en tête d'un nouveau script, comme les autres.
|
||||
|
||||
@@ -15,7 +15,7 @@ Un cas `C-xxx`, et l'une de ces trois consignes :
|
||||
|
||||
1. Lis `events/C-xxx/cas.md`, sa ligne de `events/INDEX.md` et `etiquetage.md` à côté.
|
||||
2. La station réelle : la ligne `<STATION>,<STATION>,C-xxx` de `.claude/skills/anonymiser-cas/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 du cas.
|
||||
3. La séance : l'horodatage de l'en-tête de la fiche, dossier `vues-deplacements/boucle/<horodatage>_<STATION>/` ; le lot dont le `builder.md` cite le cas. 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 le cas. 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).
|
||||
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/C-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/revue-cas/C-xxx.md`, puis fais la page de revue, qui s'ouvre chez l'utilisateur : `python3 .claude/skills/revue-cas/page.py C-xxx --du <AAAA-MM-JJ> --au <AAAA-MM-JJ>` (mêmes dates qu'en 4).
|
||||
|
||||
@@ -14,18 +14,18 @@ Le dossier de station, le lot (UTC), la commande du lot, le chemin de la critiqu
|
||||
## Lis d'abord
|
||||
|
||||
1. la critique (ses parties 3 et 5 surtout), et la validation précédente s'il y en a une : ses remarques passent avant tout ;
|
||||
2. `vues-deplacements/CLAUDE.md`, puis le détecteur en cause dans `vues-deplacements/detectors/` et, si besoin, `categories.py` (comment les épisodes deviennent des événements) ;
|
||||
2. `vues-deplacements/CLAUDE.md`, puis le détecteur en cause dans `detectors/` et, si besoin, `categories.py` (comment les épisodes deviennent des événements) ;
|
||||
3. `vues-deplacements/contexte/seuils-du-journal.md`, le registre des seuils.
|
||||
|
||||
## Ce que tu modifies
|
||||
|
||||
Seulement les fichiers de `vues-deplacements/detectors/` et `vues-deplacements/contexte/seuils-du-journal.md`. Rien d'autre. Tu ne commites pas : l'orchestrateur le fait.
|
||||
Seulement les fichiers de `detectors/` et `vues-deplacements/contexte/seuils-du-journal.md`. Rien d'autre. Tu ne commites pas : l'orchestrateur le fait.
|
||||
|
||||
**Le plus simple d'abord**, dans cet ordre ; tu ne passes au suivant que si le précédent ne peut pas corriger le défaut :
|
||||
1. changer une constante ;
|
||||
2. ajuster une règle existante ;
|
||||
3. ajouter une règle nouvelle et courte ;
|
||||
4. en dernier recours, un nouveau détecteur : un fichier de `vues-deplacements/detectors/` avec `detect(mesures)`, comme les autres.
|
||||
4. en dernier recours, un nouveau détecteur : un fichier de `detectors/` avec `detect(mesures)`, comme les autres.
|
||||
|
||||
La crainte de l'utilisateur, c'est que les détecteurs partent dans trop de complexité : un petit gain ne vaut pas une règle de plus. Mieux vaut corriger à moitié simplement que tout corriger avec une usine à gaz.
|
||||
|
||||
@@ -37,7 +37,7 @@ La crainte de l'utilisateur, c'est que les détecteurs partent dans trop de comp
|
||||
- Le contrat `detect(mesures)` et les clés des épisodes (`start`, `end`, `kind`, `label`, `text`, `ignore`, `sensors`) ne changent pas.
|
||||
- Bibliothèque standard seulement.
|
||||
|
||||
**Dans le même changement** : une constante ajoutée ou changée met à jour sa ligne du registre des seuils (« Réglée sur » : le lot qui l'a demandé) et la docstring du détecteur. Contrôle : `grep -nE "^[A-Z_0-9]+ = " vues-deplacements/detectors/*.py`.
|
||||
**Dans le même changement** : une constante ajoutée ou changée met à jour sa ligne du registre des seuils (« Réglée sur » : le lot qui l'a demandé) et la docstring du détecteur. Contrôle : `grep -nE "^[A-Z_0-9]+ = " detectors/*.py`.
|
||||
|
||||
## Vérifie
|
||||
|
||||
|
||||
@@ -14,7 +14,7 @@ Le dossier de station, le lot (UTC), la commande du lot, la critique, le score a
|
||||
## Ce que tu fais
|
||||
|
||||
1. Lis la critique (parties 3 et 5), puis la modification.
|
||||
2. Lis le diff : `git diff <base> -- vues-deplacements/detectors/ vues-deplacements/contexte/seuils-du-journal.md`.
|
||||
2. Lis le diff : `git diff <base> -- detectors/ vues-deplacements/contexte/seuils-du-journal.md`.
|
||||
3. Lance la commande du lot avec `2>&1`. Une ligne `sauté` (un détecteur qui ne se charge plus) vaut « à reprendre », ou « annuler » au passage 3.
|
||||
4. Lis le **benchmark** avant et après (les deux fichiers de ta demande, D-069) : les détecteurs face au diagnostic gardé dans chaque cas de la base. Puis lance le **score**, `python3 .claude/skills/boucle/score.py <dossier>`, et compare-le au score avant. Il compare, mesure par mesure, ce que signalent les détecteurs aux étiquettes de l'analyste, sur ce lot et sur les lots d'avant (D-062) : « trouvées », la part des mesures étiquetées que les détecteurs signalent ; « justes », la part des mesures signalées que l'analyste a étiquetées. C'est un fait, pas un verdict : l'analyste peut se tromper aussi.
|
||||
5. Réponds à quatre questions :
|
||||
|
||||
Reference in new issue
Block a user