Skip to main content

write-accessible-error-messages

Write accurate error messages that help users understand and recover. Use when forms, workflows, permissions, services, or validation need text that works with assistive technology and without guesswork.

来源信息

仓库
protosphinx/sphinxstack
最近来源活动
2026年7月29日 13:55
检测到的 SKILL.md 语言
英语
星标
3
Forks
0

安装方式

默认使用会先检查来源的 Prompt;你也可以切换为直接命令,或下载本地副本。

检查来源文件

决定是否安装前,请先阅读 SKILL.md,以及 SkillsMP 当前展示的配套文件。

文件资源管理器
2 个文件

正在显示 SKILL.md

SKILL.md
来源说明 · 只读预览
name
write-accessible-error-messages
category
write
description
Write accurate error messages that help users understand and recover. Use when forms, workflows, permissions, services, or validation need text that works with assistive technology and without guesswork.
# write-accessible-error-messages ## Procedure 1. Identify the actual condition, affected action, known cause, safe recovery, and support route. 2. Name the field, object, or task in user language. 3. State what needs attention without blame or internal codes. 4. Give a specific correction, allowed format, retry condition, or alternative. 5. Preserve entered data and distinguish temporary, validation, permission, conflict, and destructive failures. 6. Place field errors beside labels and add an error summary for multi-field submission. 7. Move focus appropriately and announce updates through correct semantics. 8. Keep color, icon, and position supplemental to text. 9. Test long values, localization, screen readers, keyboard, retry, and repeated failure. ## Guardrails - Do not reveal whether a protected account or record exists. - Never promise success when recovery depends on another system. - Avoid vague “invalid” or “something went wrong” where safe detail exists. ## Done - An error-message set maps conditions to clear text and recovery - Focus, announcement, field association, and preserved-input checks pass - Security and localization review are recorded
在 GitHub 查看