Files
cyber-tesi/.agents/skills/tesi-query/references/protocollo-retrieval.md
T

6.6 KiB

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.