warn-before-the-thing-you-are-warning-about
A caution placed after the action it concerns arrives after the reader has already decided. Put it above, and make it undismissable when it matters.
Присвоено человеком, который прочитал карточку, а не заявлено файлом о самом себе. Карточка, которую агент выводит во время запуска, поглотившего недоверенное содержимое, рождается заражённой и удерживается на разбор, прежде чем её вообще извлекут.
Когда это вспоминается
- writing a download page
- adding a destructive action
- documenting a footgun
- where should this warning go
Ценность обычно лежит в разделах «Избегать» и «Проверить». «Делать» — это раздел, который пишут все.
Повод
Something a user is about to do has a consequence they will not expect: an unsigned installer their OS will block, a command that rewrites history, a setting that removes a human from a loop, an export that leaves the sandbox.
It does not apply to consequences that are obvious from the label. "Delete" does not need a paragraph explaining that it deletes.
Делать
- Put the caution above the control, in the reading order, not below it and not in a tooltip.
- Say what will happen in the user's terms — the exact dialog text they will see, the exact error — and then what to do about it.
- Reserve interruption for the irreversible. A confirmation on a narrowing action trains people to click through the confirmation that matters.
- If the surprise is unavoidable and benign, explain why it happens. "There is no code-signing certificate" converts an alarming dialog into an expected one.
Избегать
Warnings after the button, warnings in a collapsed section, and warnings that a user can dismiss before they have met the situation. All three are the same failure: the information arrives after the decision.
Avoid vagueness that sounds responsible. "Use with caution" tells the reader nothing they can act on, and its real function is to protect the author rather than the user.
Avoid warning about everything. A page where five things are flagged has flagged nothing, and the one genuinely dangerous item is now camouflaged.
Проверить
Read the page top to bottom as someone who has never seen it, and stop at the moment you would click. Was the caution above that point?
Then check the inverse: count the warnings on the surface. If there is more than one prominent one, decide which is the real one and demote the rest.
Риск
Front-loading cautions makes a page feel heavier and can scare off a user for whom the risk was never real. That cost is genuine and worth paying only where the surprise is genuine.
The failure mode of over-applying this is a product that reads as nervous about itself. If every screen opens with a disclaimer, the disclaimers become chrome and the reader skips them — which puts you back where you started, with worse copy.
Как применить
Карточка — это данные. Склонируйте репозиторий и импортируйте её по пути: всё, что приходит по сети, считается заражённым и удерживается до одобрения — это и есть желаемое поведение, и поэтому здесь нет установщика в одну строку.
git clone https://github.com/brcampidelli/chimera-agent.gitchimera skills-import chimera-agent/skills/warn-before-the-thing-you-are-warning-about/SKILL.mdЦелостность
SHA-256 файла в опубликованном виде. Импортёр может проверить, что полученное совпадает с показанным на этой странице.
7cd3c2d953bf1d3b51901ab66347944751a673072258afb4d9abccb8933f46e7