warn-before-the-thing-you-are-warning-about
Una advertencia colocada después de la acción a la que se refiere llega cuando el lector ya decidió. Ponla arriba y, cuando importa, haz que no se pueda descartar.
Conferida por quien revisó y leyó la tarjeta, no reclamada por el propio archivo. Una tarjeta que el agente destila durante una ejecución que consumió contenido no confiable nace contaminada y queda retenida para revisión antes de ser recuperada.
Cuándo viene a la mente
- escribiendo una página de descarga
- agregando una acción destructiva
- documentando una trampa
- dónde va esta advertencia
Evita y Comprueba es donde suele estar el valor. Haz es la sección que todo el mundo escribe.
El cuerpo de la tarjeta de arriba es una traducción. El original en inglés es lo que importa la CLI, lo que lee el agente en ejecución y lo que atestigua el hash de abajo.
Disparador
Algo que un usuario está a punto de hacer tiene una consecuencia que no esperará: un instalador sin firmar que su sistema operativo bloqueará, un comando que reescribe el historial, un ajuste que elimina a un humano de un ciclo, una exportación que sale del sandbox.
No aplica a consecuencias que son obvias por la etiqueta. «Eliminar» no necesita un párrafo explicando que elimina.
Haz
- Coloca la advertencia por encima del control, en el orden de lectura, no debajo y no en un tooltip.
- Di qué va a pasar en los términos del usuario — el texto exacto del diálogo que verá, el error exacto — y luego qué hacer al respecto.
- Reserva la interrupción para lo irreversible. Una confirmación en una acción menor entrena a la gente a hacer clic sin leer en la confirmación que sí importa.
- Si la sorpresa es inevitable y benigna, explica por qué ocurre. «No hay un certificado de firma de código» convierte un diálogo alarmante en uno esperado.
Evita
Advertencias después del botón, advertencias en una sección colapsada, y advertencias que un usuario puede descartar antes de haber llegado a la situación. Los tres son el mismo fallo: la información llega después de la decisión.
Evita la vaguedad que suena responsable. «Usar con precaución» no le dice al lector nada sobre lo que puede hacer, y su función real es proteger al autor en lugar de al usuario.
Evita advertir sobre todo. Una página donde se marcan cinco cosas no ha marcado nada, y el único elemento genuinamente peligroso queda ahora camuflado.
Comprueba
Lee la página de arriba a abajo como alguien que nunca la ha visto, y detente en el momento en que harías clic. ¿Estaba la advertencia por encima de ese punto?
Luego verifica lo inverso: cuenta las advertencias en la superficie. Si hay más de una prominente, decide cuál es la real y degrada el resto.
Riesgo
Anteponer advertencias hace que una página se sienta más pesada y puede espantar a un usuario para quien el riesgo nunca fue real. Ese costo es genuino y vale la pena pagarlo solo donde la sorpresa es genuina.
El modo de fallo de aplicar esto en exceso es un producto que se lee como nervioso de sí mismo. Si cada pantalla abre con un descargo de responsabilidad, los descargos se vuelven decoración y el lector se los salta — lo cual te deja de vuelta donde empezaste, con peor redacción.
Cómo usarla
La tarjeta es un dato. Clona el repositorio e impórtala por ruta: lo que llega por la red se trata como contaminado y queda retenido a la espera de aprobación, que es el comportamiento deseable y la razón por la que aquí no hay un instalador de una línea.
git clone https://github.com/brcampidelli/chimera-agent.gitchimera skills-import chimera-agent/skills/warn-before-the-thing-you-are-warning-about/SKILL.mdIntegridad
SHA-256 del archivo tal como se publicó. Quien lo importe puede comprobar que lo que recibió es lo que mostró esta página.
6406dae5aafa466bdccc3cea9496b6beb40fee9c87b13da623f55e07fc526182