Risposte senza riferimenti wiki; regole di coerenza e posizione delle immagini

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5.5 committed 2026-10-20 15:00:23 +02:00
1 parent 8785d7429d
commit 07d25de49c
7 files changed
+35 -16

No files matched your search

+21 -5
View File
@@ -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/<hash>` indicato nell'embed `![[immagini/<hash>]]` 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/<hash>` (e la nota `[[fig-NNN]]`). **Incorpora anche l'immagine nella risposta** con la sintassi Markdown `![descrizione](raw/immagini/<hash>.<ext>)` (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/<hash>.<ext>)` (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/<hash>.<ext>)` 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.