关于 contextual-help-design
一项 UX 设计技能，指导团队在用户遇阻的界面提供帮助，涵盖行内说明、任务引导、支持升级和错误恢复。
主要功能
- 01行内说明与示例
- 02分步骤任务引导
- 03跨支持渠道升级
- 04可执行的错误恢复
- 05通俗且可搜索的帮助
适用场景
- 01为复杂表单设计帮助
- 02规划支持升级路径
- 03改进错误状态提示
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/contextual-help-design确认已加载。
详细介绍
情境化帮助设计
设计能在用户需要时提供的帮助——就在他们卡住的屏幕上，用他们能理解的语言，而且无需他们记住自己是如何来到这里的。
核心原则
如果用户遇到困难，他们应该能在不离开当前屏幕的情况下获得帮助。
设计模式
行内帮助
- 在需要说明的字段旁放置工具提示或信息图标
- 在输入字段旁显示示例（“例如，15/03/2026”）
- 对复杂字段默认显示帮助文本
- 为专业术语提供行内释义（下划线 + 工具提示）
- 为不常见的概念提供“这是什么？”链接
引导式任务
- 提供分步向导，作为复杂表单的替代方案
- 提供已完成任务的示例（填写好的示例表单）
- 在“从头开始”旁提供模板或预设选项
- 根据用户当前进度变化的提示
升级支持途径
- 首先提供自助帮助（搜索、常见问题）
- 其次提供聊天或消息支持
- 最后提供电话或视频支持
- 用户在不同渠道间升级求助时，绝不要求他们重新说明问题
- 显示人工支持的预计等待时间
- 绝不要求用户提供参考编号才能获得帮助
错误恢复支持
- 错误消息应说明：发生了什么 + 原因 + 接下来该怎么做
- 直接链接到需要修正的字段或步骤
- 主要途径失败时提供替代方案
- 对于复杂错误，直接提供人工支持
帮助内容规则
- 按相当于小学四至六年级的阅读水平撰写
- 使用与界面相同的术语（不要换成其他说法）
- 每个步骤只包含一条指示
- 对空间或操作步骤的说明配上图片或示意图
- 确保帮助内容可搜索
- 与实际遇到问题的人一起测试帮助内容
评估问题
- 用户能否在不离开当前任务的情况下获得帮助？
- 帮助内容是否使用了与界面一致的通俗语言？
- 自助方式无效时，用户能否在 2 次点击内联系到人工支持？
- 是否为用户实际遇到困难的时刻（而不只是你预想的时刻）提供了帮助资源？
评论
支持 Markdown