SuperAPI AI 工具集

ux-writing-skill

设计与创作

查看项目

更新于 10-15 17:07

技能介绍

ux-writing-skill 是一个用于数字产品界面文案的系统性 UX 写作技能,属于 content-designer/ux-writing-skill 的目录条目。它的核心目标是为所有界面文案应用统一的 UX 写作标准,帮助产品中的每一处文字都符合一致的质量要求。

用途 该技能用于处理数字产品中的界面文案(UI copy),即用户在产品界面中直接看到的文字,例如按钮标签、错误提示、空状态说明、表单提示、通知消息和引导流程文案等。它通过一套可复用的质量标准,让界面文案在目的性、简洁度、语气和清晰度上保持一致。

主要能力 该技能围绕四个质量维度评估和撰写文案:

  • Purposeful(有目的):文案应服务于用户目标。
  • Concise(简洁):标签类文案控制在 8–14 个词。
  • Conversational(对话式):使用主动语态和第二人称。
  • Clear(清晰):避免术语和行话。

它覆盖以下常见 UI 文案模式:

  • 按钮与 CTA:使用动作动词标签,区分主要、次要和破坏性操作。
  • 错误消息:说明发生了什么、为什么发生、如何修复,且不指责用户。
  • 空状态:包含目的、价值主张和行动号召。
  • 表单标签与占位符:区分标签、提示、占位符和验证信息。
  • 通知与提示(toasts):校准紧急程度,撰写关闭文案。
  • 引导流程(onboarding):渐进式披露、设置文案、成功时刻。
  • 无障碍:面向屏幕阅读器的措辞、aria-label 指导、认知负荷控制。

使用方式 该技能通过技能安装机制集成到智能体环境中。安装前先判断完整技能是否已安装:

  • 全局检查:grep -q "^das:" ~/.agents/skills/ux-writing-skill/SKILL.md 2>/dev/null && echo "pointer" || echo "installed"
  • 项目检查:grep -q "^das:" .agents/skills/ux-writing-skill/SKILL.md 2>/dev/null && echo "pointer" || echo "installed"

如果没有 das: 块,说明完整技能已安装,可直接调用并继续。如果存在 das: 块,则进入下一步。

检测作用域并安装:

  • 检测: [ -e ~/.agents/skills/ux-writing-skill ] && echo "global" || echo "project"
  • 全局安装:npx skills add content-designer/ux-writing-skill --skill ux-writing-skill -g -y
  • 项目安装:npx skills add content-designer/ux-writing-skill --skill ux-writing-skill -y

在 Claude Code 中,可以将上述任一命令作为以 ! 开头的聊天消息发送,从而在不离开对话的情况下运行。

安装后调用:

  • 技能名称:ux-writing-skill
  • 触发词:"UX writing"、"microcopy"、"error message copy"、"empty state copy"、"button label"、"UI copy"

适用场景 适用于需要撰写或优化界面文案的产品设计与开发场景,尤其是按钮、错误提示、空状态、表单、通知、引导流程和无障碍文案等具体界面元素。

限制 该技能不适用于以下情况:

  • 长篇产品营销文案:应使用 copywriting-skill。
  • 去除现有文本中的 AI 写作痕迹:应使用 humanize-text。
  • 完整的内容策略或信息架构:应使用 design-with-claude(content-strategist)。

关于该技能的收费、价格、平台支持范围等更多信息,资料中暂未提供。