---
name: spiega-slide
description: Spiega slide di lezioni universitarie (PDF di corsi, dispense, handout, lecture notes) a livello didattico profondo, ricostruendo ogni passaggio con esempi numerici invece di riassumere. Usa questa skill OGNI VOLTA che l'utente carica un PDF di slide o appunti e chiede di spiegarle, analizzarle, capirle o approfondirle, e in particolare quando indica un intervallo come "spiegami le slide 21-28", "fai questa slide e le 5 seguenti", "explain these lecture slides", "non capisco questa parte del PDF", "analizza questa lecture", "aiutami a preparare l'esame su questo capitolo". Vale per qualsiasi materia tecnica, tra cui machine learning, matematica, statistica, fisica, informatica, economia e ingegneria. Attivala anche se la richiesta sembra un semplice "riassumimi queste slide", perche l'utente vuole capire e non un riassunto.
---

# Spiegare slide di lezione

Le slide universitarie sono **appunti compressi**: sono scritte per essere parlate dal docente, non lette da sole. Una riga come "α è posto a 1 perché la scala di w non cambia la funzione" contiene mezz'ora di lezione compressa in dodici parole.

Il compito di questa skill è **decomprimerle**: ricostruire il ragionamento che il docente ha detto a voce e che sulla slide non c'è. Non riassumere (è già un riassunto), non parafrasare (non aggiunge nulla), non tradurre in elenchi puntati (li ha già).

## La regola d'oro

**Mai enunciare una conclusione senza mostrare il ragionamento che la produce.**

Questo è il singolo criterio che separa una spiegazione utile da una inutile. Se scrivi una frase che uno studente non può verificare da solo con quello che gli hai appena dato, non hai spiegato: hai riassunto la slide con parole diverse.

Test pratico su ogni frase che scrivi: *se lo studente si fermasse qui e chiedesse "in che senso?", avrei già risposto?* Se no, la frase va espansa con un esempio, una derivazione o un caso concreto.

## La seconda regola: prima la slide, poi il resto

**La slide è la traccia. Copri tutto quello che c'è scritto, nell'ordine in cui è scritto, prima di aggiungere qualunque cosa.**

Ogni riga è lì perché il docente ce l'ha messa, e quella è la sequenza che lo studente ha davanti agli occhi mentre ti legge, ritrova sui suoi appunti e rivedrà all'esame. Se la slide dice A, B, C, la spiegazione dice A, B, C: non parte da C perché è più interessante, non salta B perché sembra ovvio.

Due errori speculari, entrambi gravi:

- **Saltare un punto perché sembra banale.** Se è sulla slide, va spiegato. Una riga come "p(C₂|φ) = 1 − p(C₁|φ)" sembra un riempitivo, ed è invece l'ipotesi che chiude il modello binario e la ragione per cui con K classi servirà il softmax. I punti che sembrano banali a te sono spesso quelli che il docente considera il cuore della slide.
- **Intercalare approfondimenti** tra un punto e il successivo. Lo studente segue la slide con gli occhi: se dopo il primo bullet trova tre paragrafi che sulla slide non esistono, quando torna al secondo bullet ha perso il filo.

Gli approfondimenti non sono banditi — sono ciò che rende la spiegazione migliore della slide, ed è per questo che la skill esiste. Ma vanno **dopo**, raccolti in una sezione dichiarata come tale. Prima si finisce la slide.

Test pratico prima di consegnare: rileggi la spiegazione con la slide accanto e spunta i suoi punti uno per uno. Se ne resta uno non spuntato, o se le spunte non scendono dall'alto in basso, riorganizza.

## Prima di iniziare

1. **Leggi il PDF.** Se il contenuto è già nel contesto usalo; se hai solo il percorso in `/mnt/user-data/uploads`, leggilo dal disco (per i PDF consulta la skill `pdf-reading`).
2. **Guarda tutto il deck, non solo le slide richieste.** Ti serve per collocarle e per sapere cosa viene anticipato o ripreso altrove.
3. **Rispetta l'intervallo richiesto.** Se l'utente dice "questa e le 5 seguenti", sono sei slide: coprile tutte. Se non specifica niente, non riversare quaranta slide: proponi la struttura del deck e chiedi da dove partire.
4. **Se l'intervallo è lungo e denso**, spiega a fondo un blocco coerente e proponi di continuare. Meglio sei slide capite che venti annacquate.

## Struttura della risposta

**Apertura (3-6 righe): la mappa.** Dove si collocano queste slide nel deck, cosa le precede e perché esistono. Serve a far capire che il deck è una storia, non una lista.

**Poi, per ogni slide:**

```
## Slide N — <titolo originale della slide>

### Cosa c'è scritto
(la formula centrale e i punti chiave, riportati fedelmente e nell'ordine della slide)

### Il problema che questa slide risolve
(perché il docente l'ha messa qui: cosa mancava prima, cosa sblocca)

### Passo 1 / Passo 2 / Passo 3 ...
(i contenuti della slide, uno per passo, NELL'ORDINE IN CUI COMPAIONO — con i simboli
sciolti, le derivazioni per esteso e gli esempi numerici dentro il passo a cui servono)

### Approfondimenti
(solo dopo aver chiuso la slide: implicazioni, conseguenze, ciò che il docente
sottintende, collegamenti al resto del deck. Ogni voce marcata come aggiunta.)

### Riassunto in 3-4 righe
```

**I passi ricalcano la slide, non la tua idea di ordine ottimale.** Se la slide ha quattro bullet, hai quattro passi nello stesso ordine. Se ha una sola formula densa, i passi sono i suoi pezzi in ordine di lettura. Se un punto della slide ha bisogno di un prerequisito che la slide dà per noto (la derivata di una funzione, una proprietà usata senza dirlo), quel prerequisito sta **dentro** il passo che lo richiede, non prima: è al servizio del punto, non un argomento a sé.

Esempi numerici, tabelle e derivazioni non sono sezioni separate: vivono dentro il passo a cui appartengono.

La sezione **Approfondimenti** è facoltativa e va omessa quando non hai niente di sostanziale da aggiungere. Meglio zero approfondimenti che tre paragrafi di contorno. Quando c'è, tienila corta e ordinata per utilità: prima ciò che serve a capire la slide stessa, poi ciò che serve all'esame, poi la curiosità.

Un'eccezione da saper riconoscere: **il caveat resta attaccato all'affermazione che limita**. Se la slide dice una cosa vera solo sotto un'ipotesi che non dichiara, o scrive una formula con un refuso, o usa una notazione ambigua, quella precisazione va nel passo corrispondente — lì serve a non far imparare una cosa storta, in fondo alla pagina arriverebbe troppo tardi. La regola pratica: **se corregge o delimita un punto della slide sta nel passo; se apre un argomento che la slide non tocca va in Approfondimenti.**

Adatta i titoli al contenuto: una slide di solo testo non ha bisogno dell'esempio numerico, una slide di sole figure vuole una sezione che spieghi gli elementi del grafico. La struttura è uno scheletro, non una gabbia — ma **l'ordine dei passi non è negoziabile**.

**Chiusura:** cosa arriva nelle slide successive e come si collega, più l'offerta di continuare.

## Le sette tecniche che fanno la differenza

### 1. Sciogli i simboli prima di usarli
Non dare per scontato nessun oggetto della formula. Di' a parole **cos'è**, dagli un nome comune, e distingui le sue proprietà rilevanti.

> wᵀφ(x) è solo una somma pesata delle feature. Chiamiamolo *punteggio*. Del punteggio interessano due cose separate: il **segno** (da che parte della frontiera sta il punto) e il **valore assoluto** (quanto è lontano). Tienili distinti, perché fra due passi serviranno tutti e due.

### 2. Un esempio numerico per ogni formula importante
Inventa 3-5 numeri piccoli e **fai girare la formula davanti allo studente**, mostrando i conti. È la tecnica più efficace in assoluto: trasforma una formula in qualcosa che si può controllare a mano.

Metti i conti in tabella quando devi far vedere un pattern (per esempio che una quantità è positiva esattamente nei casi corretti e negativa in quelli sbagliati). La tabella fa vedere il pattern; il testo lo nomina.

### 3. Deriva, non enunciare
Se la slide salta da una formula alla successiva, **fai il passaggio intermedio per esteso almeno una volta**. Scrivi la somma componente per componente, deriva rispetto a un singolo parametro, poi generalizza. I passaggi "ovvi" sono precisamente quelli su cui lo studente si blocca.

Segnala esplicitamente le cancellazioni di segno e i cambi di notazione: il meno della discesa del gradiente che incontra il meno del gradiente e diventa un più è il tipo di dettaglio che sembra banale a chi lo sa già e blocca chi non lo sa.

### 4. Spiega le scelte apparentemente arbitrarie
Perché quella codifica delle etichette e non un'altra? Perché quel segno meno? Perché quel valore dell'iperparametro? Perché si esclude una parte dei dati dalla somma?

Ogni scelta arbitraria sulla slide è un punto in cui lo studente sospetta di essersi perso qualcosa. Trovale e giustificale, mostrando **cosa succederebbe con la scelta alternativa**.

### 5. Mostra cosa si rompe
Un metodo si capisce quando si vede dove fallisce. Fai vedere il caso che peggiora, il punto che si rompe, l'ipotesi che se cade porta via tutto. Serve a due cose: rende concreta la limitazione, e rende **necessario** il teorema o il metodo della slide successiva.

### 6. Cuci le slide tra loro
Il deck è una storia con richiami avanti e indietro. Rendili espliciti:

> "Questo è il motivo per cui la slide 10 diceva che quella codifica è comoda per alcuni algoritmi."
> "Questa disuguaglianza è ciò che verrà dimostrato in astratto alla slide 28."
> "È esattamente il problema che si vedeva nella figura di sinistra della slide 16."

Un richiamo di una o due righe che chiarisce *il punto che stai spiegando* sta dentro il passo. Se invece si allarga in un confronto tra metodi, è un approfondimento: spostalo in fondo.

### 7. Dai l'intuizione geometrica quando esiste
Se la formula ha un significato spaziale, dillo: cosa vuol dire geometricamente sommare quel vettore, cosa rappresenta quella perpendicolarità, in che direzione ci si muove. Vale la stessa regola: è la lettura geometrica di *questa* formula, quindi sta accanto alla formula; è un discorso sulla geometria del metodo in generale, quindi sta negli approfondimenti.

Un diagramma va aggiunto **solo se mostra qualcosa che le figure delle slide non mostrano già** (per esempio la geometria nascosta dietro una formula). Mai come sostituto della spiegazione a parole, mai più di uno per blocco di slide.

## Anti-pattern: la frase-guscio

Questo è l'errore da evitare più di ogni altro. Una frase-guscio è grammaticalmente una spiegazione ma non contiene informazione verificabile per chi non sa già la risposta.

**Sbagliato:**
> Perché α = 1? Perché la decisione dipende solo dal segno di wᵀφ: moltiplicare w per una costante positiva non cambia il classificatore.

Tutto vero, e completamente inutile: chi non ha già capito non ricava niente. Manca il perché del perché.

**Giusto:**
> α è il learning rate: quanto è lungo il passo a ogni aggiornamento. Di solito è un parametro delicatissimo. Qui la slide dice: mettilo a 1 e non pensarci. Perché?
>
> Prendi w = (2,2) e un punto φ = (1,3): punteggio = 2·1 + 2·3 = **8**, il modello dice +1. Adesso raddoppia w, cioè w = (4,4): punteggio = 4·1 + 4·3 = **16**, il modello dice **ancora** +1. Il numero è raddoppiato ma il segno è identico — e il classificatore legge solo il segno. Moltiplicare per un numero positivo non cambia mai il segno di niente, quindi w = (2,2) e w = (4,4) sono lo stesso identico classificatore.
>
> Ora il collegamento con α. Partendo da w = 0, con α = 1 ottieni w = φₐtₐ + φ_b t_b + …, mentre con α = 0.5 ottieni esattamente lo stesso vettore dimezzato. Stessa direzione, lunghezza diversa — e la lunghezza non cambia le predizioni. Cambiare α non produce un algoritmo diverso, produce lo stesso algoritmo scritto con numeri riscalati. Tanto vale scegliere il valore più comodo: 1.

La differenza non è la lunghezza: è che la seconda versione **si può verificare da soli mentre si legge**.

## Anti-pattern: la digressione che scavalca

Il secondo errore per gravità. Nasce da un'intenzione buona — l'approfondimento interessante — e produce una spiegazione che risponde a domande che lo studente non ha fatto mentre lascia senza risposta quelle che ha.

Caso reale. Una slide contiene, in quest'ordine: (1) la formula p(C₁|φ) = σ(wᵀφ), (2) la definizione di σ, (3) p(C₂|φ) = 1 − p(C₁|φ), (4) il nome del modello.

**Sbagliato:** si spiega la sigmoide con una bella tabella di valori, poi si passa direttamente a "la frontiera resta lineare" (che sulla slide non c'è), poi ai log-odds (che sulla slide non ci sono) — e il punto (3), che sulla slide c'è, non viene mai toccato.

**Giusto:** quattro passi nell'ordine 1-2-3-4, ciascuno con i suoi numeri; frontiera lineare e log-odds vanno in **Approfondimenti**, marcati come aggiunte, dopo che la slide è chiusa.

Il sintomo da riconoscere in te stesso mentre scrivi: stai per attaccare un paragrafo con "la conseguenza che la slide non dice è…" oppure "vale la pena notare che…" e non hai ancora spiegato l'ultima riga della slide. Fermati, finisci la slide, e riprendi quel paragrafo dopo.

Altri anti-pattern da evitare:
- Elenchi puntati che riscrivono la slide con sinonimi.
- Termini usati prima di essere definiti (gradiente, verosimiglianza, convessità, iperpiano).
- Tono da appunti: frasi nominali telegrafiche incollate una dopo l'altra. Scrivi in prosa, spiegando come parleresti a voce.
- Comprimere per stare corti. Una slide densa vale tranquillamente 600-1200 parole. Il limite non è la lunghezza, è che **ogni paragrafo deve aggiungere informazione**.

## Onestà su cosa viene dalla slide e cosa no

L'utente studia per un esame: deve sapere cosa può citare come "detto dal prof" e cosa è integrazione.

- **Marca sempre le aggiunte**: "Aggiunta mia:", "non scritto sulla slide:", "integrazione dal libro di testo". La marcatura non basta da sola: un'aggiunta marcata ma piazzata in mezzo ai punti della slide resta fuori posto. Marcala **e** mettila negli approfondimenti.
- **Segnala i refusi e le imprecisioni** delle slide con delicatezza, spiegando qual è la formulazione corretta.
- **Segnala le convenzioni implicite**: se una formula omette il termine di bias, o cambia notazione a metà, o usa un simbolo in due sensi, dillo e dichiara la convenzione che stai assumendo.
- **Non inventare riferimenti.** Se citi un articolo, un anno, un nome di teorema e non ne sei certo, dichiara l'incertezza e invita a verificare. Mai fabbricare titoli, autori, date o numeri.
- Se una slide è genuinamente ambigua, dillo e presenta le letture possibili invece di sceglierne una in silenzio.

## Casi particolari

**Slide identiche ripetute** (stesso titolo e testo, figura diversa) sono l'animazione di una singola slide. Trattale come **una sola narrazione**: descrivi una volta gli elementi del grafico (cosa sono i colori, le frecce, le linee), poi racconta cosa cambia in ogni fotogramma e perché.

**Slide di sole figure**: la spiegazione è tutta nel decodificare il grafico. Parti dagli assi e dalla legenda, poi di' cosa deve *notare* lo studente e perché il docente ha messo quella figura lì.

**Slide di solo titolo** (i separatori di sezione) non vanno spiegate: usale come cerniere narrative nella mappa iniziale.

**Formule**: usa il display per quelle centrali, la notazione inline compatta per il resto. Se la slide usa una notazione, mantienila — lo studente deve ritrovare gli stessi simboli all'esame.

**Dimostrazioni**: non saltare i passaggi algebrici. Spiega anche *perché* si fa quel passaggio, non solo che lo si fa.

## Lingua e formato

- Rispondi **nella lingua in cui scrive l'utente**, anche se le slide sono in un'altra lingua.
- Mantieni i **termini tecnici nella lingua delle slide** (con la traduzione tra parentesi la prima volta): all'esame li ritroverà così.
- Grassetto per i concetti chiave, tabelle per i confronti e gli esempi numerici, titoli per separare le slide. Niente muri di testo indifferenziati.

## Esempio completo

`references/esempio-completo.md` contiene una spiegazione modello di una singola slide fitta (il *Perceptron Criterion* da un corso di Machine Learning), scritta al livello di dettaglio giusto. Leggila prima di scrivere se hai bisogno di calibrare la profondità, il ritmo e l'uso degli esempi numerici — è il riferimento di qualità di questa skill.