Optimizer : l'optimisation des détecteurs depuis une analyse (skill improve, ex wf-improve, agents du dépôt agents, benchmark detectors/bench) ; le batch et le scanner archivés
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
010c297f60
commit
2cb0c88a2b
117 files changed
+132
-38
No files matched your search
@@ -1,18 +1,17 @@
|
||||
# CLAUDE.md
|
||||
|
||||
Optimizer fait converger les détecteurs AIMsight (le dépôt `~/detectors`, par un lien `detectors`) en continu et à faible coût : un batch par jour UTC, toutes les stations ; les détecteurs posent leurs étiquettes, le `scanner` les regarde de loin face aux courbes et note les irrégularités. Il fait cela et rien d'autre. Conception : `docs/superpowers/specs/2026-11-13-optimizer-design.md` ; installer et lancer : `README.md`.
|
||||
Optimizer : l'optimisation des détecteurs AIMsight sur les étiquettes de `labeling/auto`, et rien d'autre (`README.md`). Le workflow : `.claude/skills/improve/SKILL.md` (`/improve`), lancé depuis la racine d'Optimizer avec le plugin des agents (`--plugin-dir agents`) ; ses agents `agents:upgrader` et `agents:validator` ; le benchmark `detectors/bench/`.
|
||||
|
||||
- **Le batch** : `python3 batch.py [--jour AAAA-MM-JJ] [--stations A,B] [--sans-scan]` → `batches/<jour>/` : `detecteurs/<STATION>.jsonl` (les étiquettes des détecteurs), `verite/<STATION>.jsonl` (les mêmes, corrigées par le scanner), `detecteurs.md` (le résumé pour le scanner), `rapport.md` (le sien), `improve/` (la séance de `wf-improve` sur les stations corrigées : bilan `summary.md`, scripts de ses agents `tools/`), `figures/`, `scan.jsonl` et `improve.jsonl` (les flux) hors de git.
|
||||
- **Les agents** : `.claude/agents/scanner.md`, sur Sonnet (`claude -p --agent scanner`) ; puis `/detectors:wf-improve` (`claude -p --plugin-dir detectors`, ses agents `detectors:upgrader` et `detectors:validator`), une séance sur les stations que le scanner a corrigées. Lancés par `batch.py` sans les réglages du poste (`--setting-sources project,local --strict-mcp-config`).
|
||||
- **Les liens**, hors de git, en lecture seule : `data/` → `~/aimsight-data/data` (rempli par le pompage du dépôt aimsight-data) ; `labeling/` → `~/labeling` (le dépôt des étiquettes, partagé avec Diagnostic-App) (`familles.md` ; `auto/`, la vérité de référence du benchmark).
|
||||
- **Les détecteurs** : leur contrat est dans `detectors/CLAUDE.md` ; Optimizer lit `categories.events`, `categories.CATEGORIES` et `scripts/data.py`. Diagnostic-App y pointe par le même lien (une seule copie : un commit de l'un se voit aussitôt chez l'autre) ; son mode ciblé (une analyse approfondie) et ce mode large seront deux appelants du même `/detectors:wf-improve`.
|
||||
- **Les essais** : `docs/essais/<jour>.md`, un journal par essai de bout en bout ; `outils/`, les scripts de lecture qui en sont restés.
|
||||
- **Vérifier un changement** : `.venv/bin/python outils/etape1.py <dossier de travail>/<jour> <jour>` sur un jour réel (ou `python3 batch.py --jour <jour> --sans-scan` sur un jour sans batch), puis regarder les figures ; à vérité intacte, `regression.py --labels <dossier>/detecteurs --data data --from <jour> --to <lendemain>` doit être à 100 %.
|
||||
- **Les liens**, hors de git : `detectors/` → `~/detectors` (la séance y commite) ; `data/` → `~/aimsight-data/data` et `labeling/` → `~/labeling` (lecture seule) ; `agents/` → `~/agents` (le plugin, chargé en lecture).
|
||||
- **Les séances** : `seances/<analyse>_<AAAAMMJJTHHMMZ>/`, non commitées par la séance ; Diagnostic-App y lit le bilan (`summary.md`).
|
||||
- **Le workflow reste générique** : le skill ne décrit que le workflow (plage + étiquettes → upgrader → validator → bilan) ; ce qui est propre à un appelant (ses chemins, ses règles git, `Caller's context`) arrive dans la requête.
|
||||
- **Vérifier un changement du skill** : `env -u ANTHROPIC_API_KEY claude -p "/improve" --plugin-dir agents --model haiku` doit dire qu'il manque les entrées et s'arrêter sans toucher à `detectors/` ; puis une séance réelle par le bouton de l'app.
|
||||
- `archive/` : l'ancien batch et son scanner, arrêtés ; ne pas les relancer.
|
||||
|
||||
Règles :
|
||||
- **Les agents tournent sur l'abonnement Claude, jamais sur une clé d'API** : `batch.py` lance `claude -p` sans `ANTHROPIC_API_KEY` ni `ANTHROPIC_AUTH_TOKEN`, et l'arrête si son message d'ouverture dit une autre source que l'abonnement (`apiKeySource` ≠ `none`). Le montant en $ du flux n'est qu'un équivalent API, non facturé.
|
||||
- **Les agents tournent sur l'abonnement Claude, jamais sur une clé d'API** (`ANTHROPIC_API_KEY` retiré du lancement).
|
||||
- Toute heure est en UTC.
|
||||
- Lecture seule sur `data/` et `labeling/` ; ne jamais recopier les identifiants des métriques (`SIM_CCID`, `ip*`).
|
||||
- Lecture seule sur `data/` et `labeling/` ; ne jamais recopier les identifiants des métriques (`SIM_CCID`, `ip*`) ; ne jamais lire `.env`.
|
||||
- Pas de règle propre à une station, une cible ou une date.
|
||||
- Commits par chemin, jamais `git add -A`.
|
||||
- Langue : français ; le dépôt `detectors` reste en anglais.
|
||||
- Langue : français ; le skill `improve`, comme le dépôt detectors et ses agents, reste en anglais.
|
||||
Reference in new issue
Block a user