Il flusso di lavoro essenziale06 / 16
Discutere ed esaminare le modifiche all’intento
In questa pagina
Quando una discussione porta a una nuova decisione di prodotto, chiedi all’Agent di trasformarla in una proposta di intento. Esamina la formulazione, adattala se serve e decidi se scriverla nei documenti.
Parti da un contesto preciso
Passa con il puntatore su un paragrafo pertinente e scegli Chiedi informazioni (Ask about this) a sinistra. Noea inserisce un riferimento nel campo di input e mostra il documento accanto alla chat. Non invia automaticamente un messaggio.
Puoi anche digitare @ per cercare documenti, paragrafi o spiegazioni. Il contenuto selezionato compare come riferimento e viene fornito all’Agent insieme al messaggio.
Per esempio:
Questa regola delle ricompense non dice cosa succede se si salta un check-in. Spiega il comportamento attuale usando l’implementazione, poi discutiamo se consentire i check-in di recupero.
Una volta deciso, chiedi una proposta:
Aggiungi “Consenti un check-in di recupero al mese” a questa regola. Proponi la modifica all’intento perché io possa esaminarla.
Decidi se correggere il codice o cambiare il requisito
Quando intento e implementazione non concordano, chiediti prima se il requisito originale resta valido. Supponi che il documento richieda una ricompensa dopo 7 giorni consecutivi, ma il codice la assegni il giorno 6:
| La tua decisione | Passaggio successivo |
|---|---|
| Il requisito resta di 7 giorni. | Conserva l’intento. Chiedi all’Agent di correggere l’implementazione e verificare la soglia. |
| Dopo la discussione, decidi per 6 giorni. | Modifica l’intento, esamina la nuova condizione di attivazione e verifica l’implementazione. |
Non riscrivere l’intento solo per adattarlo al codice esistente. Verifica prima che l’Agent abbia compreso il requisito, poi che il codice lo soddisfi. Chiarisci gli equivoci, correggi gli errori di implementazione e modifica l’intento solo quando decidi di cambiare la regola.
Per una correzione, sii esplicito:
Mantieni il requisito dei 7 giorni. Correggi la ricompensa anticipata, verifica che il giorno 6 non dia ricompense e il giorno 7 sì, e non cambiare l’intento per adattarlo al codice attuale.
Distingui suggerimenti e proposte
Una scheda suggerimento registra qualcosa che l’Agent ritiene utile aggiungere all’intento. Adotta (Adopt) avvia nella chat attuale il lavoro per trasformarlo in una proposta già soddisfatta dall’implementazione esistente; non scrive direttamente nell’intento. Ignora (Dismiss) registra che non intendi accogliere il suggerimento.
Una proposta contiene modifiche specifiche ai documenti da esaminare. Dopo l’invio da parte dell’Agent, la scheda compare quando il turno attuale termina, si interrompe o fallisce. Scegli Visualizza modifiche (View Changes) per esaminarla.
Esamina le modifiche nel documento
La vista di revisione mantiene l’impaginazione del documento. Le aggiunte hanno uno sfondo verde chiaro; le eliminazioni hanno uno sfondo rosso chiaro e testo barrato. Le sostituzioni mostrano il testo vecchio e quello nuovo, evidenziando quando opportuno le modifiche parola per parola.
Usa la barra di revisione in basso per passare tra le modifiche oppure seleziona il nome di un file per cambiare documento. Una decisione si applica all’intera proposta, inclusi tutti i suoi file. Non puoi accettare singoli paragrafi o file separatamente.
Puoi modificare il testo aggiunto e la parte nuova di una sostituzione. Il testo originale, le eliminazioni e i paragrafi invariati non sono modificabili in questo stato di revisione. Dopo una modifica, l’azione principale diventa Accetta le mie modifiche (Accept My Edits).
Prima di decidere, controlla non solo quali parole sono cambiate ma anche cosa richiedono:
- Sai spiegare le condizioni e i termini aggiunti con parole tue?
- Un’istruzione occasionale è stata scambiata per un requisito duraturo?
- L’Agent ha indebolito silenziosamente un vincolo per adattarlo al codice esistente?
- Saprai trovare la frase giusta la prossima volta che vorrai cambiare questo comportamento?
Se qualcosa non è chiaro, torna alla chat e chiedi all’Agent di spiegare o rivedere la proposta.
Scegli un’azione
| Azione | Documento di intento | Implementazione |
|---|---|---|
| Accetta (Accept) | Scrive l’intera proposta. | Prosegue se serve lavoro; non avvia un’altra esecuzione se il requisito è già soddisfatto. |
| Accetta le mie modifiche (Accept My Edits) | Scrive l’intera proposta con le tue modifiche. | Prosegue secondo la proposta modificata. |
| Implementa direttamente (Implement Directly) | Non scrive la proposta. | La implementa; disponibile solo per proposte che richiedono ancora implementazione. |
| Ignora (Dismiss) | Non applica la proposta. | Non ne avvia l’implementazione. |
Accetta una decisione esaminata quando vuoi che guidi lo sviluppo futuro. Implementa direttamente non registra la richiesta come intento.
Ignorare una proposta non annulla le modifiche al codice già eseguite. L’Agent potrebbe, per esempio, aver completato il lavoro prima di proporti di registrare il comportamento esistente.
Gestisci proposte riviste e documenti modificati
L’Agent può rivedere una proposta nella stessa chat. La nuova versione sostituisce la revisione in attesa, mentre la vecchia scheda mantiene un avviso di versione. Le modifiche fatte nella vecchia revisione ma non accettate non vengono riportate automaticamente.
Se il documento attuale non corrisponde più al testo di partenza della proposta, l’accettazione viene disabilitata. Usa Chiedi all’Agent una nuova proposta sulla versione attuale (Ask Agent to Re-propose on Current Version) perché l’Agent rilegga il documento e crei modifiche applicabili.
Dopo l’accettazione
Una proposta che richiede implementazione prosegue nella chat attuale. Se non termina, usa Continua a implementare (Continue Implementing) sulla scheda. Torna poi al documento e verifica la spiegazione; esegui Spiega manualmente se non si è aggiornata.
Per impedire l’apertura automatica delle revisioni, disattiva Impostazioni → Progetto attuale → Automazione → Apri automaticamente la revisione (Settings → Current Project → Automation → Open review automatically), poi entra nella revisione dalla scheda della proposta. Questa impostazione controlla l’apertura della revisione, non l’accettazione della proposta.
Continua con Mantenere aggiornate le spiegazioni.