关于 ux-writing
ux-writing 是面向界面文案创作者的写作技能，提供清晰、简洁且有帮助的文案原则，涵盖常见界面状态。
主要功能
- 01清晰、简洁且有帮助的原则
- 02以动作动词撰写按钮标签
- 03说明问题及解决办法的错误消息
- 04空状态与加载文案
- 05成功消息与后续步骤
- 06按情境调整语气
适用场景
- 01撰写界面按钮标签
- 02说明错误及其解决方法
- 03编写空白页或加载提示
- 04组织引导流程和成功消息
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/ux-writing确认已加载。
详细介绍
用户体验文案
撰写清晰、有帮助的文案，引导用户使用你的界面。
核心原则
1. 清晰胜过巧妙
- 使用简单、熟悉的词语
- 避免使用行话和专业术语
- 直截了当地表达
2. 简洁明了
- 删除不必要的词语
- 每句话只表达一个意思
- 把重要信息放在前面
3. 提供帮助
- 告诉用户该怎么做，而不只是描述发生了什么
- 提供后续步骤
- 减少焦虑和不确定感
按钮标签
应该
- 使用表示操作的动词：“保存”“发送”“创建”
- 明确具体：“添加到购物车”，而不是“提交”
- 符合用户意图：“免费注册”
不应该
- 过于笼统：“好的”“提交”“继续”
- 含糊不清：“点击此处”“前往”
- 使用负面表述：“不要取消”
示例
| 不用 | 改用 |
|---|---|
| 提交 | 发送消息 |
| 好的 | 知道了 |
| 继续 | 下一步：付款 |
| 取消 | 继续编辑 |
| 是/否 | 删除 / 保留 |
错误消息
公式
发生了什么 + 原因 + 如何修复
示例
❌ “错误 404” ✅ “找不到页面。试试搜索，或返回主页。”
❌ “输入无效” ✅ “请输入有效的电子邮件地址（例如 [email protected]）”
❌ “出了点问题” ✅ “我们无法保存你的更改。请检查网络连接后重试。”
指南
- 明确说明问题
- 避免指责（例如“你输入了……”）
- 提供解决方案
- 使用通俗易懂的语言，而不是错误代码
空状态
应包含的内容
- 这个区域的用途
- 它为什么是空的
- 如何填充内容
示例
没有搜索结果 “没有找到与‘xyz’相关的结果。试试其他关键词，或检查拼写。”
收件箱为空 “还没有消息。有人联系你时，消息会显示在这里。”
首次使用 “你的项目会显示在这里。创建第一个项目，开始使用吧。”
加载与进度
短暂等待（< 2 秒）
只显示加载指示器，无需文字
中等时长的等待（2-10 秒）
“正在加载你的仪表板……” “正在保存更改……”
长时间等待（> 10 秒）
“正在处理你的视频。这通常需要 1-2 分钟。” 尽可能显示进度百分比
成功消息
明确具体
❌ “成功！” ✅ “你的个人资料已更新。”
确认操作
“消息已发送至 [email protected]” “订单 #12345 已确认，将于 2-3 天内发货。”
提示后续步骤
“密码已更改。你现在可以使用新密码登录。”
工具提示与提示信息
适用场景
- 解释不熟悉的界面元素
- 为操作提供背景信息
- 显示键盘快捷键
保持简短
- 少于 150 个字符
- 每条工具提示只讲一个概念
- 不要放入关键信息（工具提示默认隐藏）
引导文案
欢迎消息
- 肯定这一重要时刻
- 说明接下来的安排
- 指出第一个操作
示例： “欢迎使用 Acme！只需 3 个简单步骤，即可设置好你的工作区。”
渐进式展示
- 不要一次性解释所有内容
- 在功能相关时再介绍
- 优先使用行内提示，而不是教程
语气与风格指南
风格（保持一致）
- 友好而专业
- 清晰而直接
- 乐于助人、给予支持
语气（根据情境调整）
| 情境 | 语气 |
|---|---|
| 成功 | 欢欣、温暖 |
| 错误 | 冷静、提供帮助 |
| 警告 | 严肃、清晰 |
| 引导 | 鼓励、耐心 |
| 设置 | 中性、信息明确 |
评论
支持 Markdown