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:
1 parent
07d25de49c
commit
533f735155
11 files changed
+254
-67
No files matched your search
@@ -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.
|
||||
Reference in new issue
Block a user