跳转到使用指南
ux-copy作者 Anthropic

UX Copy Skill.

Claude Code 和 Codex 的 UX 研究 skill:编写或审查 UX 文案:微文案、错误提示、空状态、CTA。

  • UX & Research
anthropics/knowledge-work-plugins · design/skills/ux-copy/SKILL.mdSKILL.md
--- name: ux-copy description: Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text. --- ## Usage ## What I Need From You ## Principles ## Copy Patterns ## Voice and Tone ## Output
从上游文件读取的 front matter 和章节标题,日期 2026-09-14 · 完整内容 3,424 字符

01 功能说明

ux-copy Skill 在 Claude Code 和 Codex 中的作用

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

一次针对界面文案的编写或审阅:微文案、错误提示、空状态、CTA、确认对话框、工具提示、加载状态和引导流程。你提供屏幕或流程、用户想做什么以及他们的感受、语气以及任何字符限制,它会为每个元素返回一条推荐文案,外加三条带标注的备选方案(含语气和适用场景)、一段理由说明和本地化注意事项。

它的特别之处在于采用固定结构而非随意建议:错误提示遵循「发生了什么 + 原因 + 如何解决」,空状态遵循「这是什么 + 为什么是空的 + 如何开始」,对话框则明确指出操作及其后果。借助连接器,它还能读取品牌语气或在 Figma 中读取流程。

它产出什么

  • 为屏幕上每个命名元素提供一条推荐文案
  • 一份包含 A、B、C 三个选项的备选方案表,各附语气及适用场景
  • 一段简短的理由说明,解释该文案为何适用于该用户情境
  • 本地化注意事项,标出应避免的习语、字符扩展及文化背景
查看示例提示词 ↗

工作方式

  1. 01
    先收集上下文

    在撰写文案之前,它会先询问屏幕、流程或功能,以及用户当下想做什么、感受如何。

  2. 02
    用五项原则审查文案

    清晰、简洁、一致、实用、有人情味——每一条拟定文案都必须通过这一筛选。

  3. 03
    将元素与对应模式匹配

    CTA、错误提示、空状态、确认对话框、工具提示、加载状态和引导流程,在「文案模式」部分各自有专属规则。

  4. 04
    根据情境调整语气

    成功、错误、警告和中性状态各有不同的语调,而不是统一使用一种品牌声音。

  5. 05
    返回模板化输出

    每个元素的推荐文案、包含三个选项的备选方案表、理由说明,以及供译者参考的本地化注意事项。

02 找到适合场景

何时使用 ux-copy Skill

当任务属于此类 UX 研究时,在 Claude Code 或 Codex 中使用 ux-copy skill。适用范围和限制取自该 skill 自身文件。

适合场景

  • 为 CTA 命名、撰写确认对话框文案、填写空状态或编写引导文案
  • 一条支付失败错误提示,需要改写为通俗易懂的语言:"Payment declined. Your card was declined by your bank.
  • 一款已经写好品牌语气指南的产品,可据此匹配文案
  • 你正在 Figma 中设计的屏幕,其中流程和布局限制清晰可见
  • 任何将被翻译、需要关于习语、扩展和文化背景注意事项的文案

了解边界

  • 它不会猜测你的上下文:你必须提供屏幕或流程、用户状态、语气和限制条件。
  • 品牌语气查询和 Figma 屏幕上下文,只有在实际连接了相应连接器时才会生效。
  • 工具提示只会得到一行指引,背后没有结构或示例支撑。

需要提供的信息

  • 语气正式、友好、活泼或安抚,或对你品牌语调的描述。
  • 限制限定措辞的字数限制和平台规范。
  • 文案本身(如果是审查)调用时需要提供撰写所需的上下文,或需要审查的文案。

03 Skill 内部

ux-copy Skill 给 Claude Code 和 Codex 的规则

SKILL.md 为 Agent 设定的 7 条具体指令、默认值与限制——正是文件中真正改变结果的部分。

  1. 错误消息由三部分组成

    按发生了什么、为什么发生、如何解决的顺序来组织。

  2. 空状态由三部分组成

    说明这是什么、为什么是空的、如何开始。

  3. 在确认框中点明具体操作

    在标题中提出真实问题,例如“删除 3 个文件?”,而不是笼统的“确定吗?”。

  4. 按钮文案要标明操作

    按钮上写明其执行的动作,比如用“删除文件” / “保留文件”,而不是“确定” / “取消”。

  5. CTA 以动词开头

    标签以动词开头并具体明确,让结果与标签相符:用“创建账户”而不是“提交”。

  6. 一个概念只用一个术语

    在界面各处对同一概念使用相同的词语。

  7. 一次引导一个概念

    引导文案采用渐进式展开,而不是一开始就解释所有内容。

04 投入使用

在 Claude Code 或 Codex 中安装 ux-copy

一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 ux-copy 添加到 Claude Code、Codex 或你的 Agent

在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

Terminal
npx skills add https://github.com/anthropics/knowledge-work-plugins --skill ux-copy

适用于 design/skills/ux-copy/SKILL.md 的通用 skills CLI 形式;仓库可能会记录其自身的路径。

给 Skill 第一个 UX 研究任务

按 skill 自身的术语撰写;把括号中的部分换成你的内容。

Starter prompt
Write copy for the [checkout] screen. The user just tried to pay and their card was declined, so they are frustrated and need to know what to do next. Tone should be empathetic but not wordy, and the retry button has a [20] character limit on [iOS].

来源:依据 SKILL.md,按 skill 自身的术语撰写。

检查首次结果

SKILL.md 本身如何描述正确的结果:

  • 逐行检查字数:意义完整且最短的版本胜出。
  • 对每个词都问一句,它是否帮助用户实现其目标。
  • 确认加载文案能设定预期、缓解焦虑,而不只是转圈动画。
  • 将结果与你提供的品牌语调进行比对,并根据用户的情绪状态做出调整。
  • 重新检查你提供的上下文是否足够具体,例如指明具体的失败条件,而不是笼统地写“错误消息”。

在 OpenDesign 中通过其 SKILL.md 链接导入 ux-copy:Plugins → Add → Skill → Import from link,然后在顶部栏中选择它。

05 开源、可追溯

来源、许可与验证

本页面事实的来源,以及最后检查时间。

Author
Anthropic
Skill 文件
design/skills/ux-copy/SKILL.md 验证时记录的内容校验和;commit 8f877b6
License
Apache-2.0 来自 LICENSE。
仓库星标数
24,012 GitHub 快照拍摄于 2026-09-14,针对整个 anthropics/knowledge-work-plugins 仓库,该仓库在此目录中包含 7 个 skills。不是 ux-copy 的评分或使用计数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. 用法如何调用:斜杠命令,以上下文或文案作为参数
  2. 需要你提供的信息四项输入:上下文、用户状态、语气和约束条件
  3. 原则每段文案都应具备的五种品质:清晰、简洁、一致、有用、有人情味
  4. 文案模式针对各元素的规则:CTA、错误提示、空状态、对话框、工具提示、加载状态、引导流程
  5. 语气与风格语气如何随成功、错误、警告和中性场景变化
  6. 输出markdown 模板:推荐文案、备选方案表、理由说明、本地化注意事项
  7. 可用连接器时已连接的知识库或设计工具能为文案增添的内容
  8. 提示说明具体的上下文、分享品牌语气、考虑用户情绪状态
Skill 自身的描述
「编写或审查 UX 文案——微文案、错误消息、空状态、CTA。使用「为…编写文案」、「这个按钮应该说什么?」、「审查此错误消息」触发,或在命名 CTA、编写确认对话框、填充空状态或编写引导文本时触发。」

来自 SKILL.md 的前置描述。完整文件大约 3,424 个字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 ux-copy skill 的常见问题

以下回答来自 2026-09-14 读取到的 SKILL.md,而非某次实际运行的记录。

它能直接使用我们现有的品牌语气吗?

只有在连接了知识库连接器的情况下才可以,此时它会读取你的品牌语气指南和内容风格指南,并检查现有文案模式和术语。否则你需要在请求中描述语气。

最终返回的内容具体是什么?

一个标题为 UX Copy 的 markdown 区块,包含上下文说明、每个元素的推荐文案、一份三种备选方案的表格(各标注语气和适用场景)、理由说明,以及供译者参考的本地化注意事项。

它能查看我实际的界面吗?

如果连接了设计工具连接器,它会在 Figma 中查看界面上下文以理解完整的用户流程,并根据设计检查字符限制和布局约束。若未连接,则需用文字描述该流程。

UX Copy

在真实的 UX Research 任务中运行 ux-copy。

下载 OpenDesign,从其 SKILL.md 链接导入 ux-copy,粘贴上述提示,在结果前阅读计划。

终端
npx skills add https://github.com/anthropics/knowledge-work-plugins --skill ux-copy

OpenDesign 桌面客户端

一套设计系统,让每一次创作都保持品牌一致

在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

  • 覆盖网页、PPT、原型、数据看板、图像与视频
  • 140+ 设计系统,以及完整模板与技能库
  • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
免费下载

支持 macOS 与 Windows