Presentation Structure

• Hai bisogno di un agente che aggiunga, rimuova o riordini le slide nella presentazione HTML e rinumeri correttamente ogni attributo data-slide e ogni riferimento goToSlide() nel sommario.
• Vuoi che l'agente crei nuovi divisori di sezione con la classe section-slide corretta, l'attributo data-level e il testo section-desc.
• Hai bisogno che l'agente ragioni sullo stato della barra del percorso — sapendo quali slide mostrano una barra vuota, quali ereditano un livello e quali attivano una transizione di livello.
• Stai revisionando o verificando la struttura della presentazione e vuoi che l'agente rilevi lacune, duplicati o chiamate goToSlide() non corrispondenti.

• Stai lavorando su una presentazione costruita con un framework diverso (ad es., Reveal.js, PowerPoint, Google Slides) — questa skill è specifica per il formato a file singolo presentation/index.html.
• Hai bisogno solo di modificare il contenuto delle slide (testo, immagini, diagrammi) senza toccare la numerazione o la struttura delle slide — in tal caso, le regole strutturali della skill rappresentano un overhead non necessario.

La skill codifica i tre tipi di slide — slide normali, slide di sezione per la transizione di livello e la slide del titolo — insieme agli attributi HTML richiesti (data-slide, data-level, classi CSS). L'agente sa quali attributi sono obbligatori, quali sono facoltativi e quali elementi (come .level-badge) non devono essere codificati direttamente nell'HTML.

Invece di una percentuale cumulativa, la presentazione utilizza quattro livelli discreti (low, medium, high, pro) mappati rispettivamente al 25 / 50 / 75 / 100% di riempimento della barra. Presentation Structure acquisisce esattamente quali intervalli di slide attivano ciascun livello, quali slide ereditano il livello precedente, e che la barra è nascosta nella slide 1 e vuota prima della prima transizione data-level.

Dopo qualsiasi modifica strutturale, l'agente deve rinumerare tutti gli attributi data-slide in sequenza a partire da 1, aggiornare ogni chiamata goToSlide() nella diapositiva TOC/Journey Map e verificare che non esistano lacune o duplicati. La skill Presentation Structure documenta che totalSlides viene calcolato automaticamente dal DOM e non richiede aggiornamenti manuali.

La competenza copre la funzione goToSlide(n) utilizzata nei link del sommario, il valore totalSlides calcolato automaticamente e i metodi di input supportati: tasti freccia, barra spaziatrice e swipe touch. Questo consente all'agente di verificare che i link del sommario rimangano coerenti dopo la rinumerazione.

I divisori di sezione seguono un formato preciso: classe section-slide, attributo opzionale data-level, un paragrafo section-number, un titolo <h1> e un paragrafo section-desc che indica il livello. Presentation Structure rende l'agente consapevole del markup completo atteso, in modo che le sezioni generate siano immediatamente valide.

Un utente chiede all'agente di inserire una nuova sezione "Parte 7" dopo la diapositiva 46. Presentation Structure indica all'agente di creare un div section-slide con il successivo numero data-slide sequenziale, aggiungere il data-level appropriato, rinumerare tutte le diapositive successive e aggiornare ogni chiamata goToSlide() nella diapositiva del sommario.

L'agente analizza presentation/index.html alla ricerca di lacune o valori data-slide duplicati, e verifica incrociando ogni chiamata goToSlide() con i numeri di slide effettivi, segnalando eventuali discrepanze — un'operazione completamente supportata dalle regole di rinumerazione codificate in questa skill di Presentation Structure.

Un utente desidera un riepilogo di quali diapositive appartengono a quale livello del percorso. L'agente utilizza la tabella delle transizioni di livello nella skill Presentation Structure per produrre una mappatura accurata degli intervalli di diapositive, dei valori data-level e delle corrispondenti percentuali di riempimento della barra, senza dover leggere l'intero file HTML.

Quando viene richiesto di strutturare una nuova diapositiva, l'agente utilizza i modelli HTML esatti forniti da questa skill — selezionando la classe corretta (title-slide, section-slide o semplicemente slide), inserendo gli attributi appropriati e sapendo di omettere .level-badge dall'HTML sorgente poiché viene iniettato tramite JS in fase di esecuzione.