warn-before-the-thing-you-are-warning-about
Un avviso messo dopo l'azione a cui si riferisce arriva quando chi legge ha già deciso. Mettilo sopra e, quando conta, rendilo impossibile da ignorare.
Conferita da chi ha letto la scheda, non rivendicata dal file su se stesso. Una scheda che l'agente distilla durante un'esecuzione che ha consumato contenuti non affidabili nasce contaminata e resta in attesa di revisione prima di essere mai recuperata.
Quando viene in mente
- scrivo una pagina di download
- aggiungo un'azione distruttiva
- documento una trappola
- dove va questo avviso
Il valore di solito sta in Evita e Verifica. Fai è la sezione che scrivono tutti.
Il corpo della scheda qui sopra è una traduzione. L'originale inglese è ciò che la CLI importa, ciò che l'agente legge in esecuzione e ciò che l'hash qui sotto attesta.
Trigger
Qualcosa che un utente sta per fare ha una conseguenza che non si aspetta: un installer non firmato che il suo sistema operativo bloccherà, un comando che riscrive la history, un'impostazione che rimuove un essere umano da un loop, un'esportazione che esce dalla sandbox.
Non si applica a conseguenze ovvie dall'etichetta stessa. "Elimina" non ha bisogno di un paragrafo che spieghi che elimina.
Fai
- Metti l'avvertimento sopra il controllo, nell'ordine di lettura, non sotto e non in un tooltip.
- Di' cosa accadrà nei termini dell'utente — l'esatto testo di dialogo che vedrà, l'esatto errore — e poi cosa fare al riguardo.
- Riserva l'interruzione all'irreversibile. Una conferma su un'azione di poco conto abitua le persone a cliccare senza leggere sulla conferma che invece conta.
- Se la sorpresa è inevitabile e innocua, spiega perché accade. "Non c'è un certificato di firma del codice" trasforma un dialogo allarmante in uno atteso.
Evita
Avvertimenti dopo il pulsante, avvertimenti in una sezione comprimibile, e avvertimenti che l'utente può chiudere prima ancora di trovarsi nella situazione. Tutti e tre sono lo stesso fallimento: l'informazione arriva dopo la decisione.
Evita la vaghezza che suona responsabile. "Usa con cautela" non dice al lettore nulla su cui possa agire, e la sua vera funzione è proteggere l'autore piuttosto che l'utente.
Evita di avvertire su tutto. Una pagina in cui sono segnalate cinque cose non ha segnalato nulla, e l'unico elemento genuinamente pericoloso ora è mimetizzato.
Verifica
Leggi la pagina dall'inizio alla fine come qualcuno che non l'ha mai vista, e fermati nel momento in cui cliccheresti. L'avvertimento era prima di quel punto?
Poi verifica l'inverso: conta gli avvertimenti sulla superficie. Se ce n'è più di uno in evidenza, decidi qual è quello vero e retrocedi gli altri.
Rischio
Anticipare gli avvertimenti fa sembrare una pagina più pesante e può spaventare un utente per cui il rischio non è mai stato reale. Quel costo è genuino e vale la pena pagarlo solo dove la sorpresa è genuina.
La modalità di fallimento di un'applicazione eccessiva è un prodotto che si legge come nervoso di se stesso. Se ogni schermata si apre con un disclaimer, i disclaimer diventano decorazione e il lettore li salta — il che ti riporta al punto di partenza, con un copy peggiore.
Come usarla
La scheda è un dato. Clona il repository e importala per percorso — ciò che arriva dalla rete è trattato come contaminato e trattenuto in attesa di approvazione, che è il comportamento desiderabile e il motivo per cui qui non c'è un installatore in una riga.
git clone https://github.com/brcampidelli/chimera-agent.gitchimera skills-import chimera-agent/skills/warn-before-the-thing-you-are-warning-about/SKILL.mdIntegrità
SHA-256 del file così com'è pubblicato. Chi lo importa può verificare che ciò che ha ricevuto sia ciò che questa pagina mostrava.
6406dae5aafa466bdccc3cea9496b6beb40fee9c87b13da623f55e07fc526182