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 2026-10-20 15:53:24 +02:00
1 parent 07d25de49c
commit 533f735155
11 files changed
+254 -67

No files matched your search

+20 -22
View File
@@ -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 `![descrizione](raw/immagini/<hash>.<ext>)` 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.