Files
cyber-tesi/.agents/skills/tesi-narrate/SKILL.md
T

3.2 KiB

name, description
name description
tesi-narrate Trasforma un argomento della tesi in un documento Markdown citato, in tre registri (briefing, spiegazione in linguaggio semplice, lezione progressiva), con elenco delle pagine usate e delle lacune. Usala per «spiegami…», «fammi un riassunto/briefing su…», «prepara una lezione su…» riguardo DPP, P3HT, PCL/ROP, bottle brush, ACQ, tecniche e risultati della tesi.

tesi-narrate — briefing, spiegazione o lezione citati

Sola lettura: restituisci il testo in chat e non scrivere file salvo richiesta esplicita. Italiano. Per il recupero segui i passi di tesi-query (indice, pagine intere, verifica su raw/tesi.md, difetti noti) e per le immagini tesi-figure.

Richiesta

<argomento> [registro], con registro briefing (predefinito), plain-language o lecturer. Se l'argomento manca, chiedilo. Se il registro non è uno dei tre, elencali e non procedere.

Procedura

  1. Recupero. Parti da index.md, wiki/glossario.md, wiki/tesi.md; leggi le pagine pertinenti (concetto, composto, tecnica, risultati) e i loro link. Escludi dalle fonti index.md, log.md e le pagine di sola navigazione.
  2. Registro delle affermazioni (prima di scrivere). Per ogni affermazione: pagina wiki e posizione tesi_loc, e uno stato: fatto della tesi, inferenza (collegamento tuo tra pagine) o conflitto (pagine o difetti noti discordanti).
  3. Redazione. Ogni frase fattuale indica la posizione in forma breve, (§, Tab./Fig.), senza wikilink, nomi di pagine o numeri di riga. Dati copiati alla lettera. Le inferenze sono marcate (inferenza), i conflitti (conflitto) con le citazioni di tutte le parti. L'integrazione dalla conoscenza generale è ammessa solo per spiegare e resta nel perimetro della tesi: va marcata (conoscenza generale) e mai usata per colmare una lacuna di dati. Se la tesi non riporta qualcosa, omettilo e nominalo in «Copertura».
  4. Figure. Includi quelle che chiariscono l'argomento (di norma 1-4), guardate sul file in raw/immagini/, incorporate come ![descrizione](raw/immagini/<hash>.<ext>) e con le avvertenze a parole per le figure con flag.

Registri (sezioni, nell'ordine)

  • briefing (orientamento rapido, conclusione prima delle prove): Sintesi · Evidenze chiave · Implicazioni · Questioni aperte.
  • plain-language (per chi non conosce l'argomento; definisci i termini prima di usarli, frasi brevi, niente analogie che introducano fatti non citati): Che cosa significa · Idee chiave · Come si incastrano i pezzi · Cosa non sappiamo ancora.
  • lecturer (lezione progressiva dal contesto al meccanismo): Contesto · Concetti fondamentali · Come funziona · Implicazioni e limiti · Ricapitolazione.

Il registro cambia stile e ordine, non il confine dei fatti.

Uscita

  1. Titolo con argomento e registro.
  2. Le sezioni del registro.
  3. ## Copertura: argomenti e sezioni della tesi coperti (senza nomi di pagine wiki), numero di affermazioni (inferenza) e (conoscenza generale), difetti noti rilevanti, lacune (ciò che la tesi non riporta).

Se non esistono pagine pertinenti, dillo e non produrre il documento. Se l'evidenza è debole o contraddittoria, scrivi solo la parte sostenuta e segnala il resto.