Il responsabile del prodotto lascia un commento: «L’assegnazione automatica non è ancora disponibile». Facile da correggere? Solo se la promessa compare una volta. In un vero tutorial può trovarsi anche nel titolo, nell’apertura, nelle istruzioni a schermo e nel riepilogo.
Useremo Claude Code per rivedere un tutorial esistente sulla casella di posta di un team come piccola modifica di progetto. Kabo, un agente IA per la ricerca dei creator, può essere installato come plugin di Claude Code e aiuta quando la correzione lascia una lacuna nella spiegazione. I fatti attuali del prodotto provengono ancora dai nostri materiali approvati. Per una prima bozza costruita dalle riprese, parti dal manuale di copione Codex.
1. Trasforma la correzione in una richiesta di modifica revisionabile
Il nostro esempio scritto parte da una vecchia bozza che promette un passaggio automatico. Il fatto aggiornato dice che lo spettatore deve assegnare manualmente un responsabile. Può ancora imparare un’azione utile; la promessa e la dimostrazione devono corrisponderle.
Salva la breve nota qui sotto come change-request.md. La correzione sarà esplicita prima che Claude Code cerchi nel progetto.
Correzione approvata: L’assegnazione automatica non è disponibile in questa versione. Azione supportata: Un utente assegna manualmente il responsabile della conversazione. Mantenere: La lezione sul rendere visibili le responsabilità al team. Controllare: Titolo, promessa iniziale, azioni della dimostrazione, riepilogo e note di registrazione. Fonte dell’approvazione: [documento di prodotto attuale / revisore].
Raccogli la bozza approvata e la correzione
Non c’è una bozza esistente? Parti dall’elenco delle azioni registrate con l’istruzione qui sotto, rivedi il copione ottenuto e usa il processo di correzione quando cambiano i fatti. La guida al copione che parte dalle riprese approfondisce la scelta dei materiali.
[ ] drafts/script-v1.md — Narrazione esistente, ID dei passaggi e istruzioni a schermo. [ ] product-facts.md — Comportamento attualmente supportato; funzioni previste indicate separatamente. [ ] change-request.md — Correzione esatta, fonte e persona che l’ha approvata. [ ] voice.md — Esempio di scrittura approvato e livello del pubblico. [ ] recording-plan.md — Ambiente della dimostrazione, riprese registrate e schermate ancora disponibili. [ ] claims.md — Affermazioni del copione collegate ai fatti approvati; creare se manca. [ ] title-caption.md — Testo di presentazione da controllare insieme al copione.
Leggi product-facts.md, recording-plan.md e voice.md. Usando le azioni dello spettatore registrate nell’ordine fornito, scrivi drafts/script-v1.md con ID stabili dei passaggi, battute parlate, istruzioni a schermo e riferimenti ai fatti approvati. Segna come lacuna di registrazione qualsiasi azione non supportata dalla dimostrazione. Crea claims.md dalle promesse fattuali della bozza. Non suggerire che le funzioni previste siano disponibili.
2. Trova i passaggi dipendenti prima di cambiare le battute
Apri Claude Code nel progetto. Chiedigli di esaminare i file forniti e restituire un elenco degli impatti con ID dei passaggi e motivi. Una corrispondenza di parole chiave è un punto di partenza: «la prossima persona vede chi è responsabile» può restare vero, mentre «il sistema sceglie la prossima persona» dipende dalla funzione rimossa.
Rivedi l’elenco. Mantieni i punti didattici validi invece di eliminare ogni frase sull’assegnazione.
Leggi change-request.md e product-facts.md, poi esamina drafts/script-v1.md, claims.md, title-caption.md e recording-plan.md. Restituisci un elenco degli impatti: file, passaggio o brano, dipendenza dal fatto corretto, mantenere o cambiare o chiedere, e motivo. Includi promesse implicite, non solo corrispondenze esatte di parole chiave. Non modificare ancora.
3. Approva una modifica mirata e un elenco di nuove registrazioni
Una modifica illustrativa sostituisce «La casella di posta assegna il responsabile per te» con «Scegli il collega che gestirà questa conversazione». L’istruzione a schermo ora deve mostrare il controllo manuale. Se l’apertura prometteva un sistema senza intervento, aggiorna anche quella promessa.
Chiedi a Claude Code di salvare una nuova bozza e spiegare i passaggi cambiati. Le riprese registrate che mostrano ancora il comportamento sbagliato devono comparire nell’elenco da rifare; un file Markdown corretto non le ripara da solo.
Applica solo le decisioni sugli impatti che ho approvato. Scrivi drafts/script-v2.md e changes.md con il vecchio e il nuovo brano, l’ID del passaggio e il fatto di supporto. Aggiorna azioni a schermo e title-caption.md solo dove dipendono dalla correzione. Conserva l’originale approvato. Produci rerecord.md con riprese interessate e acquisizioni dello schermo mancanti; non dichiarare che i file video siano stati modificati.
Collega Kabo quando la riscrittura richiede ricerca di riferimenti
Apri il progetto di contenuto, installa Kabo per Claude Code e completa l’accesso. Per una connessione diretta al server, segui la guida alla configurazione.
4. Usa riferimenti se il passaggio manuale richiede una spiegazione più chiara
Se non riusciamo a spiegare perché conta la responsabilità manuale, usa Kabo per esaminare le scelte didattiche nei tutorial pubblici. Conserva URL reali delle fonti e brevi note di evidenza. Un riferimento può suggerire di affiancare gli stati non assegnato e assegnato, ma non dimostra quali controlli siano disponibili nel nostro prodotto.
Se la correzione è già chiara, salta questo passaggio di ricerca. Per uno studio più ampio, segui la guida alla ricerca con Claude Code.
Usa Kabo per una piccola ricerca di riferimenti su come spiegare l’assegnazione manuale dei responsabili delle conversazioni. Riporta scelte di spiegazione pertinenti con fonti reali e limiti delle evidenze. Suggerisci un modo per chiarire il passaggio corretto usando le schermate di recording-plan.md. Tratta product-facts.md come autorità per le affermazioni sulle funzioni; non riaprire sezioni del copione senza relazione.
5. Consegna un pacchetto di registrazione affidabile per il montatore
Fai aprire al produttore script-v2.md insieme a changes.md e rerecord.md. Verifica che lo stato con responsabile assegnato sia visibile e che l’apertura prometta la lezione che insegniamo davvero. Mantieni una versione approvata chiara per evitare che la vecchia ripresa torni nel montaggio.
Usa Descript o il tuo editor abituale per sostituire la registrazione interessata. Per un problema di voce limitato alle prime battute, la guida Hook di Claude Code si concentra sull’apertura parlata.
Confronta script-v2.md, title-caption.md e recording-plan.md con la correzione approvata. Elenca promesse residue di assegnazione automatica, istruzioni a schermo non corrispondenti o riprese ancora da sostituire. Verifica che i passaggi non modificati restino intatti. Restituisci gli elementi aperti per l’approvazione del produttore; non pubblicare.
Gli esempi sviluppati sono illustrativi. Le schermate del prodotto mostrano risultati esistenti di Kabo sul web, non un’esecuzione dell’esempio di questa guida. Usa i tuoi materiali e le prove restituite dalla tua attività.