Skill di consultazione: protocollo di retrieval, mappa, ricette e checklist; regole su lingua, completezza, figure e tabelle
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5.5 committed
1 parent
07d25de49c
commit
533f735155
11 files changed
+254
-67
No files matched your search
@@ -1,17 +1,27 @@
|
||||
---
|
||||
name: tesi-dati
|
||||
description: Recupera valori sperimentali esatti della tesi (rese, Mn/Mw/PDI, % DPP, lunghezze d'onda, potenziali, band gap, condizioni di reazione, quantità) dalle tabelle e dal testo, con localizzatore e avvertenze sui difetti noti. Usala per domande numeriche, confronti tra campioni (3a, 3b, 3c, bottle brush) o richieste di una tabella/procedura.
|
||||
description: Recupera valori sperimentali esatti della tesi (rese, Mn/Mw/PDI, % DPP, lunghezze d'onda, potenziali, band gap, tempi di vita, condizioni di reazione, quantità) dalle tabelle e dal testo, con unità, condizioni, confronti omogenei e avvertenze sui difetti noti. Usala per domande numeriche, confronti tra campioni (3a, 3b, 3c, bottle brush), richieste di una tabella o di una procedura.
|
||||
---
|
||||
|
||||
# tesi-dati — valori e tabelle esatti
|
||||
# tesi-dati — valori e tabelle esatti, con contesto
|
||||
|
||||
Sola lettura. Italiano.
|
||||
Sola lettura. Italiano. Protocollo generale e ricette: `../tesi-query/references/` (`protocollo-retrieval.md`, `ricette-ricerca.md`).
|
||||
|
||||
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. 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.
|
||||
8. Interpretazioni (trend, confronti) sono _(inferenza)_; spiegazioni da conoscenza generale sono _(conoscenza generale)_ e restano nel perimetro della tesi. Se il dato non c'è, dillo.
|
||||
## 1. Localizza
|
||||
1. Identifica **grandezza**, **campioni** (attenzione: `1`, `2` e `3a-3c`, `3.1b-3.3c` del cap. 3-4 non sono i composti 1-48 del cap. 1), **tecnica** e **condizioni** richieste.
|
||||
2. Cerca in `wiki/dati.md` (grandezza → pagina con intervalli), `wiki/tabelle-indice.md` (15 tabelle e 12 equazioni), `wiki/campioni.md` (campione × tecnica). Se la grandezza non compare, grep in `wiki/` e in `raw/tesi.md` con sinonimi (es. Mn / peso molecolare medio numerale; λmax / massimo di assorbimento; Eg / bandgap / band gap).
|
||||
3. Una tabella sta in **una sola** pagina (le altre rimandano): apri quella e poi `raw/tesi.md` alle righe di `tesi_loc` (ricetta `sed -n`) per il valore esatto.
|
||||
|
||||
## 2. Verifica
|
||||
- Leggi il valore **in `raw/tesi.md`** (non solo nella wiki), con riga d'intestazione, unità e note della tabella.
|
||||
- Raccogli le **condizioni**: solvente, tecnica, concentrazione, temperatura, scan rate, elettrodo di riferimento, stato (soluzione/film), campione. Una stessa grandezza può comparire in più tabelle con condizioni diverse (es. soluzione vs film, CV vs ottico): riportale separate.
|
||||
- Cerca nel testo la **discussione** del dato (cosa significa, trend, confronto con P3HT o riferimenti) e nel riassunto (`raw/riassunto_tesi.md`) per eventuali differenze.
|
||||
- Controlla i **difetti noti** (`wiki/analyses/difetti-dati.md`, `difetti-noti.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» (Conclusioni, §4.4.3). Se il dato richiesto ne ha uno, segnalalo e **non correggerlo**.
|
||||
|
||||
## 3. Riporta
|
||||
- **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 e condizioni CV). Nessuna conversione, nessun arrotondamento.
|
||||
- **Ogni tabella citata o utile va riprodotta** nella risposta in Markdown, con intestazioni, valori, unità e note alla lettera (tutte le righe e colonne rilevanti, dichiarando cosa ometti). Indica tabella e sezione, es. `(Tab. 9, §4.2)`; i numeri di riga e i nomi delle pagine wiki non vanno stampati.
|
||||
- **Confronti:** costruisci una tabella con i campioni sulle righe e le grandezze sulle colonne; confronta solo valori ottenuti nelle stesse condizioni, altrimenti dichiara la differenza; se un campione non ha il dato, scrivilo.
|
||||
- **Interpretazione:** dopo i numeri, spiega cosa dicono (trend con la composizione, effetto del PCL, confronto con P3HT): ciò che dice la tesi, poi la spiegazione dalla conoscenza generale _(conoscenza generale)_ dentro il perimetro, le tue deduzioni _(inferenza)_. Collega alla research question quando pertinente.
|
||||
- **Procedure del cap. 3:** riporta quantità, condizioni e tempi utili alla domanda, con rimando al paragrafo; non riscrivere l'intera procedura salvo richiesta.
|
||||
- Se il dato non c'è, dillo dopo aver cercato con più formulazioni.
|
||||
@@ -1,30 +1,42 @@
|
||||
---
|
||||
name: tesi-figure
|
||||
description: Trova, apre e spiega le figure della tesi (80 della tesi e 11 del riassunto: strutture, schemi di sintesi, meccanismi, spettri UV-Vis/fluorescenza/NMR/FT-IR, GPC, DSC, voltammogrammi) per illustrare una risposta. Usala quando la domanda riguarda una figura, uno schema o un grafico, o quando un'immagine chiarirebbe la spiegazione.
|
||||
description: Trova, valuta, apre e spiega le figure della tesi (80 della tesi e 11 del riassunto: strutture, schemi di sintesi, meccanismi, spettri UV-Vis/fluorescenza/NMR/FT-IR, GPC, DSC, voltammogrammi, foto) scegliendo quella più coerente con la risposta e inserendola nel punto giusto con la descrizione. Usala quando la domanda riguarda una struttura, uno schema, un meccanismo o un grafico, o quando un'immagine chiarirebbe la spiegazione.
|
||||
---
|
||||
|
||||
# tesi-figure — retrieval e spiegazione delle immagini
|
||||
# tesi-figure — retrieval, scelta e spiegazione delle immagini
|
||||
|
||||
Sola lettura. Italiano.
|
||||
Sola lettura. Italiano. Ricette di ricerca: `../tesi-query/references/ricette-ricerca.md`.
|
||||
|
||||
## Trovare le figure
|
||||
1. Per numero: `wiki/figures/fig-NNN.md` (es. Fig. 27 → `fig-027`). Figure del riassunto: `ris-fig-NN`; schemi senza numero: `fig-x-<hash>`.
|
||||
2. Per argomento: `wiki/figure-indice.md` (figure per sezione) oppure grep in `wiki/figures/` su composto, concetto o parola chiave; i campi `composti`, `concetti`, `keywords` del frontmatter aiutano. Le pagine wiki che trattano l'argomento riportano `figures:` e link `[[fig-NNN]]`.
|
||||
3. Catalogo completo (pannelli, testo visibile): `raw/immagini.json`.
|
||||
## 1. Trova i candidati (più strade, poi unisci)
|
||||
1. **Dalle pagine lette:** campo `figures:` del frontmatter e link `[[fig-NNN]]` nelle pagine wiki dell'argomento.
|
||||
2. **Per sezione:** `wiki/figure-indice.md` (figure raggruppate per sezione della tesi, con tipo e avvisi).
|
||||
3. **Per entità:** grep in `wiki/figures/` su composto (`composti:`), concetto (`concetti:`), parole chiave e testo visibile; prova sinonimi IT/EN e le sigle.
|
||||
4. **Per numero** (se la domanda lo cita): `wiki/figures/fig-NNN.md` (es. 27 → `fig-027`). Figure del riassunto: `ris-fig-NN`; schemi senza numero stampato: `fig-x-<hash>`.
|
||||
5. **Dal testo:** le righe «Citata in tesi.md alle righe» e il «Contesto nel testo» della scheda dicono per quale affermazione la tesi usa la figura.
|
||||
6. Catalogo completo (pannelli, testo visibile): `raw/immagini.json`.
|
||||
|
||||
## Guardare l'immagine
|
||||
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/<hash>.<ext>]]` della nota, il percorso reale è `raw/immagini/<hash>.<ext>`. 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. **Incorpora l'immagine** nella risposta con `` (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»).
|
||||
## 2. Valuta e scegli
|
||||
Per ogni candidata leggi la scheda `wiki/figures/fig-NNN.md` (didascalia stampata, descrizione, testo visibile, tipo, contesto, righe di citazione, avvisi). Scegli in base a:
|
||||
- **specificità:** stesso composto, stessa tecnica, stesso campione della frase che stai scrivendo (meglio la figura esatta di una generica);
|
||||
- **corrispondenza col testo:** è la figura che la tesi usa per quel punto (`text_context`);
|
||||
- **tipo adatto:** struttura per «com'è fatto», schema di reazione per «come si ottiene», meccanismo per «perché», spettro/curva per «cosa si misura», foto per l'aspetto macroscopico;
|
||||
- **affidabilità:** niente flag `caption_mismatch` se esiste un'alternativa equivalente;
|
||||
- **non duplicare** il contenuto già mostrato da un'altra figura o tabella.
|
||||
Per un argomento articolato scegli **una figura per sotto-argomento** (di norma 1-4; di più per un percorso completo come l'intera sintesi). Se nessuna è davvero coerente, non inserirne.
|
||||
|
||||
## 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.
|
||||
## 3. Guarda l'immagine (obbligatorio)
|
||||
1. **Apri il file:** il nome è nell'embed `![[immagini/<hash>.<ext>]]` della scheda; il percorso reale è `raw/immagini/<hash>.<ext>`. Per figure a più pannelli apri tutti i pannelli rilevanti. Usa lo strumento di lettura immagini del tuo agente.
|
||||
2. **Verifica la coerenza:** composti, reagenti, condizioni, assi, curve, campioni e valori nell'immagine corrispondono a ciò che affermi? Se descrizione e immagine non coincidono, fidati dell'immagine e dichiaralo.
|
||||
3. Individua **cosa guardare**: struttura, frecce di reazione, picchi, curve, assi, legenda.
|
||||
|
||||
## Attendibilità
|
||||
## 4. Inserisci nella risposta
|
||||
- **Incorpora l'immagine** con `` (percorso relativo alla radice del repo): le interfacce che mostrano le immagini locali la visualizzano, le altre mostrano il testo alternativo. **Subito sotto** scrivi la descrizione di ciò che mostra (cosa rappresenta, composti, condizioni, elementi chiave), dalla scheda e da ciò che vedi, in parole tue.
|
||||
- **Non scrivere mai «Fig. N»/«Figura N»** né il percorso o `[[fig-NNN]]` come testo: nel testo rimanda a parole («lo schema qui sotto»). Una figura descritta ma non incorporata è un errore: prima di inviare controlla che ogni figura di cui parli abbia il suo ``.
|
||||
- **Posizione:** **subito dopo** il paragrafo che ne discute il contenuto, mai in fondo alla risposta né raggruppata lontano dal suo argomento; una per volta, ciascuna nella sezione del proprio argomento.
|
||||
- **Aggancio:** una frase prima dice cosa sta per essere mostrato («Lo schema di sintesi riportato qui sotto mostra…»); dopo l'immagine un commento sugli elementi da guardare, collegato al ragionamento.
|
||||
- Niente ripetizioni né figure decorative. Se la figura mostra più campioni o pannelli, incorpora il pannello pertinente e indica a parole quale guardare.
|
||||
|
||||
## 5. Attendibilità
|
||||
- Solo `caption_printed` è testo della tesi. Descrizioni, `visible_text` e didascalie generate derivano dall'immagine e non sono verificate.
|
||||
- Valori letti da grafici o schemi (rese, picchi, potenziali) vanno confermati su tesi/tabelle, o presentati come «letti dalla figura».
|
||||
- Figure con `flags`/`review_notes` (26, 27, 29, 58, 66, 67, 69: discrepanze didascalia/testo; note anche su 52, 62, 76 e `fig-x-94f3f4`): citale **con l'avvertenza**. Dettagli in `wiki/analyses/difetti-figure.md`.
|
||||
|
||||
## Scelta
|
||||
Usa le figure che chiariscono davvero (di norma 1-4; di più per un percorso completo come l'intera sintesi). Se nessuna è utile, non forzarla.
|
||||
- Valori letti da grafici o schemi (rese, picchi, potenziali) vanno confermati su tesi e tabelle, o presentati come «letti dalla figura».
|
||||
- Figure con `flags`/`review_notes` (26, 27, 29, 58, 66, 67, 69: discrepanze didascalia/testo; note anche su 52, 62, 76 e `fig-x-94f3f4`): usale **con l'avvertenza a parole** (es. «la didascalia stampata non coincide con il contenuto»). Dettagli in `wiki/analyses/difetti-figure.md`.
|
||||
@@ -1,14 +1,22 @@
|
||||
---
|
||||
name: tesi-fonti
|
||||
description: Risponde a domande sulla bibliografia della tesi e su chi sostiene cosa: identifica il riferimento citato (63 voci), mostra DOI, abstract e le frasi della tesi in cui è citato, segnala voci difettose. Usala per «chi ha proposto…», «da dove viene questo dato», «dove è citato il riferimento N».
|
||||
description: Risponde a domande sulla bibliografia della tesi e su chi sostiene cosa: identifica il riferimento citato (63 voci), cosa afferma, DOI, abstract e le frasi della tesi in cui è citato, verifica se la citazione regge, segnala voci difettose. Usala per «chi ha proposto…», «da dove viene questo dato», «dove è citato il riferimento N», «la fonte conferma quanto scritto?».
|
||||
---
|
||||
|
||||
# tesi-fonti — bibliografia e citazioni
|
||||
|
||||
Sola lettura. Italiano.
|
||||
Sola lettura. Italiano. Protocollo e ricette: `../tesi-query/references/`.
|
||||
|
||||
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 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.
|
||||
## Dove cercare
|
||||
- Elenco dei 63 riferimenti: `wiki/bibliografia.md`; ogni scheda `raw/fonti/NN-cognome-anno.md` (citazione verificata, DOI, abstract, frasi della tesi in cui è citato). Dati strutturati: `raw/bibliografia.json` (campi `cited_in_md_lines`, `cited_in_sections`; `text` è la fonte di verità, gli altri campi sono euristici).
|
||||
- Citazioni per sezione: ricetta in `ricette-ricerca.md` (Python su `cited_in_sections`).
|
||||
- Analisi esistenti: `wiki/analyses/verifica-citazioni.md` (citazioni confrontate con le schede: deboli, coerenti, non verificabili) e `difetti-bibliografia.md`.
|
||||
|
||||
## Procedura
|
||||
1. **Individua l'affermazione** (di chi è la tesi, di chi la fonte): trova la pagina dell'argomento, leggi i `refs:` e le citazioni nel testo; apri `raw/tesi.md` alla riga di citazione per vedere esattamente **quale frase** è attribuita al riferimento.
|
||||
2. **Apri la scheda** del riferimento: titolo, autori, anno, rivista, DOI, abstract e frasi della tesi che lo citano.
|
||||
3. **Valuta la corrispondenza** tra la frase della tesi e la fonte con `verifica-citazioni`: «coerente», «debole», «non verificabile oltre l'abstract». Riporta l'esito senza forzarlo.
|
||||
4. **Più fonti:** se un'idea poggia su più riferimenti (es. meccanismo di Iqbal, ROP con Sn(Oct)₂), elencali tutti con il ruolo di ciascuno (scoperta, meccanismo, miglioramento) e la sezione in cui compaiono.
|
||||
5. **Riporta** col solo numero della tesi, es. `[1]`, con la sezione `(§1.1.1)`, autori, anno e rivista presi dalla scheda; niente wikilink, nomi di schede o numeri di riga nel testo per l'utente.
|
||||
6. **Difetti noti** (`difetti-bibliografia.md`): voce 44 duplicata della 1; voci 20, 22, 36, 54 incomplete o con testo spurio; voce 55 in formato RIS grezzo (citata per dati del P3HT); 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.
|
||||
7. **Mai 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.
|
||||
@@ -11,9 +11,9 @@ Sola lettura: restituisci il testo in chat e non scrivere file salvo richiesta e
|
||||
`<argomento> [registro]`, con registro `briefing` (predefinito), `plain-language` o `lecturer`. Se l'argomento manca, chiedilo. Se il registro non è uno dei tre, elencali e non procedere.
|
||||
|
||||
## 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.
|
||||
1. **Recupero.** Applica il protocollo di `../tesi-query/references/protocollo-retrieval.md`: scomposizione dell'argomento in sotto-temi, espansione dei termini, ricerca a livelli, lettura integrale delle pagine e delle sottopagine, salti sui collegamenti, verifica su `raw/tesi.md`, controllo di sufficienza. Parti da `index.md`, `wiki/glossario.md`, `wiki/tesi.md` e da `../tesi-query/references/mappa-argomenti.md`; escludi dalle fonti `index.md`, `log.md` e le pagine di sola navigazione. Per un argomento ampio copri tutto il filo logico (contesto → meccanismo → dati → interpretazione → limiti).
|
||||
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 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».
|
||||
3. **Redazione.** Ogni frase fattuale indica la posizione in forma breve, `(§, Tab.)` (mai numeri di figura), 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 `` e con le avvertenze a parole per le figure con flag.
|
||||
|
||||
## Registri (sezioni, nell'ordine)
|
||||
|
||||
@@ -1,37 +1,35 @@
|
||||
---
|
||||
name: tesi-query
|
||||
description: Risponde a qualunque domanda sulla tesi «Sintesi e caratterizzazione di copolimeri bottle brush foto-elettro attivi» (DPP, P3HT, PCL, ROP, ACQ, UV-Vis, fluorescenza, CV, band gap, campioni 3a-3c, bottle brush) interrogando la wiki come un RAG, con risposta articolata, citazioni e figure. Usala per ogni domanda sulla tesi, sui suoi concetti, composti, tecniche o risultati.
|
||||
description: Risponde a qualsiasi domanda sulla tesi «Sintesi e caratterizzazione di copolimeri bottle brush foto-elettro attivi» (DPP, P3HT, PCL, ROP, ACQ, UV-Vis, fluorescenza, CV, band gap, campioni 3a-3c e bottle brush) con retrieval accurato e completo dalla wiki e dal testo originale, ragionamento argomentato, figure e tabelle mostrate. Usala per ogni domanda su concetti, meccanismi, sintesi, dati, confronti, risultati e verifica di affermazioni sulla tesi.
|
||||
---
|
||||
|
||||
# tesi-query — risposta RAG sulla wiki della tesi
|
||||
# tesi-query — retrieval accurato, completo e argomentato
|
||||
|
||||
La wiki in `wiki/` è già costruita: **sola lettura**. Non modificare nulla (`wiki/`, `raw/`, `index.md`, `log.md`) salvo richiesta esplicita. Rispondi in **italiano**; sigle, nomi di composti e titoli di fonti restano nella lingua originale. Le regole complete sono in `CLAUDE.md` alla radice del repo: leggilo se non l'hai già fatto.
|
||||
La wiki in `wiki/` è già costruita: **sola lettura** (non modificare `wiki/`, `raw/`, `index.md`, `log.md` salvo richiesta esplicita). Rispondi **sempre in italiano**, qualunque sia la lingua della domanda; sigle, nomi di composti e titoli di fonti restano nella lingua originale. Le regole generali di forma sono in `CLAUDE.md` alla radice: leggilo se non l'hai già fatto.
|
||||
|
||||
## 1. Retrieval (prima di scrivere)
|
||||
1. Individua composti, tecniche, concetti, campioni e sezioni coinvolti dalla domanda; se è ambigua, copri le letture plausibili.
|
||||
2. Parti da `index.md`; usa `wiki/glossario.md` (sigle), `wiki/dati.md` (grandezza → pagina), `wiki/campioni.md`, `wiki/tabelle-indice.md`, `wiki/tesi.md` (sezione → pagine). Cerca con grep sigle, numeri di composto, valori, sinonimi IT/EN.
|
||||
3. **Leggi per intero** le pagine pertinenti (concetto + composto + tecnica + pagina dei risultati) e segui i `[[wikilink]]` e `## Collegamenti`. Le pagine hub hanno `## Struttura` con le sottopagine: scendi a quella che contiene il dato.
|
||||
4. Per un valore, una tabella o una procedura apri `raw/tesi.md` alle righe di `tesi_loc` e copia il dato esatto.
|
||||
5. Controlla `wiki/analyses/difetti-noti.md` (e `difetti-dati/-figure/-bibliografia`) quando la domanda tocca dati, figure o bibliografia.
|
||||
6. Il riassunto di tesi è una seconda fonte: `wiki/riassunto-tesi.md`, `wiki/analyses/riassunto-vs-tesi.md`.
|
||||
File di supporto in `references/` (leggili quando servono, non a memoria):
|
||||
- `protocollo-retrieval.md` — **leggilo sempre**: scomposizione, espansione termini, ricerca a livelli, controllo di sufficienza, conflitti, argomentazione.
|
||||
- `mappa-argomenti.md` — dal tipo di domanda e dall'argomento alle pagine e alle righe della tesi.
|
||||
- `ricette-ricerca.md` — comandi grep/sed pronti.
|
||||
- `checklist-risposta.md` — controllo finale prima di inviare.
|
||||
|
||||
## 2. Immagini
|
||||
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).
|
||||
- **Perimetro:** l'integrazione resta dentro gli argomenti della tesi (DPP, tiofeni/P3HT e polimeri coniugati, polimerizzazione ossidativa, ROP/PCL, grafting-from/bottle brush, ACQ/aggregati H e J/fluorescenza, UV-Vis, NMR, FT-IR, GPC, DSC, CV e band gap). Domande fuori perimetro: di' che la tesi non le tratta.
|
||||
- Marca le aggiunte _(conoscenza generale)_ o in una sezione «Approfondimento»; le deduzioni _(inferenza)_. Mai attribuire alla tesi ciò che non c'è; se la tesi non riporta qualcosa, dillo.
|
||||
- Se conoscenza generale e tesi divergono, riporta la tesi e segnala la divergenza.
|
||||
## Procedura (sintesi; i dettagli sono nel protocollo)
|
||||
1. **Scomponi** la domanda in sotto-domande, riconosci il tipo (concetto, meccanismo, procedura, dato, confronto, risultato, verifica, bibliografia, figura) ed estrai entità e ambiguità. Attenzione alla doppia numerazione dei composti (cap. 1: 1-48; cap. 3-4: 1, 2, 3a-3c, 3.1b-3.3c).
|
||||
2. **Espandi i termini** (sigle ↔ nomi, italiano ↔ inglese, forme grafiche) e cerca a **livelli**: navigazione (`index.md`, `glossario`, `dati`, `campioni`, `tabelle-indice`, `tesi`) → ricerca testuale in `wiki/` → lettura **integrale** delle pagine (concetto + composto + tecnica + risultati, e sottopagine degli hub) → salti sui collegamenti (fino a due) → **verifica su `raw/tesi.md`** → riassunto → bibliografia → figure e tabelle.
|
||||
3. **Controllo di sufficienza:** una riga di registro per sotto-domanda (affermazione, evidenza, stato, verificata sulla fonte). Cerca anche ciò che potrebbe contraddire (difetti noti, incoerenze, tesi vs riassunto). Se manca evidenza, rifai la ricerca con altre parole chiave prima di dichiarare una lacuna.
|
||||
4. **Figure e tabelle:** applica la skill **tesi-figure** (immagini incorporate, coerenti, nel punto giusto) e, per valori e tabelle, **tesi-dati**; per le fonti **tesi-fonti**.
|
||||
5. **Argomenta e integra:** per i punti centrali segui affermazione → evidenza → spiegazione → limite. Parti da ciò che dice la tesi, poi spiega perché e come con la conoscenza generale, marcata _(conoscenza generale)_, **dentro il perimetro** della tesi (DPP, tiofeni/P3HT e polimeri coniugati, polimerizzazione ossidativa, ROP/PCL, grafting-from/bottle brush, ACQ/aggregati H e J/fluorescenza, UV-Vis, NMR, FT-IR, GPC, DSC, CV e band gap). Le deduzioni sono _(inferenza)_. Domande fuori perimetro: di' che la tesi non le tratta.
|
||||
6. **Controlla** con `references/checklist-risposta.md`.
|
||||
|
||||
## Profondità e completezza (priorità alta)
|
||||
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.
|
||||
Risposte **sempre le più complete possibile**, anche se non richiesto e anche se la domanda sembra semplice: anticipa ciò che l'utente chiederebbe subito dopo (definizioni dei termini usati, perché e come, dati, confronti, limiti, collegamenti) così che non servano altre domande, restando dentro gli argomenti della tesi. Mai risposte brevi o riassunte. 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. Spiega il significato di ogni risultato invece di elencarlo; riporta i valori rilevanti (anche in tabella) con unità e condizioni. Non troncare per brevità né rimandare alla tesi al posto di spiegare. 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 una sintesi dei punti chiave.
|
||||
|
||||
## Citazioni e dati
|
||||
- **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`.
|
||||
- **Figure e tabelle vanno mostrate (inderogabile):** le figure si incorporano con `` e **subito sotto** se ne scrive la descrizione; **non scrivere mai «Fig. N»/«Figura N»**, rimanda a parole («lo schema qui sotto»). Una figura descritta ma non incorporata è un errore: controlla prima di inviare. Le tabelle si riproducono in Markdown copiando intestazioni, valori, unità e note da `raw/tesi.md` (se lunga, tutte le righe e colonne rilevanti, dichiarando cosa ometti); se non puoi mostrarle, non citarle per numero.
|
||||
- **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)` (mai numeri di figura), e i riferimenti bibliografici col solo numero, es. `[1]`. 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.
|
||||
- Segnala i difetti noti senza correggerli. Mai inventare dati, fonti o numeri di tabella.
|
||||
- Procedure del cap. 3: riporta solo i dati utili con rimando al paragrafo.
|
||||
@@ -0,0 +1,29 @@
|
||||
# Checklist prima di inviare la risposta
|
||||
|
||||
**Copertura**
|
||||
- [ ] Ogni sotto-domanda ha una risposta o una lacuna dichiarata (e dichiarata dopo ricerche con almeno tre formulazioni diverse).
|
||||
- [ ] Ho anticipato le domande di approfondimento naturali (definizioni, perché/come, dati, confronti, limiti), restando nel perimetro della tesi.
|
||||
- [ ] Ho coperto i tipi di domanda coinvolti (concetto, meccanismo, dato, confronto, interpretazione).
|
||||
|
||||
**Accuratezza**
|
||||
- [ ] Ogni numero, unità, condizione, formula e sigla è copiato dalla tesi (`raw/tesi.md`) e verificato lì, non solo nella wiki.
|
||||
- [ ] Valori confrontati solo se nelle stesse condizioni; altrimenti la differenza è detta.
|
||||
- [ ] Doppia numerazione dei composti (cap. 1 vs cap. 3-4) non confusa.
|
||||
- [ ] Difetti noti pertinenti segnalati a parole, senza correggerli.
|
||||
- [ ] Tesi, riassunto e conoscenza generale non mescolati: le aggiunte sono marcate _(conoscenza generale)_ e le deduzioni _(inferenza)_.
|
||||
|
||||
**Argomentazione**
|
||||
- [ ] Per i punti centrali: affermazione → evidenza → spiegazione → limite.
|
||||
- [ ] Il collegamento con la research question è esplicito dove pertinente.
|
||||
- [ ] Le alternative o spiegazioni concorrenti sono considerate dove esistono.
|
||||
- [ ] Chiudo con una sintesi dei punti chiave.
|
||||
|
||||
**Figure e tabelle**
|
||||
- [ ] Ogni figura utile è incorporata con ``, nel punto in cui se ne parla, con la descrizione subito sotto; coerente con il testo; senza «Fig. N».
|
||||
- [ ] Ogni tabella citata o utile è riprodotta in Markdown con valori, unità e note alla lettera.
|
||||
- [ ] Nessun elemento è descritto come visibile se non è incorporato.
|
||||
|
||||
**Forma**
|
||||
- [ ] Italiano, qualunque sia la lingua della domanda.
|
||||
- [ ] Nessun wikilink, nome di pagina o file della wiki, percorso testuale o numero di riga nel testo.
|
||||
- [ ] Posizioni solo in forma breve (§, tabella); riferimenti bibliografici col solo numero `[N]`.
|
||||
@@ -0,0 +1,35 @@
|
||||
# Mappa: tipo di domanda e argomento → dove cercare
|
||||
|
||||
Percorsi relativi alla radice del repo. Le pagine hub elencano le sottopagine in `## Struttura`: leggi anche quelle.
|
||||
|
||||
## Per tipo di domanda
|
||||
| Tipo | Punti d'ingresso (in ordine) | Poi |
|
||||
|---|---|---|
|
||||
| Concetto / definizione | `wiki/glossario.md`, pagina del concetto in `wiki/concepts/` | collegamenti, figura, riferimenti (`refs:`) |
|
||||
| Meccanismo / perché | concetto in `wiki/concepts/` + sezione corrispondente di `raw/tesi.md` | tecnica che lo prova, composto, difetti noti |
|
||||
| Procedura / sintesi | `wiki/percorso-sintetico.md`, pagina del composto, `wiki/techniques/reagenti-e-materiali.md` | §3.2 di `raw/tesi.md` (condizioni esatte) |
|
||||
| Dato numerico | `wiki/dati.md`, `wiki/tabelle-indice.md`, `wiki/campioni.md` | pagina del dato → tabella in `raw/tesi.md` |
|
||||
| Confronto tra campioni | `wiki/campioni.md` + pagine dei campioni | tabelle di tutti i campioni, condizioni omogenee? |
|
||||
| Confronto tra tecniche | pagine in `wiki/techniques/` | cosa misura ciascuna, limiti, campioni su cui è usata |
|
||||
| Risultato e interpretazione | pagina dei risultati (`copolimeri-caratterizzazione`, `bottle-brush-proprieta`, `cv-risultati`, ...) | concetto che lo spiega, conclusioni (§5) |
|
||||
| Verifica di un'affermazione | pagine pertinenti + `raw/tesi.md` (grep) | difetti noti, riassunto-vs-tesi: esito «sostenuta / non sostenuta / contraddetta / non riportata» |
|
||||
| Origine / bibliografia | `wiki/bibliografia.md`, `raw/fonti/` | skill `tesi-fonti` |
|
||||
| Figura / schema / grafico | `wiki/figure-indice.md`, `wiki/figures/` | skill `tesi-figure` |
|
||||
| Visione d'insieme / «spiegami tutto» | `wiki/overview.md`, `wiki/tesi.md`, `wiki/percorso-sintetico.md` | tutte le pagine del filo logico, skill `tesi-narrate` |
|
||||
|
||||
## Per argomento
|
||||
| Argomento | Pagine |
|
||||
|---|---|
|
||||
| Progetto bottle brush, logica e risultati | `concepts/bottle-brush`, `concepts/grafting-from`, `concepts/acq-e-stato-solido`, `overview` |
|
||||
| DPP: struttura, proprietà, storia, sintesi | `concepts/dpp-struttura-e-proprieta`, `dpp-sintesi-letteratura` (+ `dpp-sintesi-farnum-iqbal`, `dpp-sintesi-vie-alternative`, `pseudo-stobbe`) |
|
||||
| DPP: reattività | `concepts/dpp-reattivita` (+ `dpp-reazioni-gruppi-ammidici`, `dpp-reazioni-anelli-aromatici`, `dpp-cross-coupling-pd`, `dpp-arilazione-litiazione-snar`) |
|
||||
| Fluorescenza | `concepts/fluorescenza` (+ `stokes-shift`, `resa-quantica`, `tempi-di-vita`), `fluorofori-in-polimeri`, `optoelettronica-oled-donatore-accettore` |
|
||||
| Stato solido, ACQ, aggregati | `concepts/acq-e-stato-solido`, `aggregati-h-j-kasha`, `caratterizzazione-stato-solido` |
|
||||
| Polimerizzazione, ROP | `concepts/polimerizzazione-ossidativa-fecl3`, `rop-pcl`, `grafting-from`, `p3ht` |
|
||||
| Elettrochimica | `techniques/ciclovoltammetria` (+ `cv-teoria`, `cv-analisi-onset`, `cv-risultati`), `concepts/band-gap-homo-lumo`, `irreversibilita-ec`, `compounds/dpp-2-voltammetria` |
|
||||
| Composti sperimentali | `compounds/dpp-1`, `dpp-2` (+ `dpp-2-n-alchilazione`, `dpp-2-voltammetria`), `copolimeri-3a-3b-3c` (+ `copolimeri-composizione-dpp`, `copolimeri-caratterizzazione`), `bottle-brush-3-x` (+ `bottle-brush-struttura`, `bottle-brush-proprieta`) |
|
||||
| Tecniche | `techniques/nmr-1h`, `ft-ir`, `gpc`, `uv-vis-fluorescenza`, `dsc`, `ciclovoltammetria`, `reagenti-e-materiali` |
|
||||
| Difetti e coerenza | `analyses/difetti-noti` (+ `difetti-dati`, `difetti-figure`, `difetti-bibliografia`), `verifica-citazioni`, `riassunto-vs-tesi` |
|
||||
|
||||
## Sezioni di `raw/tesi.md` (per leggere il testo originale con `sed -n`)
|
||||
Riassunto r.13 · Abstract r.25 · Sommario r.35 · **1** Introduzione r.66 (1.1 DPP r.69; 1.1.1 storia e sintesi r.84; 1.1.2 struttura e reattività r.203; 1.2 fluorescenza r.376; 1.2.1 Stokes r.418; 1.2.2 resa quantica r.429; 1.2.3 tempi di vita r.448; 1.3 fluorofori in polimeri r.477; 1.4 applicazioni r.500) · **2** Scopo r.543 · **3** Procedure sperimentali r.560 (3.1 materiali e metodi r.563; 3.2 sintesi e procedure r.584; 3.3 principi teorici della CV r.663; 3.4 procedure voltammetriche r.694) · **4** Discussione r.709 (4.1 DPP r.714; 4.2 copolimeri coniugati r.836; 4.3 bottle brush r.976; 4.4 ciclovoltammetrie r.1117 con 4.4.1 r.1124, 4.4.2 r.1135, 4.4.3 r.1190, 4.4.4 r.1247; 4.5 stato solido r.1271) · **5** Conclusioni r.1306 · Bibliografia r.1320. Ricontrolla con `grep -n "^#" raw/tesi.md` se il file è stato riallineato.
|
||||
@@ -0,0 +1,54 @@
|
||||
# Protocollo di retrieval (accurato, completo, argomentato)
|
||||
|
||||
Obiettivo: raccogliere **tutte** le evidenze pertinenti, verificarle sulla fonte e arrivare alla risposta con un ragionamento esplicito. Il lavoro (pagine, righe, percorsi) resta interno: nella risposta compare solo il contenuto utile (vedi `CLAUDE.md`, «Cosa mostrare nella risposta»).
|
||||
|
||||
## 1. Analizza e scomponi la domanda
|
||||
1. Riscrivi mentalmente la domanda come **sotto-domande** atomiche (cosa, perché, come, quanto, rispetto a cosa, con quali limiti). Una domanda articolata ha spesso 3-6 sotto-domande: ciascuna va coperta.
|
||||
2. Individua il **tipo** (anche più di uno): definizione/concetto · meccanismo/perché · procedura/sintesi · dato numerico · confronto (campioni, tecniche, ipotesi) · risultato e interpretazione · verifica di un'affermazione («è vero che…?») · origine/bibliografia · figura/schema. Il tipo decide i punti d'ingresso (tabella in `mappa-argomenti.md`).
|
||||
3. Estrai le **entità**: composti (attenzione alla doppia numerazione, sotto), campioni, tecniche, grandezze, condizioni, sezioni.
|
||||
4. **Ambiguità:** se la domanda ammette più letture plausibili, coprile tutte invece di scegliere; se manca un parametro (campione, tecnica), rispondi per tutti i casi disponibili e dì quali.
|
||||
|
||||
### Numerazione dei composti (fonte frequente di errore)
|
||||
- Cap. 1 (introduzione): composti **1-48** della letteratura. Cap. 3-4: **1** e **2** sono i DPP sperimentali, **3a-3c** i copolimeri, **3.1b-3.3c** i bottle brush (`3.1.b` = `3.1b`). I numeri coincidono ma sono cose diverse: usa il contesto (sezione, pagina) per distinguere e dichiaralo.
|
||||
|
||||
## 2. Espandi i termini di ricerca
|
||||
Per ogni entità prepara varianti, poi cercale tutte:
|
||||
- **Sigle ↔ nomi estesi** (`wiki/glossario.md`): DPP/dichetopirrolopirrolo, ACQ/Aggregation-Caused Quenching, ROP/ring-opening polymerization, PCL/policaprolattone, CV/ciclovoltammetria, Sn(Oct)₂/ottoato di stagno, PDI/PD, HOMO-LUMO/band gap/bandgap, FeCl₃/Fe(III), 3HT/P3HT/3-esiltiofene.
|
||||
- **Italiano ↔ inglese** (la tesi ha termini misti): resa quantica/quantum yield, shift di Stokes/Stokes shift, tempo di vita/lifetime, impaccamento/packing, innesto/grafting, spaziatore sterico/steric hindrance.
|
||||
- **Forme grafiche**: apici e pedici in HTML (`Sn(Oct)<sub>2</sub>`), LaTeX (`$E_g$`), accenti, decimali con virgola o punto, `3.1.b`/`3.1b`. Se un termine non dà risultati, prova la forma senza accenti e una radice (`fluoresc`).
|
||||
|
||||
## 3. Ricerca a livelli (dal generale al preciso)
|
||||
Esegui **tutti** i livelli utili, non fermarti al primo che risponde.
|
||||
1. **Navigazione:** `index.md` e le pagine di navigazione (`glossario`, `dati`, `campioni`, `tabelle-indice`, `tesi`, `percorso-sintetico`) per individuare le pagine candidate.
|
||||
2. **Ricerca testuale nella wiki:** sigle e parole chiave in `wiki/` (ricette in `ricette-ricerca.md`); includi `wiki/analyses/` per i difetti noti.
|
||||
3. **Lettura integrale** delle pagine candidate, non solo degli estratti: concetto + composto + tecnica + pagina dei risultati. Le pagine hub elencano le sottopagine in `## Struttura`: scendi in quelle che contengono il dato (tabelle ed equazioni stanno in **una sola** pagina).
|
||||
4. **Salti (multi-hop):** segui `## Collegamenti`, `refs:`, `figures:` e i link delle pagine lette fino a **due salti** se aggiungono evidenza (es. effetto → meccanismo → condizione sperimentale → tecnica di misura).
|
||||
5. **Verifica sulla fonte:** per ogni dato, tabella, formula o condizione apri `raw/tesi.md` alle righe di `tesi_loc` (`sed -n 'a,bp'`) e controlla; se la pagina wiki è in disaccordo con la tesi vale la tesi. Cerca anche con grep direttamente in `raw/tesi.md` per catturare ciò che la wiki non riporta.
|
||||
6. **Seconda fonte:** `raw/riassunto_tesi.md` e `wiki/riassunto-tesi.md` / `wiki/analyses/riassunto-vs-tesi.md` per confermare o segnalare differenze rispetto al riassunto.
|
||||
7. **Bibliografia:** se la domanda chiede «chi/da dove», o se il dato dipende da una fonte, usa `refs:` e `raw/fonti/` (skill `tesi-fonti`).
|
||||
8. **Figure e tabelle:** per ogni argomento che ha una rappresentazione visiva, cerca la figura (skill `tesi-figure`) e la tabella pertinente (`wiki/tabelle-indice.md`).
|
||||
|
||||
## 4. Controllo di sufficienza (prima di scrivere)
|
||||
Compila mentalmente un **registro** con una riga per sotto-domanda: affermazione · evidenza (dato/condizione/sezione) · stato (fatto della tesi / inferenza / conoscenza generale) · fonte verificata sì/no. Poi controlla:
|
||||
- ogni sotto-domanda ha almeno un'evidenza **verificata sulla fonte**, o è dichiarata lacuna;
|
||||
- ogni numero è stato letto in `raw/tesi.md` (non solo nella wiki) e ha unità e condizioni;
|
||||
- per i confronti, tutti gli elementi confrontati hanno il dato (altrimenti dillo) e le condizioni sono omogenee;
|
||||
- è stato cercato anche **ciò che potrebbe contraddire** la risposta (difetti noti, incoerenze tra pagine, tesi vs riassunto);
|
||||
- le figure e tabelle utili sono state trovate e verificate;
|
||||
- non restano termini usati nella risposta che l'utente potrebbe non capire senza definirli.
|
||||
Se manca evidenza, **torna al passo 3** con altre parole chiave prima di concludere che la tesi non lo riporta. Dichiara «la tesi non riporta…» solo dopo aver cercato con almeno tre formulazioni diverse sia nella wiki sia in `raw/tesi.md`.
|
||||
|
||||
## 5. Riconcilia conflitti
|
||||
- **Wiki ≠ tesi:** vale `raw/tesi.md`.
|
||||
- **Tesi ≠ tesi** (incoerenze interne): riporta entrambe le versioni con dove compaiono e segnala il difetto noto (`wiki/analyses/difetti-*`), senza scegliere né correggere.
|
||||
- **Tesi ≠ riassunto:** la tesi è la fonte primaria; segnala la differenza.
|
||||
- **Conoscenza generale ≠ tesi:** riporta la tesi, segnala la divergenza.
|
||||
- **Condizioni diverse:** valori ottenuti con solvente, tecnica, concentrazione o campione diversi non si confrontano senza dirlo.
|
||||
|
||||
## 6. Argomenta (struttura del ragionamento)
|
||||
Per ogni punto centrale della risposta usa la catena **affermazione → evidenza → spiegazione → limite**:
|
||||
1. *Affermazione:* ciò che si sostiene, in una frase.
|
||||
2. *Evidenza:* dato esatto con unità e condizioni, e dove la tesi lo mostra (§, tabella).
|
||||
3. *Spiegazione:* perché l'evidenza porta a quella conclusione (meccanismo chimico-fisico, logica sperimentale), con la conoscenza generale marcata _(conoscenza generale)_ dentro il perimetro della tesi.
|
||||
4. *Limite:* cosa l'evidenza non prova, condizioni di validità, difetti noti, alternative considerate dalla tesi o plausibili _(inferenza)_.
|
||||
Collega i punti alla **research question** (il bottle brush supera l'ACQ mantenendo l'integrità elettrochimica del core DPP?) quando pertinente. Per i confronti: criteri espliciti, tabella, esito per criterio, conclusione. Per i «perché»: meccanismo, prova nella tesi, controprova o alternativa.
|
||||
@@ -0,0 +1,37 @@
|
||||
# Ricette di ricerca (indipendenti dall'agente)
|
||||
|
||||
Usa gli strumenti nativi di ricerca e lettura del tuo agente, oppure la shell. Nei comandi `raw/tesi.md` è il testo originale, `wiki/` la wiki. Non modificare nulla.
|
||||
|
||||
## Trovare pagine
|
||||
- Parola o sigla in tutta la wiki (elenco file): `grep -rli "ACQ" wiki --include=*.md`
|
||||
- Con riga e contesto: `grep -rn -i -C2 "Sn(Oct)" wiki --include=*.md`
|
||||
- Parola intera (evita falsi positivi): `grep -rnw "DPP" wiki/concepts`
|
||||
- Più varianti: `grep -rniE "fluoresc|emission|emissione" wiki --include=*.md`
|
||||
- Per tag nel frontmatter: `grep -rl "^tags:.*bottle-brush" wiki`
|
||||
- Pagine che citano un riferimento bibliografico: `grep -rl "^refs:.*\b58\b" wiki`
|
||||
- Pagine che usano una figura: `grep -rl "fig-064" wiki --include=*.md`
|
||||
- Pagine di una sezione della tesi: `grep -rn "^tesi_loc:.*§4.3" wiki`
|
||||
|
||||
## Leggere il testo originale
|
||||
- Struttura della tesi: `grep -n "^#" raw/tesi.md`
|
||||
- Intervallo di righe (da `tesi_loc`): `sed -n '978,1000p' raw/tesi.md`
|
||||
- Cercare un termine nel testo originale, con contesto: `grep -n -i -C2 "reflusso" raw/tesi.md`
|
||||
- Una tabella per numero: `grep -n "Tabella 9" raw/tesi.md` poi `sed -n` dalla riga di intestazione fino alla fine delle righe `|`.
|
||||
- Un composto: `grep -n "3\.1\.\?b" raw/tesi.md` (copre `3.1b` e `3.1.b`).
|
||||
- Il riassunto: `grep -n -i "termine" raw/riassunto_tesi.md`
|
||||
|
||||
## Figure
|
||||
- Schede per composto o concetto: `grep -rl "composti:.*\"3b\"" wiki/figures` · `grep -rli "concetti:.*acq" wiki/figures`
|
||||
- Per parola chiave o testo visibile: `grep -rli "voltammogramma" wiki/figures`
|
||||
- Figure della sezione: `grep -n -A12 "§4.4.3" wiki/figure-indice.md`
|
||||
- File immagine di una scheda: `grep -o "immagini/[0-9a-f]*\.[a-z]*" wiki/figures/fig-020.md | head -1` → `raw/immagini/<file>`
|
||||
- Contesto in cui il testo la cita: campo «Contesto nel testo» nella scheda, e le righe elencate in «Citata in tesi.md alle righe».
|
||||
|
||||
## Bibliografia
|
||||
- Riferimenti citati in una sezione: `grep -n "cited_in_sections" raw/bibliografia.json` oppure, con Python, `python3 -c "import json;[print(r['id'],r['text']) for r in json.load(open('raw/bibliografia.json'))['references'] if '4.3' in r['cited_in_sections']]"`
|
||||
- Scheda di un riferimento: `raw/fonti/NN-cognome-anno.md`.
|
||||
|
||||
## Strategia
|
||||
1. Parti largo (sigla, radice di parola), poi restringi con la sezione o il composto.
|
||||
2. Se un grep non trova nulla, prova sinonimi IT/EN, la forma senza accenti, la radice, i pedici in HTML (`<sub>`), la forma LaTeX.
|
||||
3. Confronta sempre ciò che trovi nella wiki con `raw/tesi.md`: la wiki riorganizza, il testo originale prevale.
|
||||
@@ -5,7 +5,7 @@ Questo file definisce come rispondi alle domande sulla tesi. La wiki è **già c
|
||||
## Ruolo e limiti
|
||||
- **Utente**: pone domande sulla tesi. **Tu**: recuperi, integri, spieghi, mostri le figure.
|
||||
- **Sola lettura**: non modificare, creare, rinominare o cancellare nulla (`wiki/`, `raw/`, `scripts/`, `index.md`, `log.md`), a meno che l'utente lo chieda esplicitamente. Non lanciare ingest, lint o rigenerazioni. Se emerge un errore o una lacuna nella wiki, **segnalalo nella risposta**, non correggerlo.
|
||||
- Lingua: **italiano**. Sigle, nomi di composti, titoli di fonti e termini tecnici restano nella lingua originale.
|
||||
- Lingua: **sempre italiano**, qualunque sia la lingua della domanda e anche se l'utente non lo chiede. Sigle, nomi di composti, titoli di fonti e termini tecnici restano nella lingua originale.
|
||||
|
||||
## Dominio (perimetro degli argomenti)
|
||||
Tesi magistrale in Chimica Industriale (Università di Bologna, Dip. «Toso Montanari», a.a. 2025-2026): **«Sintesi e caratterizzazione di copolimeri bottle brush foto-elettro attivi»**, candidata Aurora Luzi, relatore Dr. Stefano Scurti.
|
||||
@@ -40,6 +40,7 @@ Le pagine **hub** hanno una sezione `## Struttura` con le sottopagine (es. `cicl
|
||||
## Procedura di risposta (per ogni domanda)
|
||||
|
||||
### 1. Retrieval (obbligatorio, prima di scrivere)
|
||||
**Protocollo esteso:** per ogni domanda segui `.agents/skills/tesi-query/references/protocollo-retrieval.md` (scomposizione in sotto-domande, espansione dei termini, ricerca a livelli, controllo di sufficienza, conflitti, argomentazione); `mappa-argomenti.md`, `ricette-ricerca.md` e `checklist-risposta.md` nella stessa cartella. I passi qui sotto ne sono la sintesi.
|
||||
1. Interpreta la domanda: individua composti, tecniche, concetti, campioni, sezioni coinvolte. Se è ambigua tra più letture plausibili, rispondi coprendole tutte invece di chiedere.
|
||||
2. Parti da `index.md` e, se serve, da `glossario.md`, `dati.md`, `campioni.md`, `tabelle-indice.md`, `tesi.md` per localizzare le pagine. Usa Grep sulla wiki per sigle, numeri di composto, valori, parole chiave (anche sinonimi e forme italiane/inglesi).
|
||||
3. **Leggi per intero** le pagine pertinenti (non solo gli estratti), seguendo i `[[wikilink]]` e `## Collegamenti`: per una domanda articolata leggi tipicamente il concetto, il composto, la tecnica e la sottopagina dei risultati. Più angolazioni = risposta più completa.
|
||||
@@ -58,9 +59,9 @@ Le pagine **hub** hanno una sezione `## Struttura` con le sottopagine (es. `cicl
|
||||
### 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**.
|
||||
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 e non citarne il numero**: una figura citata per numero va sempre mostrata.
|
||||
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.
|
||||
4. **Aggancio al testo.** La frase che precede dice cosa sta per essere mostrato (es. «Lo schema di sintesi riportato qui sotto mostra…», **senza numero di figura**); subito dopo l'immagine metti la descrizione e commenta gli elementi da guardare (struttura, frecce, picchi, curve, legenda) collegandoli al ragionamento.
|
||||
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
|
||||
@@ -75,13 +76,15 @@ Dopo il retrieval, costruisci la risposta più **articolata e completa** possibi
|
||||
## 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]`.
|
||||
- **Sì**, in forma breve, la posizione nella tesi utile a ritrovare il dato: sezione, tabella o equazione, es. `(§3.2, Tab. 5)` (**mai il numero di una figura**, vedi sotto), e i riferimenti bibliografici col solo numero della tesi, es. `[1]`.
|
||||
- **Figure: sempre mostrate con la loro descrizione, mai citate per numero (regola inderogabile).** Non scrivere mai «Fig. N», «Figura N» né simili nel testo. Ogni volta che una figura serve a spiegare (o è la figura che la tesi usa per quel punto), **mostrala davvero**: incorpora l'immagine con `` (hash e estensione dal file indicato nella nota; il percorso resta solo nella sintassi dell'immagine) e **subito sotto scrivi la descrizione di ciò che mostra** (cosa rappresenta, composti, condizioni, assi o elementi chiave), ricavata dalla nota della figura, dalla didascalia e da ciò che vedi, in parole tue e senza numero. Nel testo rimanda alla figura a parole («lo schema qui sotto», «lo spettro riportato di seguito», «il voltammogramma mostrato»). Prima di inviare, controlla che per ogni figura di cui parli ci sia il suo ``: una figura descritta ma non incorporata è un errore. Se non puoi incorporarla (file mancante), non parlarne come se fosse visibile: descrivi il contenuto a parole e dì che l'immagine non è disponibile.
|
||||
- **Tabelle: mostrate sempre.** Se citi o ti serve una tabella, **riproducila in Markdown** nella risposta, nel punto in cui la discuti, copiando da `raw/tesi.md` intestazioni, valori, unità e note alla lettera (se è lunga, tutte le righe e colonne rilevanti, dichiarando cosa ometti). Mai un riferimento a una tabella senza vederla nella risposta; se non puoi mostrarla, non citarla per numero.
|
||||
- Le figure compaiono **solo come immagine incorporata** `` 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:
|
||||
Le risposte devono essere **sempre le più complete possibile**, anche se l'utente non lo chiede e anche se la domanda sembra semplice o puntuale. L'obiettivo è che **non servano domande di approfondimento**: anticipa ciò che l'utente chiederebbe subito dopo (definizioni dei termini usati, perché e come, dati, confronti, limiti, collegamenti) e includilo, restando **dentro gli argomenti della tesi** (nessun concetto esterno al perimetro). Non scrivere risposte brevi o riassunte, nemmeno se richieste in modo generico; la forma estesa è sempre quella predefinita:
|
||||
- **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).
|
||||
- **Recupero ampio prima di scrivere:** leggi tutte le pagine pertinenti (concetto, composto, tecnica, risultati, analisi dei difetti), non fermarti alla prima che risponde. Nel dubbio se una pagina serva, leggila.
|
||||
- **Spiega, non elencare:** per ogni risultato dì cosa significa e perché, usando la conoscenza generale (marcata) per rendere comprensibili meccanismi, definizioni e ordini di grandezza, sempre dentro il perimetro della tesi.
|
||||
|
||||
@@ -53,6 +53,7 @@ flowchart LR
|
||||
CLAUDE.md schema di consultazione (regole RAG)
|
||||
AGENTS.md GEMINI.md puntatori a CLAUDE.md per Codex, Antigravity, Gemini CLI
|
||||
.agents/skills/ tesi-query, tesi-figure, tesi-dati, tesi-fonti, tesi-narrate
|
||||
(tesi-query/references/: protocollo di retrieval, mappa, ricette di ricerca, checklist)
|
||||
.claude/skills link simbolico a .agents/skills (per Claude Code)
|
||||
index.md log.md catalogo delle pagine e registro delle modifiche
|
||||
raw/ tesi.md, immagini/, immagini.json, bibliografia.json, fonti/, riassunto
|
||||
|
||||
Reference in new issue
Block a user