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
@@ -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.
|
||||
|
||||
Reference in new issue
Block a user