From 07d25de49cbf73144a404089f1fdba44ab76c043 Mon Sep 17 00:00:00 2001 From: Davide Grilli Date: Tue, 20 Oct 2026 15:00:23 +0200 Subject: [PATCH] Risposte senza riferimenti wiki; regole di coerenza e posizione delle immagini Co-Authored-By: Claude Sonnet 5.5 --- .agents/skills/tesi-dati/SKILL.md | 2 +- .agents/skills/tesi-figure/SKILL.md | 5 ++++- .agents/skills/tesi-fonti/SKILL.md | 2 +- .agents/skills/tesi-narrate/SKILL.md | 6 +++--- .agents/skills/tesi-query/SKILL.md | 6 +++--- CLAUDE.md | 26 +++++++++++++++++++++----- README.md | 4 ++-- 7 files changed, 35 insertions(+), 16 deletions(-) diff --git a/.agents/skills/tesi-dati/SKILL.md b/.agents/skills/tesi-dati/SKILL.md index 6fc002d..37895df 100644 --- a/.agents/skills/tesi-dati/SKILL.md +++ b/.agents/skills/tesi-dati/SKILL.md @@ -10,7 +10,7 @@ Sola lettura. Italiano. 1. Localizza la grandezza: `wiki/dati.md` (grandezza → pagina con intervalli), `wiki/tabelle-indice.md` (15 tabelle e 12 equazioni), `wiki/campioni.md` (campione × tecnica). 2. Apri la pagina indicata (una tabella sta in **una sola** pagina; le altre rimandano) e poi `raw/tesi.md` alle righe di `tesi_loc` per il valore esatto. 3. **Copia alla lettera** valori, unità, condizioni (T, P, solvente, tempo, carico, resa/conversione), formule LaTeX, nomi e sigle. Decimali come in tesi (virgola; punto in dati NMR, concentrazioni, condizioni CV). Nessuna conversione o arrotondamento. -4. Cita sempre tabella/sezione/riga: `(Tab. 9, §4.2, r.812)`. +4. Indica tabella e sezione, es. `(Tab. 9, §4.2)`; i numeri di riga servono solo per ritrovare il dato e non vanno stampati. Niente wikilink né nomi di pagine wiki nella risposta. 5. Confronta valori solo se ottenuti nelle stesse condizioni (solvente, tecnica, concentrazione, campione); altrimenti dichiara la differenza. 6. **Difetti noti** (`wiki/analyses/difetti-noti.md`, `difetti-dati.md`): PDI di 3b (Tab. 9) incoerente con Mw/Mn; % DPP di 3c (35 vs 36); bandgap delle Conclusioni (3,42-4,30 eV) incoerente con Tab. 14; correlazione «lineare» (r.1228) vs «non lineare con plateau». Se il dato richiesto ne ha uno, segnalalo e **non correggerlo**. 7. Procedure del cap. 3: riporta quantità e condizioni utili con rimando a paragrafo e righe, non riscrivere l'intera procedura. diff --git a/.agents/skills/tesi-figure/SKILL.md b/.agents/skills/tesi-figure/SKILL.md index e9d47a0..252770a 100644 --- a/.agents/skills/tesi-figure/SKILL.md +++ b/.agents/skills/tesi-figure/SKILL.md @@ -16,7 +16,10 @@ Sola lettura. Italiano. 1. Leggi la nota `wiki/figures/fig-NNN.md`: didascalia stampata, descrizione, testo visibile, contesto, righe di citazione, avvisi, «Pagine che la usano». 2. **Apri il file immagine**: il nome è nell'embed `![[immagini/.]]` della nota, il percorso reale è `raw/immagini/.`. Per figure a più pannelli apri tutti i pannelli rilevanti. Usa lo strumento di lettura immagini del tuo agente. 3. Descrivi ciò che vedi (struttura, reagenti, frecce, picchi, curve, assi, legenda) e collegalo al ragionamento della risposta; indica *cosa guardare* e *perché*. -4. Cita sempre il percorso `raw/immagini/.` e la nota `[[fig-NNN]]` perché l'utente possa aprirla, e **incorpora l'immagine** nella risposta con `![descrizione](raw/immagini/.)` (percorso relativo alla radice del repo): le interfacce che mostrano le immagini locali la visualizzano, le altre mostrano il testo alternativo. +4. **Incorpora l'immagine** nella risposta con `![descrizione](raw/immagini/.)` (percorso relativo alla radice del repo): le interfacce che mostrano le immagini locali la visualizzano, le altre mostrano il testo alternativo. Non ripetere il percorso né `[[fig-NNN]]` come testo; riferisci la figura col numero della tesi (es. «Fig. 27»). + +## Coerenza e posizione (priorità alta) +Inserisci un'immagine solo se: (1) l'hai guardata e corrisponde a ciò che affermi (composti, condizioni, assi, curve, campioni, valori) ed è la figura che la tesi cita per quel punto (`text_context` nella scheda); se c'è `caption_mismatch` usala solo per ciò che mostra davvero, dichiarandolo, oppure scegline un'altra; (2) è la più specifica disponibile (stesso composto, tecnica, campione), con il solo pannello pertinente se ne ha più d'uno; (3) è collocata **subito dopo** il paragrafo che ne discute il contenuto, mai in fondo alla risposta né raggruppata lontano dal suo argomento; (4) è preceduta da una frase che dice cosa mostra («Lo schema di sintesi (Fig. 27) mostra…») e seguita da un commento sugli elementi da guardare, con il numero di figura coincidente con quello incorporato; (5) non è ripetuta né decorativa. Se nessuna figura è coerente, non inserirne. ## Attendibilità - Solo `caption_printed` è testo della tesi. Descrizioni, `visible_text` e didascalie generate derivano dall'immagine e non sono verificate. diff --git a/.agents/skills/tesi-fonti/SKILL.md b/.agents/skills/tesi-fonti/SKILL.md index 6e7c0cf..4f2729c 100644 --- a/.agents/skills/tesi-fonti/SKILL.md +++ b/.agents/skills/tesi-fonti/SKILL.md @@ -9,6 +9,6 @@ Sola lettura. Italiano. 1. Elenco dei 63 riferimenti: `wiki/bibliografia.md` (link alle schede). Ogni scheda: `raw/fonti/NN-cognome-anno.md` (citazione verificata, DOI, abstract, frasi della tesi in cui è citato). Dati strutturati: `raw/bibliografia.json` (`text` è la fonte di verità, gli altri campi sono euristici). 2. Per «chi sostiene X»: trova nella wiki la pagina dell'argomento, leggi i `refs:` e le citazioni `[[NN-cognome-anno|N]]`, poi apri la scheda e `raw/tesi.md` alla riga di citazione. -3. Cita i riferimenti col numero della tesi, nella forma `[[01-bao-2020|1]]`, con la posizione `(§1.1.1, r.NNN)`. +3. Cita i riferimenti col solo numero della tesi, es. `[1]`, con la sezione `(§1.1.1)`. Niente wikilink, nomi di schede o numeri di riga nel testo per l'utente. 4. **Difetti noti** (`wiki/analyses/difetti-bibliografia.md`, `verifica-citazioni.md`): voce 44 duplicata della 1; voci 20, 22, 36, 54 incomplete o con testo spurio; voce 55 in formato RIS grezzo; DOI errati nelle voci 47, 48 (corretto 10.1080/15583720802231833) e 49; voci 47, 49, 54 non identificabili; tre riferimenti incrociati rotti in §3.3. Se la risposta si appoggia a una di queste voci, segnalalo senza correggere. 5. Non inventare autori, anni, DOI o contenuti di articoli: se la scheda non lo riporta, dillo. Ciò che sai del lavoro citato per conoscenza generale va marcato _(conoscenza generale)_ e resta nel perimetro della tesi. diff --git a/.agents/skills/tesi-narrate/SKILL.md b/.agents/skills/tesi-narrate/SKILL.md index c184f2a..8446732 100644 --- a/.agents/skills/tesi-narrate/SKILL.md +++ b/.agents/skills/tesi-narrate/SKILL.md @@ -13,8 +13,8 @@ Sola lettura: restituisci il testo in chat e non scrivere file salvo richiesta e ## Procedura 1. **Recupero.** Parti da `index.md`, `wiki/glossario.md`, `wiki/tesi.md`; leggi le pagine pertinenti (concetto, composto, tecnica, risultati) e i loro link. Escludi dalle fonti `index.md`, `log.md` e le pagine di sola navigazione. 2. **Registro delle affermazioni** (prima di scrivere). Per ogni affermazione: pagina wiki e posizione `tesi_loc`, e uno stato: _fatto della tesi_, _inferenza_ (collegamento tuo tra pagine) o _conflitto_ (pagine o difetti noti discordanti). -3. **Redazione.** Ogni frase fattuale ha accanto la citazione `[[pagina]]` con `(§, Tab./Fig., r.N)`. Dati copiati alla lettera. Le inferenze sono marcate _(inferenza)_, i conflitti _(conflitto)_ con le citazioni di tutte le parti. L'integrazione dalla conoscenza generale è ammessa solo per spiegare e resta nel perimetro della tesi: va marcata _(conoscenza generale)_ e mai usata per colmare una lacuna di dati. Se la tesi non riporta qualcosa, omettilo e nominalo in «Copertura». -4. **Figure.** Includi quelle che chiariscono l'argomento (di norma 1-4), guardate sul file in `raw/immagini/`, con percorso e scheda `[[fig-NNN]]` e le avvertenze delle figure con flag. +3. **Redazione.** Ogni frase fattuale indica la posizione in forma breve, `(§, Tab./Fig.)`, senza wikilink, nomi di pagine o numeri di riga. Dati copiati alla lettera. Le inferenze sono marcate _(inferenza)_, i conflitti _(conflitto)_ con le citazioni di tutte le parti. L'integrazione dalla conoscenza generale è ammessa solo per spiegare e resta nel perimetro della tesi: va marcata _(conoscenza generale)_ e mai usata per colmare una lacuna di dati. Se la tesi non riporta qualcosa, omettilo e nominalo in «Copertura». +4. **Figure.** Includi quelle che chiariscono l'argomento (di norma 1-4), guardate sul file in `raw/immagini/`, incorporate come `![descrizione](raw/immagini/.)` e con le avvertenze a parole per le figure con flag. ## Registri (sezioni, nell'ordine) - **briefing** (orientamento rapido, conclusione prima delle prove): Sintesi · Evidenze chiave · Implicazioni · Questioni aperte. @@ -26,6 +26,6 @@ Il registro cambia stile e ordine, non il confine dei fatti. ## Uscita 1. Titolo con argomento e registro. 2. Le sezioni del registro. -3. `## Copertura`: pagine citate, numero di affermazioni _(inferenza)_ e _(conoscenza generale)_, difetti noti rilevanti, lacune (ciò che la tesi non riporta). +3. `## Copertura`: argomenti e sezioni della tesi coperti (senza nomi di pagine wiki), numero di affermazioni _(inferenza)_ e _(conoscenza generale)_, difetti noti rilevanti, lacune (ciò che la tesi non riporta). Se non esistono pagine pertinenti, dillo e non produrre il documento. Se l'evidenza è debole o contraddittoria, scrivi solo la parte sostenuta e segnala il resto. diff --git a/.agents/skills/tesi-query/SKILL.md b/.agents/skills/tesi-query/SKILL.md index 1780bb5..be789bf 100644 --- a/.agents/skills/tesi-query/SKILL.md +++ b/.agents/skills/tesi-query/SKILL.md @@ -16,7 +16,7 @@ La wiki in `wiki/` è già costruita: **sola lettura**. Non modificare nulla (`w 6. Il riassunto di tesi è una seconda fonte: `wiki/riassunto-tesi.md`, `wiki/analyses/riassunto-vs-tesi.md`. ## 2. Immagini -Se la domanda riguarda strutture, schemi, meccanismi, spettri, grafici o morfologia, applica la skill **tesi-figure**: trova le figure, **guardale** (apri il file in `raw/immagini/`), spiegale e cita il percorso. +Se la domanda riguarda strutture, schemi, meccanismi, spettri, grafici o morfologia, applica la skill **tesi-figure** (le immagini vanno inserite solo se coerenti con il testo e nel punto in cui se ne discute il contenuto): trova le figure, **guardale** (apri il file in `raw/immagini/`), spiegale e cita il percorso. ## 3. Sintesi e integrazione - Parti da ciò che dice la tesi (dati esatti, condizioni, citazioni), poi arricchisci con la conoscenza generale per spiegare *perché* e *come* (meccanismi, definizioni, ordini di grandezza). @@ -28,10 +28,10 @@ Se la domanda riguarda strutture, schemi, meccanismi, spettri, grafici o morfolo Risposte **approfondite e complete**, non sintetiche (salvo richiesta esplicita di brevità). Copri tutte le dimensioni: definizione e contesto, meccanismo o motivazione chimico-fisica, dati e condizioni, confronto tra composti o campioni, risultati e interpretazione della tesi, limiti, difetti noti, collegamenti con altre sezioni e con la research question. Leggi tutte le pagine pertinenti prima di scrivere; spiega il significato di ogni risultato invece di elencarlo; riporta i valori rilevanti (anche in tabella) con unità e condizioni; usa e commenta in dettaglio le figure che chiariscono. Non troncare per brevità né rimandare alla tesi al posto di spiegare; se la risposta è lunga, struttura con titoli e chiudi con una sintesi dei punti chiave. Ciò che la tesi non riporta resta dichiarato come lacuna. ## Forma -Apri con una risposta diretta in 2-4 righe, poi sviluppa in modo esteso con titoli brevi: concetto → dati/risultati → meccanismo → collegamenti con altre parti → limiti e avvertenze. Tabelle per confronti, LaTeX per le formule. Chiudi con «Per approfondire» (pagine `[[...]]`). +Apri con una risposta diretta in 2-4 righe, poi sviluppa in modo esteso con titoli brevi: concetto → dati/risultati → meccanismo → collegamenti con altre parti → limiti e avvertenze. Tabelle per confronti, LaTeX per le formule. Chiudi con una sintesi dei punti chiave. ## Citazioni e dati -- Ogni affermazione non banale dalla tesi cita la posizione, es. `(§4.2, Tab. 14, r.812)`, e la pagina wiki; riferimenti bibliografici nella forma `[[01-bao-2020|1]]` (numero della tesi). +- **Output pulito:** nel testo per l'utente niente wikilink `[[...]]`, nomi di pagine o file della wiki, percorsi, numeri di riga né liste «Per approfondire»: sono strumenti di lavoro. Indica solo la posizione nella tesi in forma breve, es. `(§4.2, Tab. 14)`, e i riferimenti bibliografici col solo numero, es. `[1]`. Le figure compaiono come immagine incorporata, senza ripetere il percorso come testo. Vedi «Cosa mostrare nella risposta» in `CLAUDE.md`. - **Copia alla lettera** valori, unità, condizioni, formule e sigle; non convertire né arrotondare. Non confrontare valori di condizioni diverse senza dirlo. - Segnala i difetti noti senza correggerli. Mai inventare dati, fonti o numeri di figura/tabella. - Procedure del cap. 3: riporta solo i dati utili con rimando a paragrafo e righe. diff --git a/CLAUDE.md b/CLAUDE.md index c391371..252cb7d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -51,10 +51,18 @@ Le pagine **hub** hanno una sezione `## Struttura` con le sottopagine (es. `cicl ### 2. Retrieval delle immagini (ogni volta che la domanda tocca struttura, schema, spettro, grafico, meccanismo, morfologia) 1. Individua le figure rilevanti da `figure-indice.md`, dalle pagine lette (campo `figures`, link `[[fig-NNN]]`) o con Grep in `wiki/figures/`. 2. Leggi la nota `wiki/figures/fig-NNN.md` (didascalia stampata, descrizione, testo visibile, contesto, righe di citazione, avvisi) e poi **guarda l'immagine**: apri con Read il file in `raw/immagini/` indicato nell'embed `![[immagini/]]` della nota (per le figure a più pannelli, tutti i pannelli rilevanti). Le figure del riassunto sono `ris-fig-NN`. -3. Usa le figure per **spiegare**: descrivi cosa si vede (struttura, picchi, curve, frecce di reazione, legenda) e collega ogni elemento al ragionamento della risposta. Cita sempre il percorso del file, così l'utente può aprirla: `raw/immagini/` (e la nota `[[fig-NNN]]`). **Incorpora anche l'immagine nella risposta** con la sintassi Markdown `![descrizione](raw/immagini/.)` (percorso relativo alla radice del repo, senza spazi): le interfacce che mostrano le immagini locali (es. agent-wiki-ui) la visualizzano; le altre mostrano il testo alternativo. Non limitarti a elencare i numeri di figura. -4. Scegli le figure con giudizio: quelle che chiariscono davvero la risposta (di norma 1-4; di più solo se la domanda è un percorso completo, es. l'intera sintesi). Se non c'è una figura utile, non forzarla. +3. Usa le figure per **spiegare**: descrivi cosa si vede (struttura, picchi, curve, frecce di reazione, legenda) e collega ogni elemento al ragionamento della risposta. **Incorpora l'immagine nella risposta** con la sintassi Markdown `![descrizione](raw/immagini/.)` (percorso relativo alla radice del repo, senza spazi): le interfacce che mostrano le immagini locali (es. agent-wiki-ui) la visualizzano; le altre mostrano il testo alternativo. Non limitarti a elencare i numeri di figura; non stampare il percorso né il nome della nota come testo. +4. Scegli le figure con giudizio (vedi «Coerenza e posizione delle immagini» qui sotto): quelle che chiariscono davvero la risposta (di norma 1-4; di più solo se la domanda è un percorso completo, es. l'intera sintesi). Se non c'è una figura utile, non forzarla. 5. **Attendibilità delle figure:** solo `caption_printed` è testo della tesi; descrizioni, `visible_text` e didascalie generate derivano dall'immagine e non sono verificate. Valori letti da grafici/schemi (rese, picchi, potenziali) vanno confermati su tesi/tabelle prima di darli per certi, o presentati come «letti dalla figura». Figure con `flags`/`review_notes` (Fig. 26, 27, 29, 58, 66, 67, 69 con discrepanze didascalia/testo; note anche su 62, 76, 52 e `fig-x-94f3f4`): citale **con l'avvertenza**. +### Coerenza e posizione delle immagini (priorità alta) +Un'immagine fuori posto o poco pertinente peggiora la risposta: inseriscila solo se soddisfa **tutte** queste condizioni. +1. **Coerenza con il contenuto.** Prima di usarla, guardala davvero e confrontala con ciò che stai affermando: composti, reagenti, condizioni, assi, curve, campioni e valori nell'immagine devono corrispondere a quelli del paragrafo. Verifica anche che la figura sia quella citata dalla tesi per quel punto (campo `text_context` e righe di citazione nella nota). Se descrizione, didascalia e immagine non coincidono (flag `caption_mismatch`), usa la figura solo per ciò che mostra davvero e dillo a parole, oppure scegline un'altra. +2. **Scelta della figura giusta.** Tra più candidate preferisci quella che mostra *esattamente* ciò che stai spiegando (stesso composto, stessa tecnica, stesso campione) rispetto a una generica sull'argomento. Se la figura ha più pannelli o più campioni, incorpora il pannello pertinente e indica a parole quale guardare. Se nessuna figura è davvero coerente, **non inserirne**. +3. **Posizione.** Collocala nel punto in cui il testo discute ciò che l'immagine mostra: **subito dopo** il paragrafo (o la frase) che la introduce, mai in fondo alla risposta, mai raggruppata con altre figure lontane dal loro argomento, mai prima di aver detto di cosa si parla. Una figura per volta, ciascuna nella sezione del proprio argomento. +4. **Aggancio al testo.** La frase che precede dice cosa sta per essere mostrato (es. «Lo schema di sintesi (Fig. 27) mostra…»); subito dopo l'immagine commenta gli elementi da guardare (struttura, frecce, picchi, curve, legenda) e collegali al ragionamento. Il numero di figura citato nel testo deve coincidere con quello della figura incorporata. +5. **Una figura, un compito.** Non ripetere la stessa figura e non inserirne per semplice decorazione. + ### 3. Sintesi e integrazione con la conoscenza del modello Dopo il retrieval, costruisci la risposta più **articolata e completa** possibile: - **Parti dalla wiki**: ciò che la tesi afferma, con i dati esatti, le condizioni e le citazioni. @@ -64,6 +72,14 @@ Dopo il retrieval, costruisci la risposta più **articolata e completa** possibi - Se la conoscenza generale e la tesi divergono, riporta la tesi, segnala la divergenza e non correggerla in silenzio. - Se la wiki e `raw/tesi.md` non contengono l'informazione, dillo chiaramente («la tesi non riporta…») e distingui cosa puoi dire con conoscenza generale dentro il perimetro. +## Cosa mostrare nella risposta (priorità alta) +La risposta è un testo strutturato e di contenuto, non un elenco di rimandi interni. Wikilink, pagine wiki, percorsi di file e righe sono strumenti di **lavoro**: servono per recuperare e verificare, non vanno stampati. Nel testo visibile all'utente: +- **Niente** wikilink (`[[...]]`), nomi di pagine o file della wiki (`rop-pcl`, `fig-026`, `wiki/...`, `raw/...`), percorsi, numeri di riga (`r.646-660`), campi `tesi_loc`, e niente liste «Per approfondire» o «Collegamenti» con pagine wiki. +- **Sì**, in forma breve, la posizione nella tesi utile a ritrovare il dato: sezione, tabella, figura o equazione, es. `(§3.2, Tab. 5, Fig. 27)`, e i riferimenti bibliografici col solo numero della tesi, es. `[1]`. +- Le figure compaiono **solo come immagine incorporata** `![descrizione](raw/immagini/.)` con la spiegazione nel testo; il percorso resta nella sintassi dell'immagine e non va ripetuto come testo. Le avvertenze sulle figure con discrepanze si scrivono a parole («la didascalia stampata non coincide con il contenuto»). +- I difetti noti si segnalano a parole (cosa è incoerente e dove nella tesi), senza citare le pagine di analisi. +- Questa regola prevale su ogni indicazione contraria più sotto e nelle skill (`tesi-*`). + ## Profondità e completezza (priorità alta) Le risposte devono essere **approfondite e complete**, non sintetiche. Salvo che l'utente chieda esplicitamente una risposta breve, adotta per default la forma estesa: - **Copri tutte le dimensioni della domanda:** definizione e contesto, meccanismo o motivazione chimico-fisica, dati e condizioni sperimentali, confronto tra composti o campioni, risultati e interpretazione data dalla tesi, limiti, difetti noti, collegamenti con altre sezioni e con la research question (ACQ, integrità elettrochimica del core DPP). @@ -78,14 +94,14 @@ Le risposte devono essere **approfondite e complete**, non sintetiche. Salvo che - Struttura con titoli e sottotitoli brevi; apri con una **risposta diretta** (2-4 righe), poi sviluppa: contesto/concetto → dati e risultati → meccanismo/spiegazione → collegamenti con altre parti della tesi → limiti e avvertenze. Adatta la profondità alla domanda, ma privilegia completezza e chiarezza. - Tabelle per confronti e serie di valori; formule in LaTeX; elenchi puntati per passaggi sequenziali. - Le figure compaiono dove servono, con una frase che dice *cosa guardare* e *perché*. -- Chiudi con una riga «Per approfondire» con le pagine wiki più utili (`[[...]]`) e, se pertinente, domande collegate. +- Chiudi con una sintesi dei punti chiave e, se pertinente, qualche domanda collegata (senza rimandi a pagine wiki). ## Citazioni e fedeltà dei dati -- **Ogni affermazione non banale dalla tesi cita la posizione**: `(§4.2, Tab. 14, r.812)` e, se serve, il riferimento bibliografico `[[01-bao-2020|1]]` (numero della tesi). Usa `tesi_loc` delle pagine come localizzatore; i numeri di riga riferiscono `raw/tesi.md`. Cita anche la pagina wiki da cui hai preso l'informazione. +- **Ogni affermazione non banale dalla tesi indica la posizione** in forma breve, `(§4.2, Tab. 14)`, e se serve il riferimento bibliografico col numero della tesi, `[1]`. Per ritrovare il dato usa `tesi_loc` e i numeri di riga di `raw/tesi.md` **solo internamente**: non vanno stampati (vedi «Cosa mostrare nella risposta»). - **Copia alla lettera** valori, unità, condizioni (T, P, solvente, tempo, carico, resa/conversione), formule, nomi di composti e sigle (DPP, 3HT, ROP, PCL, ACQ, CV, GPC…). Non convertire, arrotondare o riassumere dati sperimentali. Decimali con la virgola come nella tesi; eccezioni: Abstract, dati NMR, liste, DOI, dove si copia com'è. - Valori da condizioni diverse (solvente, concentrazione, tecnica, campione) non vanno confrontati senza dirlo. - **Difetti noti** (hub `wiki/analyses/difetti-noti.md`): se un dato su cui ti basi ne ha uno, segnalalo e non correggerlo. Esempi: PDI di 3b (Tab. 9) incoerente con Mw/Mn; % DPP di 3c (35 vs 36); bandgap delle Conclusioni (3,42-4,30 eV) incoerente con Tab. 14; correlazione «lineare» (r.1228) vs «non lineare con plateau» (Conclusioni, §4.4.3); voce bibliografica 44 duplicata della 1; DOI errati nelle voci 47, 48, 49; tre riferimenti incrociati rotti in §3.3. -- **Procedure sperimentali (cap. 3):** riporta i dati necessari alla domanda con rimando a paragrafo e righe; non riscrivere l'intera procedura salvo richiesta esplicita. +- **Procedure sperimentali (cap. 3):** riporta i dati necessari alla domanda con rimando al paragrafo (§); non riscrivere l'intera procedura salvo richiesta esplicita. - **Sicurezza:** nessuna procedura di sintesi pericolosa oltre quanto riporta la tesi; segnala i pericoli noti dei reagenti se citati. - Mai inventare dati, fonti, numeri di figura/tabella o citazioni. Se non sai, dillo. diff --git a/README.md b/README.md index 4175e50..1e36fc2 100644 --- a/README.md +++ b/README.md @@ -172,7 +172,7 @@ flowchart LR Solo la didascalia stampata è testo della tesi; il resto deriva dall'immagine e **non è verificato**. _Non è registrato nel repository quale modello abbia prodotto descrizioni e revisione._ -**Uso nelle risposte.** L'agente arriva alla figura dai link nelle pagine già lette, da `figure-indice.md` o cercando per composto o concetto nelle schede. Poi apre il file in `raw/immagini/` e lo guarda davvero, perché la sola descrizione generata non basta a spiegare un grafico; infine lo commenta (cosa guardare e perché) citando percorso e scheda `[[fig-NNN]]`. I valori letti da un grafico vanno confermati sulla tesi. Regole complete in [`tesi-figure`](.agents/skills/tesi-figure/SKILL.md). +**Uso nelle risposte.** L'agente arriva alla figura dai link nelle pagine già lette, da `figure-indice.md` o cercando per composto o concetto nelle schede. Poi apre il file in `raw/immagini/` e lo guarda davvero, perché la sola descrizione generata non basta a spiegare un grafico; infine la incorpora nella risposta come immagine e la commenta (cosa guardare e perché), senza stampare percorsi o nomi di schede. I valori letti da un grafico vanno confermati sulla tesi. Regole complete in [`tesi-figure`](.agents/skills/tesi-figure/SKILL.md). ## Come risponde a una domanda @@ -208,7 +208,7 @@ Esempio illustrativo (non è una risposta registrata) con la domanda «Perché i | 4 | Trova la figura pertinente, apre il file in `raw/immagini/` e ne descrive il contenuto. | | 5 | Spiega prima ciò che dice la tesi, con citazioni, poi il meccanismo con la conoscenza generale marcata. | -- **Prima la tesi, poi l'integrazione.** I dati vengono dalla wiki e dalla tesi, con posizione (`§4.2, Tab. 14, r.812`) e riferimento bibliografico. La conoscenza generale del modello spiega perché e come, ed è marcata _(conoscenza generale)_; le deduzioni sono _(inferenza)_. +- **Prima la tesi, poi l'integrazione.** I dati vengono dalla wiki e dalla tesi, con la posizione in forma breve (`§4.2, Tab. 14`) e il riferimento bibliografico. Link e nomi di pagine della wiki, percorsi e numeri di riga restano interni e non compaiono nel testo. La conoscenza generale del modello spiega perché e come, ed è marcata _(conoscenza generale)_; le deduzioni sono _(inferenza)_. - **Perimetro.** L'integrazione resta dentro gli argomenti della tesi; fuori perimetro l'agente dice che la tesi non li tratta. - **Fedeltà dei dati.** Valori, unità e condizioni copiati alla lettera; valori di condizioni diverse non sono confrontati senza avviso.