Mantenere aggiornate le spiegazioni — Documentazione di Noea Code

Dopo aver modificato intento o codice, verifica se le spiegazioni sono ancora valide. Usa Spiega (Explain) nella barra laterale per gestire le spiegazioni che richiedono attenzione nel progetto oppure l’azione Indagine (Investigation) di un paragrafo per verificare un singolo contenuto.

Individua cosa è cambiato

Stato	Significato	Passaggio successivo
Contenuto da indagare	Il testo nuovo o modificato non ha una propria spiegazione.	Salva, poi indaga. Implementa prima se il requisito non è ancora soddisfatto.
Spiegazione del testo precedente	Il paragrafo è cambiato, ma la nota spiega ancora il testo precedente.	Esamina le differenze nel testo e indaga di nuovo.
Potrebbe non essere aggiornata	I file letti o citati dalla spiegazione sono cambiati.	Esamina i file modificati e verifica di nuovo la spiegazione.
Nessuna modifica trovata	Nessun contenuto è in attesa di indagine o indicato come potenzialmente non aggiornato.	Continua a leggere o verifica domande specifiche quando serve.

“Potrebbe non essere aggiornata” non significa necessariamente che una conclusione sia sbagliata: una modifica a un file potrebbe non essere pertinente. “Nessuna modifica trovata” non dimostra che i test passino o che tutte le funzionalità siano complete.

Indaga un paragrafo

Salva il documento, passa con il puntatore sul paragrafo e scegli Indagine (Investigation) a sinistra. Una nota a margine esistente può anche offrire Indaga di nuovo (Investigate Again).

Questo aggiorna solo la spiegazione del contenuto selezionato. L’indagine non è disponibile se quel contenuto ha modifiche non salvate e Noea chiede di salvarlo prima.

Per esempio, dopo aver modificato il codice che impedisce ricompense duplicate, indaga la regola corrispondente per verificare che la spiegazione descriva l’implementazione attuale.

Aggiorna le spiegazioni nel progetto

Fai clic su Spiega (Explain) nella barra laterale per verificare i contenuti in attesa di indagine e le spiegazioni i cui file di supporto sono cambiati. L’azione non è disponibile se non è aperto alcun progetto, il progetto è di sola lettura o non è collegata una cartella di implementazione.

Un’attività Spiega avviata manualmente apre una chat con fasi, avanzamento e risultati individuali. Non puoi inviare messaggi normali in quella chat mentre è in esecuzione, ma puoi usare altre chat del progetto.

Al termine, espandi i risultati per vedere quali spiegazioni sono cambiate, quali restano accurate e quali verifiche sono fallite o rimaste incomplete. Un’attività terminata non significa che ogni verifica sia riuscita.

Comprendi cosa ha verificato Spiega

Spiega confronta intento e codice e verifica sia le spiegazioni del paragrafo sia quelle locali. Conserva i contenuti accurati e aggiorna quelli da correggere; non riscrive necessariamente ogni spiegazione.

Una spiegazione aggiornata non significa che i test siano stati rieseguiti. Per verificare il comportamento, richiedi i controlli in una chat normale e poi indaga il contenuto pertinente. Consulta Leggere spiegazioni e prove per interpretare l’ambito delle verifiche.

Scopri quando Spiega parte automaticamente

Impostazioni → Progetto attuale → Automazione → Spiega automaticamente dopo l’implementazione (Settings → Current Project → Automation → Explain automatically after implementing) è abilitato per impostazione predefinita. I principali casi di avvio sono:

Azione	Avvio automatico di Spiega
Accetti una proposta che modifica l’intento e richiede ancora implementazione.	Quando l’attività di implementazione termina normalmente.
Accetti una proposta che modifica l’intento ed è già soddisfatta dall’implementazione.	Dopo l’accettazione.
Avvii il lavoro con Implementa nella barra laterale.	Quando il primo turno termina normalmente.
Accetti un piano di organizzazione che modifica il testo dell’intento.	Dopo l’accettazione, indipendentemente dall’impostazione sopra.
Riorganizzi solo nomi di file o struttura delle cartelle.	Non si avvia.
Modifichi solo il codice in una chat normale, scegli Implementa direttamente oppure l’implementazione fallisce o viene fermata.	Non si avvia; esegui Spiega manualmente.

L’esecuzione automatica di Spiega avviene in background senza creare una chat normale. Prosegui nella chat originale e controlla l’avanzamento in Esecuzioni (Runs).

Esamina i registri e riesegui

La sezione Esecuzioni (Runs) della barra laterale conserva le attività di spiegazione. Espandi un’attività per visualizzare i registri di sola lettura delle sue esecuzioni. Restano disponibili dopo aver cambiato chat o riavviato l’app.

Dopo un errore o un’interruzione, scegli Esegui di nuovo (Run Again). Le spiegazioni esistenti vengono conservate. Al termine della nuova esecuzione, verifica che gli elementi prima falliti o incompleti siano stati gestiti.

Scegli un Agent per ogni operazione

L’Agent usato da Spiega dipende da come si avvia l’attività. Consulta Agent, modelli e utilizzo per le impostazioni delle operazioni di progetto e il loro ambito.

Se le spiegazioni non si aggiornano, consulta Risoluzione dei problemi e domande comuni.