diff --git a/.agents/skills/tesi-dati/SKILL.md b/.agents/skills/tesi-dati/SKILL.md new file mode 100644 index 0000000..6fc002d --- /dev/null +++ b/.agents/skills/tesi-dati/SKILL.md @@ -0,0 +1,17 @@ +--- +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. +--- + +# tesi-dati — valori e tabelle esatti + +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)`. +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. diff --git a/.agents/skills/tesi-figure/SKILL.md b/.agents/skills/tesi-figure/SKILL.md new file mode 100644 index 0000000..1f1186f --- /dev/null +++ b/.agents/skills/tesi-figure/SKILL.md @@ -0,0 +1,27 @@ +--- +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. +--- + +# tesi-figure — retrieval e spiegazione delle immagini + +Sola lettura. Italiano. + +## 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-`. +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`. + +## 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/.]]` 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. + +## 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. diff --git a/.agents/skills/tesi-fonti/SKILL.md b/.agents/skills/tesi-fonti/SKILL.md new file mode 100644 index 0000000..6e7c0cf --- /dev/null +++ b/.agents/skills/tesi-fonti/SKILL.md @@ -0,0 +1,14 @@ +--- +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». +--- + +# tesi-fonti — bibliografia e citazioni + +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)`. +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-query/SKILL.md b/.agents/skills/tesi-query/SKILL.md new file mode 100644 index 0000000..a803f30 --- /dev/null +++ b/.agents/skills/tesi-query/SKILL.md @@ -0,0 +1,34 @@ +--- +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. +--- + +# tesi-query — risposta RAG sulla wiki della tesi + +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. + +## 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`. + +## 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. + +## 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. + +## Forma +Risposta diretta in 2-4 righe, poi sviluppo 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 `[[...]]`). + +## 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). +- **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/skills b/.claude/skills new file mode 120000 index 0000000..2b7a412 --- /dev/null +++ b/.claude/skills @@ -0,0 +1 @@ +../.agents/skills \ No newline at end of file diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..da6c1ea --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,5 @@ +# AGENTS.md — Wiki della tesi (Codex e altri agenti) + +Questo repo è una LLM-wiki in **sola lettura** sulla tesi «Sintesi e caratterizzazione di copolimeri bottle brush foto-elettro attivi». Leggi `CLAUDE.md` alla radice: contiene lo schema completo di consultazione (retrieval dalla wiki e dalle figure, integrazione con conoscenza generale entro il perimetro della tesi, citazioni, difetti noti). Non modificare `wiki/`, `raw/`, `index.md`, `log.md` salvo richiesta esplicita. Rispondi in italiano. + +Skill in `.agents/skills/`: `tesi-query` (domande generali), `tesi-figure` (immagini), `tesi-dati` (valori e tabelle), `tesi-fonti` (bibliografia). diff --git a/GEMINI.md b/GEMINI.md new file mode 100644 index 0000000..b20f899 --- /dev/null +++ b/GEMINI.md @@ -0,0 +1,5 @@ +# GEMINI.md — Wiki della tesi (Gemini CLI) + +Questo repo è una LLM-wiki in **sola lettura** sulla tesi «Sintesi e caratterizzazione di copolimeri bottle brush foto-elettro attivi». Leggi `CLAUDE.md` alla radice: contiene lo schema completo di consultazione (retrieval dalla wiki e dalle figure, integrazione con conoscenza generale entro il perimetro della tesi, citazioni, difetti noti). Non modificare `wiki/`, `raw/`, `index.md`, `log.md` salvo richiesta esplicita. Rispondi in italiano. + +Skill in `.agents/skills/`: `tesi-query` (domande generali), `tesi-figure` (immagini), `tesi-dati` (valori e tabelle), `tesi-fonti` (bibliografia).