Code station and sensor names in the diagnostic case base (D-049)
Add the anonymiser-cas skill: a growing registry gives stable codes (S01, R1, C1), a stdlib script rewrites a case and renames its files, and graphique.py / vignettes.py take --alias to plot with codes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
3478d77f1d
commit
a684349501
15 files changed
+203
-30
No files matched your search
@@ -0,0 +1,26 @@
|
||||
---
|
||||
name: anonymiser-cas
|
||||
description: À utiliser quand une fiche ou une figure de la base de cas de l'agent de diagnostic (agents/diagnostic/cas/) porte un nom réel de station, de référence ou de cible — à l'étape 5 de /nouveau-cas, avant de montrer la fiche, ou sur un cas déjà entré.
|
||||
argument-hint: "data/<STATION>/ agents/diagnostic/cas/<dossier du cas>/"
|
||||
---
|
||||
|
||||
# Anonymiser un cas
|
||||
|
||||
L'agent lit la base de cas. Un nom de site ou de capteur l'ancrerait sur le nom plutôt que sur la signature (D-049). Tous les noms deviennent donc des codes stables : `S01` pour une station, `R1` pour une référence, `C1` pour une cible, numérotés par station. Le registre `registre.csv`, à côté de ce fichier, garde les correspondances d'un cas à l'autre.
|
||||
|
||||
1. **Codes** : `python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ --alias` imprime `NOM=CODE,...`. Un nom inconnu reçoit le code suivant et entre dans le registre.
|
||||
2. **Figures** : le script ne peut pas réécrire le texte d'un PNG. Fais chaque figure du cas avec sa commande (`graphique.py`, `vignettes.py`), `--sortie <dossier du cas>` et `--alias "<sortie de l'étape 1>"`. Dans la fiche, cite le fichier qu'elle imprime, déjà codé. Supprime les PNG aux noms réels.
|
||||
3. **Textes et noms de fichiers** : `python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ agents/diagnostic/cas/<dossier du cas>/` :
|
||||
- réécrit les `.md` du cas et `cas/INDEX.md` ;
|
||||
- renomme les fichiers et le dossier (`C-xxx_S01_<date>`) ;
|
||||
- s'arrête en listant tout nom réel qui reste (souvent une casse différente) : corrige à la main, puis relance.
|
||||
4. **Regarde chaque PNG** : des codes dans le titre, la légende et les vignettes, aucun nom réel.
|
||||
|
||||
## Règles
|
||||
|
||||
- Le registre ne fait que grandir : ne renumérote rien et ne supprime aucune ligne. Commite-le avec le cas.
|
||||
- Le registre ne va jamais à l'agent : ni dans ses sources, ni dans un prompt, ni dans une fiche.
|
||||
- Les commandes de la fiche portent les codes (`data/S01/`, `--capteurs R3,R2`). Pour les rejouer, prends les noms dans le registre.
|
||||
- Un chemin vers `rapports/`, qui garde les vrais noms, devient codé. Son préfixe horodaté suffit pour le retrouver : `ls agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_*`.
|
||||
- Les images montrent le site lui-même : ce qu'elles laissent voir ne s'anonymise pas.
|
||||
- Vérifier le script après l'avoir modifié : `python3 .claude/skills/anonymiser-cas/anonymiser.py --test`.
|
||||
@@ -0,0 +1,112 @@
|
||||
"""Anonymise un cas de la base de l'agent de diagnostic : la station et ses capteurs deviennent des codes stables.
|
||||
|
||||
Usage :
|
||||
python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ agents/diagnostic/cas/<dossier du cas>/
|
||||
réécrit les .md du cas et cas/INDEX.md, renomme fichiers et dossier ; échoue s'il reste un nom réel
|
||||
python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ --alias
|
||||
imprime NOM=CODE,... pour l'option --alias de graphique.py et vignettes.py
|
||||
python3 .claude/skills/anonymiser-cas/anonymiser.py --test
|
||||
Codes : S01, S02... pour les stations ; R1, R2... pour les références et C1, C2... pour les cibles, par station.
|
||||
Le registre (registre.csv, à côté) ne fait que grandir : un nom garde son code d'un cas à l'autre.
|
||||
"""
|
||||
import csv
|
||||
import os
|
||||
import re
|
||||
import sys
|
||||
|
||||
ICI = os.path.dirname(os.path.abspath(__file__))
|
||||
RACINE = os.path.normpath(os.path.join(ICI, "..", "..", ".."))
|
||||
REGISTRE = os.path.join(ICI, "registre.csv")
|
||||
INDEX = os.path.join(RACINE, "agents", "diagnostic", "cas", "INDEX.md")
|
||||
sys.path.insert(0, os.path.join(RACINE, "agents", "diagnostic", "outils"))
|
||||
from donnees import charger, est_reference # noqa: E402
|
||||
|
||||
|
||||
def codes(dossier):
|
||||
"""{nom: code} de la station et de ses capteurs ; un nom inconnu reçoit le code suivant, ajouté au registre."""
|
||||
station = os.path.basename(os.path.normpath(dossier))
|
||||
par = charger(dossier)
|
||||
if not par:
|
||||
sys.exit(f"Aucun export « advanced » dans {dossier}.")
|
||||
lignes = list(csv.DictReader(open(REGISTRE, newline=""))) if os.path.exists(REGISTRE) else []
|
||||
connus = {(l["station"], l["nom"]): l["code"] for l in lignes}
|
||||
nouveaux = []
|
||||
if (station, station) not in connus:
|
||||
n = max((int(c[1:]) for (s, nom), c in connus.items() if s == nom), default=0)
|
||||
nouveaux.append((station, station, f"S{n + 1:02d}"))
|
||||
for prefixe, reference in (("R", True), ("C", False)):
|
||||
n = max((int(c[1:]) for (s, nom), c in connus.items() if s == station != nom and c[0] == prefixe), default=0)
|
||||
for nom in sorted(x for x in par if est_reference(par[x]) == reference and (station, x) not in connus):
|
||||
n += 1
|
||||
nouveaux.append((station, nom, f"{prefixe}{n}"))
|
||||
if nouveaux:
|
||||
with open(REGISTRE, "a", newline="") as f:
|
||||
w = csv.writer(f)
|
||||
if not lignes:
|
||||
w.writerow(("station", "nom", "code"))
|
||||
w.writerows(nouveaux)
|
||||
connus.update({(s, nom): c for s, nom, c in nouveaux})
|
||||
return station, {nom: c for (s, nom), c in connus.items() if s == station}
|
||||
|
||||
|
||||
def motif(table, station, casse=False):
|
||||
"""Les noms, du plus long au plus court, bornés par un caractère non alphanumérique (« _ » compris : un nom
|
||||
collé dans un nom de fichier est trouvé, mais BJ_C ne l'est pas dans PBJ_C). La station accepte espace ou « _ »
|
||||
et toute casse (PS_DES_COUDRES, « PS des Coudres »)."""
|
||||
parties = []
|
||||
for nom in sorted(table, key=len, reverse=True):
|
||||
p = re.escape(nom)
|
||||
parties.append(f"(?i:{p.replace('_', '[ _]')})" if nom == station else p)
|
||||
return re.compile(("(?i)" if casse else "") + r"(?<![A-Za-z0-9])(" + "|".join(parties) + r")(?![A-Za-z0-9])")
|
||||
|
||||
|
||||
def remplacer(texte, table, station):
|
||||
return motif(table, station).sub(lambda m: table.get(m.group(1), table[station]), texte)
|
||||
|
||||
|
||||
def anonymiser(dossier, cas):
|
||||
station, table = codes(dossier)
|
||||
textes = [os.path.join(r, f) for r, _, fs in os.walk(cas) for f in fs if f.endswith(".md")] + [INDEX]
|
||||
for p in textes:
|
||||
avant = open(p).read()
|
||||
apres = remplacer(avant, table, station)
|
||||
if apres != avant:
|
||||
open(p, "w").write(apres)
|
||||
for r, dossiers, fichiers in os.walk(cas, topdown=False):
|
||||
for f in fichiers + dossiers:
|
||||
if remplacer(f, table, station) != f:
|
||||
os.rename(os.path.join(r, f), os.path.join(r, remplacer(f, table, station)))
|
||||
parent, nom = os.path.split(os.path.normpath(cas))
|
||||
cas = os.path.join(parent, remplacer(nom, table, station))
|
||||
os.rename(os.path.join(parent, nom), cas)
|
||||
|
||||
reste = motif(table, station, casse=True)
|
||||
textes = [os.path.join(r, f) for r, _, fs in os.walk(cas) for f in fs if f.endswith(".md")] + [INDEX]
|
||||
residus = [f"{p} : {m.group(1)}" for p in textes for m in reste.finditer(open(p).read())]
|
||||
residus += [os.path.join(r, f) for r, ds, fs in os.walk(cas) for f in fs + ds if reste.search(f)]
|
||||
if residus:
|
||||
sys.exit("Noms réels restants (casse différente ?) :\n " + "\n ".join(residus))
|
||||
print(cas)
|
||||
print(", ".join(f"{n} → {c}" for n, c in sorted(table.items(), key=lambda x: x[1])))
|
||||
|
||||
|
||||
def _test():
|
||||
t = {"PS_DES_COUDRES": "S01", "BJ_C": "C1", "PBJ_C": "C7", "REF_G": "R3"}
|
||||
f = lambda s: remplacer(s, t, "PS_DES_COUDRES") # noqa: E731
|
||||
assert f("PBJ_C et BJ_C") == "C7 et C1"
|
||||
assert f("PS_DES_COUDRES_error_value_REF_G-BJ_C.png") == "S01_error_value_R3-C1.png"
|
||||
assert f("PS des Coudres, REF_GX, data/PS_DES_COUDRES/") == "S01, REF_GX, data/S01/"
|
||||
print("ok")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
a = sys.argv[1:]
|
||||
if a == ["--test"]:
|
||||
_test()
|
||||
elif len(a) == 2 and a[1] == "--alias":
|
||||
_, table = codes(a[0])
|
||||
print(",".join(f"{n}={c}" for n, c in sorted(table.items())))
|
||||
elif len(a) == 2:
|
||||
anonymiser(*a)
|
||||
else:
|
||||
sys.exit(__doc__)
|
||||
@@ -0,0 +1,17 @@
|
||||
station,nom,code
|
||||
PS_DES_COUDRES,PS_DES_COUDRES,S01
|
||||
PS_DES_COUDRES,REF_CT,R1
|
||||
PS_DES_COUDRES,REF_D,R2
|
||||
PS_DES_COUDRES,REF_G,R3
|
||||
PS_DES_COUDRES,BJ_C,C1
|
||||
PS_DES_COUDRES,BJ_D,C2
|
||||
PS_DES_COUDRES,BJ_G,C3
|
||||
PS_DES_COUDRES,BL_C,C4
|
||||
PS_DES_COUDRES,BL_D,C5
|
||||
PS_DES_COUDRES,BL_G,C6
|
||||
PS_DES_COUDRES,PBJ_C,C7
|
||||
PS_DES_COUDRES,PBL_C,C8
|
||||
PS_DES_COUDRES,PBL_D,C9
|
||||
PS_DES_COUDRES,PM_C,C10
|
||||
PS_DES_COUDRES,PM_D,C11
|
||||
PS_DES_COUDRES,PM_G,C12
|
||||
|
@@ -44,18 +44,19 @@ Le sous-agent reçoit la branche et les derniers messages de commit (§7 de la s
|
||||
|
||||
- **Numéro** : le plus grand `C-xxx` de `agents/diagnostic/cas/INDEX.md`, plus un (C-001 si l'index est vide). Dossier : `agents/diagnostic/cas/C-xxx_<STATION>_<AAAA-MM-JJ du début>/`, `<STATION>` étant le nom du dossier de `data/`.
|
||||
- **`cas.md`** suit le modèle du §11.3 de la spec (`grep -n '^### 11.3' docs/agents/agent-diagnostic.md`, puis lis cette section seule) :
|
||||
- **Signature** et **Exclusions** : tirées des faits et des commandes du rapport à l'aveugle. Les critères sont observables, relatifs au niveau habituel du capteur (MAD), sans nom de capteur ni seuil absolu ; leurs commandes gardent les vrais noms, pour se rejouer. Chaque exclusion se vérifie avec les outils ;
|
||||
- **Signature** et **Exclusions** : tirées des faits et des commandes du rapport à l'aveugle. Les critères sont observables, relatifs au niveau habituel du capteur (MAD), sans nom de capteur ni seuil absolu ; leurs commandes s'écrivent avec les vrais noms, pour se rejouer ; l'anonymisation les code ensuite. Chaque exclusion se vérifie avec les outils ;
|
||||
- **Diagnostic de l'expert** : avec ses mots ; la cause est aussi rapportée à la liste fermée du rapport (buée ou eau, occlusion, turbulence, éclairage, inconnue) ;
|
||||
- **Attendu de l'agent** : ce qu'il doit dire sur ces données sans ce cas dans l'index (le passage à l'aveugle), puis avec ;
|
||||
- **Preuves** : copie les PNG du rapport à côté de `cas.md` et regarde chacun ;
|
||||
- **Preuves** : refais les figures du rapport avec leurs commandes, dans le dossier du cas et avec `--alias` (skill `anonymiser-cas`, étape 2), puis regarde chacune ;
|
||||
- **Test à l'aveugle** : le chemin du rapport et le tableau de 4.3.
|
||||
- **Ligne d'index** : `| [C-xxx](C-xxx_<STATION>_<date>/cas.md) | <Station> · <fenêtre UTC> | <signature courte, observable> | <classification> | <cause de l'expert> | <conséquence, action> |`. Retire « *Base vide pour l'instant.* ».
|
||||
- **Validation du rapport à l'aveugle** : verdict accepté ou corrigé (en quoi) ; diagnostic final, celui de l'expert ; `Devient un cas : oui (C-xxx)`.
|
||||
- **Anonymise** avec le skill `anonymiser-cas` : station et capteurs deviennent des codes (`S01`, `R1`, `C1`), le dossier devient `C-xxx_<code>_<date>` (D-049).
|
||||
- **Montre la fiche et la ligne d'index à l'utilisateur, et attends son accord** : c'est l'expert qui valide un cas, pas Claude.
|
||||
|
||||
## 6. Commit et test de correspondance
|
||||
|
||||
1. Commite par chemin `agents/diagnostic/cas/` et le rapport, avec le message `Add case C-xxx to the diagnostic case base` ; l'arbre est alors propre.
|
||||
1. Commite par chemin `agents/diagnostic/cas/`, le registre `.claude/skills/anonymiser-cas/registre.csv` et le rapport, avec le message `Add case C-xxx to the diagnostic case base` ; l'arbre est alors propre.
|
||||
2. Relance l'agent avec le même prompt (4.2), cette fois avec le cas dans l'index. Attendu : `C-xxx, complète` (ou partielle s'il manque une donnée), et le diagnostic de l'expert ; « aucune » conséquence seulement si la règle d'asymétrie le permet. Ce passage vérifie la mécanique de correspondance, pas le jugement : l'agent a lu la fiche.
|
||||
3. Si le cas ne correspond pas, la signature est trop stricte ou trop vague : corrige la fiche et relance. Consigne le résultat dans « Test à l'aveugle » de la fiche, même s'il réussit du premier coup, puis commite par chemin la fiche et le second rapport (`Record the C-xxx match test`).
|
||||
|
||||
|
||||
@@ -15,12 +15,12 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m
|
||||
- **Maquettes du site (D-022, D-039)** : client « System Summary », une page par station de `data/`, un bloc par domaine mesuré dans la section Diagnostic (Energy, Storage, Cellular, Temperature) ; support « Home » (section Status, une notification par station et par domaine Orange ou Red, lien vers la vue client de la station, D-025).
|
||||
- **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit.
|
||||
- **Séries optiques (D-044)** : détecter les événements externes (occlusion, pluie, turbulence) dans les déplacements et produire une courbe corrigée, la brute gardée ; cadrage (`docs/displacement/cadrage.md`) ; données reçues pour une station (D-045) : PS des Coudres, export 15 min en UTC sur 5,5 jours, sans événement annoté (buée probable le matin), et 24 images horaires de la caméra ; deux rapports d'analyse AIMsight (murs GN-1.472 et GN-5.054), causes des déplacements apparents selon l'expert, sans leurs données ; exploration confiée d'abord à l'agent de diagnostic (D-046), chaîne analytique au second plan.
|
||||
- **Agent de diagnostic (D-046)** : pilote de l'enquête à la demande (D-042) dans Claude Code : sous-agent `diagnostic` (`.claude/agents/diagnostic.md`, dossier `agents/diagnostic/`, spec `docs/agents/agent-diagnostic.md`) ; un dossier de `data/` et une question facultative donnent un rapport court dans `agents/diagnostic/rapports/<date>_<STATION>/` : verdict, anomalies seules, chacune montrée par un graphique et des vignettes des images (D-047) ; déplacements et images seulement ; cas de référence du spécialiste : PS des Coudres est sain, seule anomalie les pics d'erreur de `REF_G` et `REF_D` ; base de cas validés (D-048, `agents/diagnostic/cas/`), lue après les faits, vide : un cas n'y entre que sur demande explicite de l'utilisateur (skill `/nouveau-cas`). L'enquête par API (D-042) reste un document.
|
||||
- **Agent de diagnostic (D-046)** : pilote de l'enquête à la demande (D-042) dans Claude Code : sous-agent `diagnostic` (`.claude/agents/diagnostic.md`, dossier `agents/diagnostic/`, spec `docs/agents/agent-diagnostic.md`) ; un dossier de `data/` et une question facultative donnent un rapport court dans `agents/diagnostic/rapports/<date>_<STATION>/` : verdict, anomalies seules, chacune montrée par un graphique et des vignettes des images (D-047) ; déplacements et images seulement ; cas de référence du spécialiste : PS des Coudres est sain, seule anomalie les pics d'erreur de `REF_G` et `REF_D` ; base de cas validés (D-048, `agents/diagnostic/cas/`), lue après les faits : un cas, C-001 (PS des Coudres, brume sur deux références la nuit du 13 au 14/10, système sain), noms codés (D-049, skill `anonymiser-cas`) ; un cas n'y entre que sur demande explicite de l'utilisateur (skill `/nouveau-cas`). L'enquête par API (D-042) reste un document.
|
||||
- **Storage (D-030, D-034, D-035)** : jeu de travail WEISSHORN seul (NORDEND n'a pas les mesures de `/data`) ; `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL` en prototype, sans cas de l'expert ; couleur du jour codée (`src/storage/day_color.py`, matrice état × horizon `docs/storage/matrice-etat-horizon.drawio`, la pire des deux) ; seuils arbitraires (20 % / 10 % libres, 60 / 14 jours) ; questions en suspens dans `docs/storage/domaine/questions-pour-l-expert.md` ; livré en prototype (D-039) : figure du site `src/storage/final.py`, bloc de la vue client, notification support, guide `docs/storage/guide/`.
|
||||
- **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; livré en prototype avant les réponses du spécialiste (D-039) : figure du site `src/cellular/final.py`, bloc de la vue client, notification support, guide `docs/cellular/guide/`. Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`.
|
||||
- **Temperature (D-040)** : jeux de travail WEISSHORN et NORDEND (VERMONT n'a pas le GPU) ; `DAILY_GPU_TEMPERATURE_LIMIT` en prototype, sans cas de l'expert : une moyenne horaire du GPU ≥ 97,5 °C (limite du Jetson Nano, carte supposée) dans les 24 dernières heures ; couleur du jour codée (`src/temperature/day_color.py` : Red si atteinte, sinon Green, pas d'orange) ; tous les jours Green (maximum 57,2 °C) ; livré en prototype (D-041) : figure du site `src/temperature/final.py`, bloc de la vue client, notification support, guide `docs/temperature/guide/`. Constats, pistes et questions dans `docs/temperature/domaine/point-de-depart.md`.
|
||||
- **Dev container (D-038)** : Docker Engine dans WSL, `.devcontainer/` (Python 3.14, plotly, matplotlib, réseau de l'hôte) ; prépare la communication avec la caméra, en attente de la doc de l'API REST.
|
||||
- **Prochaine étape** : `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, à reporter dans le guide ; `storage` : les réponses de l'expert (seuils, disque plein, purge, cas), puis les seuils et le guide ; `temperature` : confirmer la carte et ses seuils sur une station (question 1 de `docs/temperature/domaine/point-de-depart.md`), puis le guide si la limite change ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre côté client pas à pas, puis côté support (points ouverts dans D-022 et D-039) ; agent de diagnostic : l'utilisateur valide le rapport du second passage sur PS des Coudres (§7 de sa spec) et voit avec le spécialiste si les pics de `REF_G` et `REF_D` biaisent la compensation (marche de `corr_x` de BJ_G) ; premiers cas de la base, quand l'utilisateur les apporte et le demande.
|
||||
- **Prochaine étape** : `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, à reporter dans le guide ; `storage` : les réponses de l'expert (seuils, disque plein, purge, cas), puis les seuils et le guide ; `temperature` : confirmer la carte et ses seuils sur une station (question 1 de `docs/temperature/domaine/point-de-depart.md`), puis le guide si la limite change ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre côté client pas à pas, puis côté support (points ouverts dans D-022 et D-039) ; agent de diagnostic : l'utilisateur valide le rapport du second passage sur PS des Coudres (§7 de sa spec) et voit avec le spécialiste si les pics de `REF_G` et `REF_D` biaisent la compensation (marche de `corr_x` de BJ_G) ; d'autres cas de la base, quand l'utilisateur les apporte et le demande.
|
||||
|
||||
## Analyses (domaine Energy)
|
||||
|
||||
@@ -108,7 +108,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
### Fichiers
|
||||
|
||||
- `README.md` (40 l) : point d'entrée pour un humain.
|
||||
- `docs/decisions.md` (542 l, D-001 à D-048) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `docs/decisions.md` (552 l, D-001 à D-049) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `docs/domaine/` : savoir métier commun, une note courte (< 50 l) par question.
|
||||
- `ce-que-mesure-la-station.md` : format CSV, métriques et unités, consommation mesurée mais pas l'apport.
|
||||
- `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit.
|
||||
@@ -144,7 +144,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
- `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-034).
|
||||
- `temperature/` : calcul embarquable `gpu_temperature_limit.py`, `day_color.py` ; plotly : `final.py` (figure du site, D-041), `all_analyses.py` (D-040).
|
||||
- `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande. Un script remplit son gabarit HTML : `user/summary.py` + `summary_template.html` (client, une page par station, un bloc par domaine), `support/home.py` + `home_template.html` (support). Les deux parcourent une liste de domaines (`DOMAINS`, D-039).
|
||||
- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `skills/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `settings.json` (lecture de `.env` interdite).
|
||||
- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `skills/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `skills/anonymiser-cas/` (noms des cas en codes, registre des codes, D-049), `settings.json` (lecture de `.env` interdite).
|
||||
- `.devcontainer/devcontainer.json` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra.
|
||||
- `architecture.drawio` : schéma d'architecture tenu par l'utilisateur. Ne pas le modifier sans demande.
|
||||
- `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `.venv/` et `__pycache__/` (D-014).
|
||||
|
||||
BIN
Binary file not shown.
|
Before Width: | Height: | Size: 88 KiB |
BIN
Binary file not shown.
|
Before Width: | Height: | Size: 79 KiB |
BIN
Binary file not shown.
|
After Width: | Height: | Size: 106 KiB |
BIN
Binary file not shown.
|
After Width: | Height: | Size: 124 KiB |
+12
-12
@@ -1,17 +1,17 @@
|
||||
# C-001 : deux références voilées la nuit par la brume, mesures saines
|
||||
|
||||
PS_DES_COUDRES · data/PS_DES_COUDRES/ · 2026-10-13T23:30Z → 2026-10-14T05:30Z UTC · avis de l'expert du 2026-10-14 · entré le 2026-10-14
|
||||
S01 · data/S01/ · 2026-10-13T20:00Z → 2026-10-14T08:00Z UTC · avis de l'expert du 2026-10-14 · entré le 2026-10-14
|
||||
|
||||
## Symptôme
|
||||
L'`error_value` de certaines références varie fortement et soudainement, la nuit, alors que les déplacements des cibles ne bougent pas.
|
||||
|
||||
## Signature
|
||||
Critères observables, relatifs au niveau habituel du capteur, chacun avec sa commande :
|
||||
1. Une partie des références, pas toutes (ici deux sur trois) : `error_value` monte à plusieurs dizaines de MAD au-dessus de sa médiane (ici 28 et 57 MAD), d'un coup ou en moins d'une heure : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --colonne error_value --pas 15min --capteurs REF_CT,REF_D,REF_G --debut 2026-10-13T23:30Z --fin 2026-10-14T05:30Z`
|
||||
1. Une partie des références, pas toutes (ici deux sur trois) : `error_value` monte à plusieurs dizaines de MAD au-dessus de sa médiane (ici 28 et 57 MAD), d'un coup ou en moins d'une heure : `python3 agents/diagnostic/outils/resume.py data/S01/ --colonne error_value --pas 15min --capteurs R1,R2,R3 --debut 2026-10-13T20:00Z --fin 2026-10-14T08:00Z`
|
||||
2. La nuit, pendant quelques heures (ici 3 h 45 et 5 h 30), puis retour au niveau habituel avant le jour, sans intervention : même commande.
|
||||
3. Témoins : l'autre référence et toutes les cibles restent proches de leur niveau habituel, bien en dessous des références touchées en MAD (ici 9 MAD au plus) : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --colonne error_value --stat max --pas 6h --debut 2026-10-13T23:30Z --fin 2026-10-14T05:30Z`
|
||||
4. Positions brutes des cibles sans marche : aucun pas de 15 min de `relative_x` ou `relative_y` hors de leur dispersion habituelle (ici 4 MAD au plus), y compris quand les références reviennent : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --colonne relative_x --pas 15min --debut 2026-10-13T23:30Z --fin 2026-10-14T05:30Z` (même chose pour `relative_y`)
|
||||
5. Sur les images, si elles existent : les taches des références touchées rapetissent puis retrouvent leur taille ; les témoins ne changent pas ; aucun obstacle : `.venv/bin/python agents/diagnostic/outils/vignettes.py data/PS_DES_COUDRES/ --capteurs REF_G,REF_D,REF_CT,BJ_G --heures 2026-10-14T02:00Z,2026-10-14T04:00Z,2026-10-14T05:00Z`
|
||||
3. Témoins : l'autre référence et toutes les cibles restent proches de leur niveau habituel, bien en dessous des références touchées en MAD (ici 9 MAD au plus) : `python3 agents/diagnostic/outils/resume.py data/S01/ --colonne error_value --stat max --pas 6h --debut 2026-10-13T20:00Z --fin 2026-10-14T08:00Z`
|
||||
4. Pendant l'épisode, de la montée des références à leur retour, les positions brutes des cibles n'ont pas de marche : aucun pas de 15 min de `relative_x` ou `relative_y` hors de leur dispersion habituelle (ici 4 MAD au plus). À l'aube, toutes les positions bougent ensemble (ici jusqu'à 9 MAD) : c'est le cycle jour/nuit, pas ce cas : `python3 agents/diagnostic/outils/resume.py data/S01/ --colonne relative_x --pas 15min --debut 2026-10-13T23:30Z --fin 2026-10-14T05:30Z` (même chose pour `relative_y`)
|
||||
5. Sur les images, si elles existent : les taches des références touchées rapetissent puis retrouvent leur taille ; les témoins ne changent pas ; aucun obstacle : `.venv/bin/python agents/diagnostic/outils/vignettes.py data/S01/ --capteurs R3,R2,R1,C3 --heures 2026-10-13T22:00Z,2026-10-14T02:00Z,2026-10-14T04:00Z,2026-10-14T06:00Z`
|
||||
|
||||
## Exclusions
|
||||
Ce qui ferait que ce n'est pas ce cas :
|
||||
@@ -33,17 +33,17 @@ Ce qui ferait que ce n'est pas ce cas :
|
||||
|
||||
## Inconnus
|
||||
- La brume est déduite, pas vue : il n'y a pas de météo, et l'image de 02:00 ne montre pas de brouillard général. De la rosée ou de la buée sur les réflecteurs reste possible.
|
||||
- Un petit effet reste à confirmer avec le spécialiste. Les centroïdes bruts des références touchées se décalent un peu, de 0,1 à 0,3 px (un pas de 12 MAD au retour de l'une). Aux mêmes instants, `corr_x` de quelques cibles saute puis revient : +0,18 puis −0,33 pour BJ_G, +0,12 puis −0,18 pour PBJ_C, leurs minimums de la période. **Question au spécialiste** : ces sauts de la compensation sont-ils négligeables ? Sinon, la classification devient *camera/reference compensation event*.
|
||||
- Un petit effet reste à confirmer avec le spécialiste. Les centroïdes bruts des références touchées se décalent un peu, de 0,1 à 0,3 px (un pas de 12 MAD au retour de l'une). Aux mêmes instants, `corr_x` de quelques cibles saute puis revient : +0,18 puis −0,33 pour C3, +0,12 puis −0,18 pour C7, leurs minimums de la période. **Question au spécialiste** : ces sauts de la compensation sont-ils négligeables ? Sinon, la classification devient *camera/reference compensation event*.
|
||||
|
||||
## Preuves
|
||||

|
||||
*REF_G et REF_D montent seules, REF_CT, BJ_G et BL_D restent plates. En bas, seule REF_G se décale un peu, puis revient avec son error_value.*
|
||||

|
||||
*R3 et R2 montent seules, la nuit, puis reviennent ; R1, C3 et C5 restent plates. En bas, seule R3 se décale un peu pendant l'épisode, puis revient avec son error_value.*
|
||||
|
||||

|
||||
*À 02:00, REF_G et REF_D sont réduites à un point. À 04:00, REF_G est revenue et REF_D pas encore ; à 05:00, REF_D revient. REF_CT et BJ_G ne changent pas.*
|
||||

|
||||
*À 22:00, avant l'épisode, les quatre taches ont leur taille habituelle. À 02:00, R3 et R2 sont réduites à un point ; à 04:00, R3 est revenue et R2 pas encore. À 06:00, l'aube éclaire le fond et les tailles ne se comparent plus ; l'`error_value` de R2 est revenue à 05:30. R1 et C3 ne changent pas.*
|
||||
|
||||
## Test à l'aveugle
|
||||
Rapport : `agents/diagnostic/rapports/2026-10-14T1528Z_PS_DES_COUDRES_nuit-13-14/`, question « que s'est-il passé du 2026-10-13 20:00 au 2026-10-14 08:00 (UTC) ? », sur un index vide. La fenêtre du cas a été resserrée ensuite à la demande de l'utilisateur, et les figures refaites sur cette fenêtre.
|
||||
Rapport : `agents/diagnostic/rapports/2026-10-14T1528Z_S01_nuit-13-14/`, question « que s'est-il passé du 2026-10-13 20:00 au 2026-10-14 08:00 (UTC) ? », sur un index vide. La fenêtre du cas est celle de la question.
|
||||
|
||||
| Attendu | Résultat |
|
||||
|---|---|
|
||||
@@ -56,7 +56,7 @@ Rapport : `agents/diagnostic/rapports/2026-10-14T1528Z_PS_DES_COUDRES_nuit-13-14
|
||||
|
||||
L'attendu 3 n'est pas corrigé dans `instructions.md` : les sauts existent, et c'est leur importance qui fait débat. Ce jugement métier n'est pas confirmé (voir « Inconnus », question au spécialiste).
|
||||
|
||||
**Test de correspondance (2026-10-14).** Même question, avec le cas dans l'index. Rapport : `agents/diagnostic/rapports/2026-10-14T1538Z_PS_DES_COUDRES_nuit-13-14/`. Réussi au premier essai :
|
||||
**Test de correspondance (2026-10-14).** Même question, avec le cas dans l'index. Rapport : `agents/diagnostic/rapports/2026-10-14T1538Z_S01_nuit-13-14/`. Réussi au premier essai :
|
||||
- correspondance : « C-001, complète », critères 1 à 5 vérifiés, exclusions écartées ;
|
||||
- diagnostic : *target-local degradation* `strongly supported`, buée ou eau `possible` ;
|
||||
- conséquence « aucune » (la règle d'asymétrie tient : correspondance complète, mouvement réel réfuté par les positions brutes), action « aucune ».
|
||||
@@ -1,7 +1,7 @@
|
||||
# Cas connus
|
||||
|
||||
Incidents validés par l'expert, un par ligne. La **Signature** résume ce qu'on observe : type de capteurs, combien, colonne, forme, moment, durée, retour à la normale. Ouvre la fiche d'un cas proche par son lien ; ses critères et ses exclusions se vérifient avec tes outils, sur tes données.
|
||||
Incidents validés par l'expert, un par ligne. La **Signature** résume ce qu'on observe : type de capteurs, combien, colonne, forme, moment, durée, retour à la normale. Ouvre la fiche d'un cas proche par son lien ; ses critères et ses exclusions se vérifient avec tes outils, sur tes données. Les noms y sont codés (`S01` une station, `R1` une référence, `C1` une cible) : rapporte chaque critère à tes capteurs du même rôle, jamais à un nom.
|
||||
|
||||
| Cas | Station · fenêtre (UTC) | Signature | Classification | Cause (expert) | Verdict expert |
|
||||
|---|---|---|---|---|---|
|
||||
| [C-001](C-001_PS_DES_COUDRES_2026-10-13/cas.md) | PS des Coudres · 2026-10-13T23:30Z → 2026-10-14T05:30Z | Une partie des références (2 sur 3) : `error_value` à plusieurs dizaines de MAD, la nuit, quelques heures, puis retour ; autre référence et cibles intactes ; positions brutes des cibles sans marche | *target-local degradation* | brume (buée ou eau), inférée | aucune, aucune |
|
||||
| [C-001](C-001_S01_2026-10-13/cas.md) | S01 · 2026-10-13T20:00Z → 2026-10-14T08:00Z | Une partie des références (2 sur 3) : `error_value` à plusieurs dizaines de MAD, la nuit, quelques heures, puis retour ; autre référence et cibles intactes ; positions brutes des cibles sans marche | *target-local degradation* | brume (buée ou eau), inférée | aucune, aucune |
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
Usage : .venv/bin/python agents/diagnostic/outils/graphique.py data/PS_DES_COUDRES/
|
||||
[--capteurs CAPTEUR_A,CAPTEUR_B] [--colonnes error_value,corr_x,corr_y] [--debut ...] [--fin ...]
|
||||
[--zone DEBUT/FIN ...] [--sortie DOSSIER]
|
||||
[--zone DEBUT/FIN ...] [--sortie DOSSIER] [--alias NOM=CODE,...]
|
||||
Un panneau par colonne, une courbe par capteur, heures UTC ; chaque --zone est grisée.
|
||||
Imprime le chemin du PNG (out/diagnostic/, ou --sortie : le dossier du rapport, pour une figure de preuve).
|
||||
"""
|
||||
@@ -43,7 +43,9 @@ def main():
|
||||
a.add_argument("--fin", type=instant)
|
||||
a.add_argument("--zone", type=zone, action="append", default=[], help="fenêtre à griser, DEBUT/FIN (répétable)")
|
||||
a.add_argument("--sortie", default=os.path.join(RACINE, "out", "diagnostic"), help="dossier du PNG")
|
||||
a.add_argument("--alias", help="NOM=CODE,... : codes à la place des noms (skill anonymiser-cas)")
|
||||
o = a.parse_args()
|
||||
alias = dict(p.split("=", 1) for p in o.alias.split(",")) if o.alias else {}
|
||||
|
||||
par = charger(o.dossier)
|
||||
if not par:
|
||||
@@ -70,7 +72,7 @@ def main():
|
||||
for i, s in enumerate(noms):
|
||||
ms = series[s] # une valeur vide devient NaN : la courbe s'interrompt au lieu de relier le trou
|
||||
ax.plot([m["t"] for m in ms], [float("nan") if m[col] is None else m[col] for m in ms], ".-", ms=2, lw=0.7,
|
||||
color=couleurs[i % len(couleurs)], label=s)
|
||||
color=couleurs[i % len(couleurs)], label=alias.get(s, s))
|
||||
for debut, fin in o.zone:
|
||||
ax.axvspan(debut, fin, color="0.85", zorder=0)
|
||||
ax.set_ylabel(col)
|
||||
@@ -78,10 +80,11 @@ def main():
|
||||
axes[0, 0].legend(loc="upper left", bbox_to_anchor=(1.0, 1.0), fontsize=8)
|
||||
axes[-1, 0].xaxis.set_major_formatter(mdates.DateFormatter("%d/%m\n%H:%MZ"))
|
||||
station = os.path.basename(os.path.normpath(o.dossier))
|
||||
station = alias.get(station, station)
|
||||
fig.suptitle(f"{station} : {', '.join(colonnes)} (heures UTC)")
|
||||
|
||||
os.makedirs(o.sortie, exist_ok=True)
|
||||
qui = "-".join(noms) if o.capteurs else "tous"
|
||||
qui = "-".join(alias.get(s, s) for s in noms) if o.capteurs else "tous"
|
||||
sortie = os.path.join(o.sortie, f"{station}_{'-'.join(colonnes)}_{qui}_"
|
||||
f"{borne(o.debut, 'debut')}_{borne(o.fin, 'fin')}.png")
|
||||
fig.savefig(sortie, dpi=100, bbox_inches="tight")
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
"""Vignettes des images de la caméra autour de capteurs, à pleine résolution, pour l'agent de diagnostic.
|
||||
|
||||
Usage : .venv/bin/python agents/diagnostic/outils/vignettes.py data/PS_DES_COUDRES/
|
||||
--capteurs REF_G,REF_D --heures 2026-10-13T22:00Z,2026-10-14T02:00Z [--rayon 100] [--sortie DOSSIER]
|
||||
--capteurs REF_G,REF_D --heures 2026-10-13T22:00Z,2026-10-14T02:00Z [--rayon 100] [--sortie DOSSIER] [--alias NOM=CODE,...]
|
||||
Une ligne par capteur, une colonne par heure. Chaque vignette est centrée sur la position brute (x, y) du capteur
|
||||
dans l'export « advanced », lue à la mesure la plus proche de l'image ; les pixels ne sont pas retouchés, l'éclat
|
||||
se compare donc d'une vignette à l'autre. Imprime les positions utilisées, puis le chemin du PNG.
|
||||
@@ -27,7 +27,9 @@ def main():
|
||||
a.add_argument("--heures", required=True, help="heures des images, séparées par des virgules (UTC)")
|
||||
a.add_argument("--rayon", type=int, default=100, help="demi-côté de la vignette en pixels (défaut 100)")
|
||||
a.add_argument("--sortie", default=os.path.join(RACINE, "out", "diagnostic"), help="dossier du PNG")
|
||||
a.add_argument("--alias", help="NOM=CODE,... : codes à la place des noms (skill anonymiser-cas)")
|
||||
o = a.parse_args()
|
||||
alias = dict(p.split("=", 1) for p in o.alias.split(",")) if o.alias else {}
|
||||
|
||||
par = charger(o.dossier)
|
||||
images = {heure_image(p): p for p in trouver(o.dossier)["images"]}
|
||||
@@ -51,14 +53,15 @@ def main():
|
||||
print(f"{s} {iso(h)} : x={m['x']:.1f} y={m['y']:.1f} (mesure de {iso(m['t'])}), {os.path.basename(images[h])}")
|
||||
ax = axes[i, j]
|
||||
ax.imshow(img[max(y - r, 0):y + r, max(x - r, 0):x + r], interpolation="nearest")
|
||||
ax.set_title(f"{s} {h.strftime('%d/%m %H:%MZ')}", fontsize=9)
|
||||
ax.set_title(f"{alias.get(s, s)} {h.strftime('%d/%m %H:%MZ')}", fontsize=9)
|
||||
ax.set_xticks([])
|
||||
ax.set_yticks([])
|
||||
station = os.path.basename(os.path.normpath(o.dossier))
|
||||
station = alias.get(station, station)
|
||||
fig.suptitle(f"{station} : vignettes de {2 * r} px autour de chaque capteur (heures UTC)", fontsize=10)
|
||||
|
||||
os.makedirs(o.sortie, exist_ok=True)
|
||||
sortie = os.path.join(o.sortie, f"{station}_vignettes_{'-'.join(noms)}_"
|
||||
sortie = os.path.join(o.sortie, f"{station}_vignettes_{'-'.join(alias.get(s, s) for s in noms)}_"
|
||||
f"{'-'.join(h.strftime('%d%H%M') for h in heures)}.png")
|
||||
fig.savefig(sortie, dpi=100, bbox_inches="tight")
|
||||
print(sortie)
|
||||
|
||||
@@ -229,7 +229,7 @@ La plage sélectionnée par « Analyze » est le mode question actuel (§4) rest
|
||||
```
|
||||
agents/diagnostic/cas/
|
||||
INDEX.md la table : seule porte d'entrée de l'agent
|
||||
C-001_<STATION>_<AAAA-MM-JJ>/ un dossier par incident (numéro, station, date de début)
|
||||
C-001_<S01>_<AAAA-MM-JJ>/ un dossier par incident (numéro, code de la station, date de début)
|
||||
cas.md la fiche
|
||||
*.png ses figures de preuve
|
||||
```
|
||||
@@ -239,6 +239,7 @@ agents/diagnostic/cas/
|
||||
- Le numéro `C-xxx` est la référence stable que cite le rapport.
|
||||
- Un cas n'entre dans l'index qu'une fois validé par l'expert : pas de colonne de statut. L'agent n'ouvre que les fiches que cite l'index.
|
||||
- La base démarre vide : `INDEX.md` n'a que son en-tête.
|
||||
- **Noms codés (D-049)** : dans l'index, les fiches et leurs figures, la station devient `S01`, une référence `R1`, une cible `C1`. Les codes sont stables d'un cas à l'autre et tenus dans le registre du skill `anonymiser-cas`, que l'agent ne lit pas. L'agent rapproche ainsi par la signature, pas par le nom.
|
||||
|
||||
### 11.2 L'index
|
||||
|
||||
@@ -246,7 +247,7 @@ Une ligne par incident. La colonne **Signature** sert à la recherche : courte,
|
||||
|
||||
| Cas | Station · fenêtre (UTC) | Signature | Classification | Cause (expert) | Verdict expert |
|
||||
|---|---|---|---|---|---|
|
||||
| *exemple :* C-001 | PS des Coudres · 13/10 01:15 → 14/10 05:00 | 2 références sur 3, `error_value` ×5-8, la nuit, 3-5 h, retour seul ; cibles et 3e référence intactes | *camera/reference compensation event* | inconnue | sain, point d'attention |
|
||||
| *exemple :* C-001 | S01 · 13/10 01:15 → 14/10 05:00 | 2 références sur 3, `error_value` ×5-8, la nuit, 3-5 h, retour seul ; cibles et 3e référence intactes | *camera/reference compensation event* | inconnue | sain, point d'attention |
|
||||
|
||||
### 11.3 La fiche (`cas.md`)
|
||||
|
||||
@@ -326,7 +327,7 @@ Procédure tenue par `.claude/skills/nouveau-cas/SKILL.md`, avec `disable-model-
|
||||
2. **Ranger** les données (D-029, D-045) : export dans `data/<STATION>/displacement/`, images renommées en UTC (`<AAAAMMJJ>T<HHMM>Z_<n>.jpg`) ; contrôle par `inventaire.py`.
|
||||
3. **Commit neutre** (rien sur l'incident ni sa cause : le sous-agent reçoit les derniers messages de commit et la branche), arbre propre.
|
||||
4. **Passage à l'aveugle**, la fenêtre de l'incident pour question, comparé à des attendus écrits avant ; un attendu manqué se corrige dans `instructions.md` par une règle générale.
|
||||
5. **Fiche** (signature tirée du rapport, diagnostic de l'expert, figures copiées) et ligne d'index avec lien, montrées à l'utilisateur et validées avant commit.
|
||||
5. **Fiche** (signature tirée du rapport, diagnostic de l'expert, figures refaites, noms codés par le skill `anonymiser-cas`, D-049) et ligne d'index avec lien, montrées à l'utilisateur et validées avant commit.
|
||||
6. **Test de correspondance** : l'agent relancé, le cas dans l'index, doit trouver `C-xxx, complète` (ou partielle) et le diagnostic de l'expert. Il vérifie la mécanique, pas le jugement : l'agent a lu la fiche.
|
||||
|
||||
Un cas ne touche ni `CLAUDE.md`, ni cette spec, ni `docs/decisions.md` : l'index est le registre.
|
||||
|
||||
@@ -540,3 +540,13 @@ Règles du journal :
|
||||
- **Pourquoi** : demande de l'utilisateur : le diagnostic marche mais manque de déterminisme ; l'agent reçoit tout et peut conclure hors sujet. Usage visé : un bouton « Analyze » sur une plage sélectionnée, dont il faut contrôler la sortie. Ancrer le verdict sur des cas validés suit le §17 du contexte support (*historical cases used like software tests*). Choix de l'utilisateur sur proposition : index lu par l'agent, une fiche par incident, cas reçus avec l'avis de l'expert, hypothèses « non validé » hors cas.
|
||||
- **Options écartées** : RAG vectorielle (inutile à quelques dizaines de cas ; deux cas se ressemblent par leur signature, pas par leur texte ; service d'embeddings tiers) ; fiches dans les instructions (ancrage avant les données) ; une fiche par type ; toujours le cas le plus proche (ancrage) ; faits seuls hors cas (le support repart de zéro).
|
||||
- **Conséquence** : un cas est aussi un test de régression (retirer sa ligne de l'index pour le rejouer) ; filtre structuré ou RAG quand l'index ne tiendra plus en une lecture ou que la question arrivera en texte libre.
|
||||
|
||||
## D-049 — 2026-10-14 — Base de cas : noms de station et de capteurs codés
|
||||
- **Statut** : active (skill `anonymiser-cas`, appelé à l'étape 5 de `/nouveau-cas`) ; appliquée à C-001.
|
||||
- **Décision** :
|
||||
- dans `agents/diagnostic/cas/` (index, fiches, noms de fichiers, figures), la station devient `S01`, une référence `R1`, une cible `C1` (numérotation par station) ;
|
||||
- un registre unique, `.claude/skills/anonymiser-cas/registre.csv`, ne fait que grandir : un nom garde son code d'un cas à l'autre ; l'agent ne le lit pas ;
|
||||
- un script en bibliothèque standard (`anonymiser.py`) attribue les codes, réécrit les textes, renomme les fichiers et s'arrête s'il reste un nom réel ; `graphique.py` et `vignettes.py` prennent une option `--alias` pour tracer avec les codes.
|
||||
- **Pourquoi** : demande de l'utilisateur : ne pas influencer l'agent par le nom du site, des cibles ou des références ; il doit rapprocher un cas par sa signature, et une anonymisation constante se fait mieux par un skill que par des choix au cas par cas.
|
||||
- **Options écartées** : codes propres à chaque cas (pas de constance d'un cas à l'autre) ; codes qui gardent un sens (`REF_GAUCHE`) ; rendre les images floues ou les masquer (preuves perdues) ; anonymiser `rapports/` (l'agent ne les lit pas).
|
||||
- **Conséquence** : les commandes d'une fiche portent des codes et se rejouent avec le registre ; les images montrent encore le site.
|
||||
Reference in new issue
Block a user