Diagnostic-App, le poste de pilotage : l'analyste et le tool-builder du dépôt agents, l'optimisation par Optimizer, la lecture par tools

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-16 10:59:13 +01:00
1 parent dd6f1bfb38
commit 23e1eea0b8
24 files changed
+183 -3110

No files matched your search

+36 -29
View File
@@ -1,14 +1,14 @@
"""L'onglet Analysis de la page Data : l'analyste (.claude/agents/analyste.md) lancé par `claude -p`, non interactif, sur une
plage choisie dans la page, avec les indices facultatifs de l'utilisateur. Il écrit dans
"""L'onglet Analysis de la page Data : l'analyste du dépôt agents (agents/, un plugin : --agent agents:analyste), lancé par
`claude -p`, non interactif, sur une plage choisie dans la page, avec les indices facultatifs de l'utilisateur, ses consignes
(consignes/analyste.md) et sans les détecteurs (DETECTEURS : non : ses étiquettes serviront à les améliorer). Il écrit dans
labeling/auto/analyses/<STATION>_<début>_<fin>/ ses étiquettes (etiquettes.jsonl) et un rapport de diagnostic (rapport.md, ses
figures à côté) ; à la fin, le serveur verse ses étiquettes dans labeling/auto/<STATION>.jsonl, marquées de leur analyse
(champ `analyse`). Puis l'utilisateur peut lui écrire : la même session reprend (`claude -p --resume`), et ses étiquettes, si
elles changent, remplacent celles qu'il avait versées.
Sur une analyse finie, « Optimiser » lance `/detectors:wf-improve` (le plugin du dépôt detectors, monté en detectors/) sur
la plage de l'analyse, ses étiquettes pour vérité, qui améliore les détecteurs, puis le tool-builder (.claude/agents/tool-builder.md), qui fait entrer
les scripts de l'analyste dans les outils de lecture ; une optimisation à la fois, ni analyse ni message pendant ; le bilan de
la séance (<analyse>/detectors/<heure>/summary.md) et celui des outils (<analyse>/outils.md) s'affichent sous
le rapport.
Sur une analyse finie, « Optimiser » lance `/improve` dans Optimizer (optimizer/, le skill qui améliore les détecteurs sur la
plage de l'analyse, ses étiquettes pour vérité), puis le tool-builder du dépôt agents, qui fait entrer les scripts de
l'analyste dans les outils de lecture (tools/) ; une optimisation à la fois, ni analyse ni message pendant ; le bilan de la
séance (optimizer/seances/<analyse>_<heure>/summary.md) et celui des outils (<analyse>/outils.md) s'affichent sous le rapport.
"""
import html
import json
@@ -23,14 +23,16 @@ import station
DOSSIER = station.ETIQUETTES / "auto" / "analyses"
DETECTEURS = station.RACINE / "detectors"
# la requête de /detectors:wf-improve (detectors/README.md) : tout ce qu'il lit et écrit est donné ici, avec ses règles git
AMELIORER = """/detectors:wf-improve DETECTORS: detectors/. STATION: {donnees}/{station}. FROM: {du}. TO: {au}. \
LABELS: {etiquettes}/auto/{station}.jsonl. REFERENCE: --labels {etiquettes}/auto --data {donnees}. \
FAMILIES: {etiquettes}/familles.md. CONTEXT: {analyse}/rapport.md. OUT: {sortie}/. Caller's context: Diagnostic-app, \
detectors/ is a link to the detectors repository, shared with Optimizer; read-only on {donnees}/ and {etiquettes}/; commit only in detectors/, on its current branch; \
OUT is in the labeling repository (labeling/ is a link to it): do not commit it."""
AGENTS = station.RACINE / "agents" # le plugin des agents génériques (~/agents)
OPTIMIZER = station.RACINE / "optimizer" # le dépôt Optimizer (~/Optimizer), où tourne /improve
SEANCES = OPTIMIZER / "seances"
# la requête de /improve (optimizer/README.md), chemins relatifs à la racine d'Optimizer (ses liens data, labeling, detectors)
AMELIORER = """/improve DETECTORS: detectors/. STATION: data/{station}. FROM: {du}. TO: {au}. \
LABELS: labeling/auto/{station}.jsonl. REFERENCE: --labels labeling/auto --data data. FAMILIES: labeling/familles.md. \
CONTEXT: labeling/auto/analyses/{nom}/rapport.md. OUT: seances/{nom}_{heure}/. Caller's context: Diagnostic-app, through \
Optimizer; read-only on data/ and labeling/; commit only in detectors/, on its current branch; do not commit OUT."""
DEMANDE = """Station : data/{station}/. Plage : {debut} → {fin} (UTC). Indices de l'utilisateur : {indices}. \
Dossier de sortie : {sortie}/."""
Dossier de sortie : {sortie}/. DETECTEURS : non. CONSIGNES : consignes/analyste.md."""
# nom -> {"etat": "en cours" | "fini" | "erreur", "lignes": [...], "versees": n} ; une analyse à la fois par plage
analyses, verrou = {}, threading.Lock()
@@ -72,7 +74,8 @@ def travailler(nom, sortie, prompt, reprise=None):
"""Un tour de l'analyste : la demande, ou un message de l'utilisateur dans la même session (reprise : son id)."""
a = analyses[nom]
try:
p = subprocess.Popen(["claude", "-p", prompt, "--agent", "analyste", "--output-format", "stream-json", "--verbose",
p = subprocess.Popen(["claude", "-p", prompt, "--plugin-dir", str(AGENTS), "--agent", "agents:analyste",
"--output-format", "stream-json", "--verbose",
"--allowedTools", "Read,Write,Bash", "--permission-mode", "acceptEdits", *station.liens()]
+ (["--resume", reprise] if reprise else []),
cwd=station.RACINE, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True)
@@ -218,11 +221,12 @@ def rapport(nom, sombre):
return _page(fichier(nom, "rapport.md").read_text(encoding="utf-8"), nom, sombre)
# --- « Optimiser » : /detectors:wf-improve sur l'analyse, puis le tool-builder, par claude -p
# --- « Optimiser » : /improve dans Optimizer sur l'analyse, puis le tool-builder, par claude -p
def _bilan(nom):
"""Le bilan de la dernière séance de cette analyse, ou None."""
bilans = sorted((DOSSIER / nom / "detectors").glob("*/summary.md")) # <heure>/ : l'ordre du nom est celui du temps
"""Le bilan de la dernière séance de cette analyse, ou None. Le motif de l'heure écarte les séances d'une autre analyse
de la même plage (<nom>_<HHMMSS>_<heure>)."""
bilans = sorted(SEANCES.glob(f"{nom}_????????T????Z/summary.md")) # l'ordre du nom est celui du temps
return bilans[-1] if bilans else None
@@ -245,8 +249,9 @@ def optimiser(nom):
"""Le bouton « Optimiser » sur une analyse finie : la séance dans un fil ; refusée si une optimisation ou une analyse tourne."""
if etat(nom)["etat"] != "fini":
raise station.Refus("seule une analyse finie s'optimise")
if not (DETECTEURS / ".claude-plugin" / "plugin.json").exists():
raise station.Refus("pas de dépôt detectors en detectors/ (le lien : ln -s ~/detectors detectors)")
if not ((OPTIMIZER / ".claude" / "skills" / "improve" / "SKILL.md").exists()
and (AGENTS / ".claude-plugin" / "plugin.json").exists()):
raise station.Refus("pas d'Optimizer en optimizer/ ou pas d'agents en agents/ (les liens : README.md)")
with verrou:
if _optimise():
raise station.Refus(OCCUPE)
@@ -258,8 +263,8 @@ def optimiser(nom):
def optimiser_fil(nom):
"""Les deux tours de l'optimisation, l'un après l'autre : les détecteurs (le plugin detectors), puis les outils de lecture
(le tool-builder, même si les détecteurs n'ont pas changé)."""
"""Les deux tours de l'optimisation, l'un après l'autre : les détecteurs (/improve, dans Optimizer), puis les outils de
lecture (le tool-builder, même si les détecteurs n'ont pas changé)."""
o, sortie = optimisations[nom], DOSSIER / nom
rel = os.path.relpath(sortie, station.RACINE)
(sortie / "travail").mkdir(exist_ok=True)
@@ -268,15 +273,17 @@ def optimiser_fil(nom):
d = json.loads((sortie / "demande.json").read_text(encoding="utf-8"))
requete = AMELIORER.format( # TO exclu : le jour après la fin de la plage, comme la page
station=d["station"], du=d["debut"][:10], au=date.fromisoformat(d["fin"][:10]) + timedelta(days=1),
donnees=os.path.relpath(station.DONNEES, station.RACINE), etiquettes=os.path.relpath(station.ETIQUETTES, station.RACINE),
analyse=rel, sortie=f"{rel}/detectors/{datetime.now(timezone.utc):%Y%m%dT%H%MZ}")
tours = [[requete, "--plugin-dir", "detectors", "--add-dir", str(DETECTEURS.resolve()), # la cible du lien, où la séance écrit
"--allowedTools", "Read,Write,Edit,Bash,Agent"],
[f"Analyse : {rel}/. Écris {rel}/outils.md.", "--agent", "tool-builder", "--allowedTools", "Read,Write,Edit,Bash"]]
for prompt, *options in tours:
nom=nom, heure=f"{datetime.now(timezone.utc):%Y%m%dT%H%MZ}")
# ponytail: Optimizer lit data/ et labeling/ par ses propres liens ; AIMSIGHT_DATA / AIMSIGHT_LABELS ne le suivent pas
tours = [(OPTIMIZER.resolve(), [requete, "--plugin-dir", str(AGENTS.resolve()),
"--add-dir", str(DETECTEURS.resolve()), # la cible du lien, où la séance écrit
"--allowedTools", "Read,Write,Edit,Bash,Agent"]),
(station.RACINE, [f"Analyse : {rel}/. Outils : tools/. Écris {rel}/outils.md.", "--plugin-dir", str(AGENTS),
"--agent", "agents:tool-builder", "--allowedTools", "Read,Write,Edit,Bash"])]
for dossier, (prompt, *options) in tours:
p = subprocess.Popen(["claude", "-p", prompt, "--output-format", "stream-json", "--verbose",
"--permission-mode", "acceptEdits", *station.liens(), *options],
cwd=station.RACINE, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True)
cwd=dossier, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True)
for ligne in p.stdout:
flux.write(ligne)
o["lignes"] += resume(ligne)