SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场ux-writing

ux-writing

写作与研究

查看项目

更新于 10-16 06:03

技能介绍

用途

ux-writing 是一个界面微文案与 UX 写作规范技能，用于统一产品中按钮、错误消息、空状态、加载状态、表单标签、确认弹窗、工具提示和引导流程的文案标准。它适用于需要可复用判断、领域约束或成熟工作流的任务，而不是临时性建议。

主要能力

该技能覆盖以下写作领域：

  • 核心原则：具体、简洁、主动语态、人性化、有帮助、一致。
  • 按钮标签：采用“动词 + 名词”公式，主按钮始终为动词加名词，取消/关闭需说明实际结果，破坏性操作需点明破坏对象，禁止使用“Submit”“OK”，统一使用句首大写。
  • 错误消息：采用三段式公式——发生了什么、为什么、如何修复；不得归咎用户、不得只显示错误码、不得使用“Something went wrong”、不得使用幽默，错误应就近内联展示，并使用红色样式加图标（不能仅靠颜色）。
  • 空状态：采用三段式公式——确认状态、解释价值、提供操作；不得留白屏，应使用插画或图标增加温度，操作按钮应与正常“创建”操作一致，搜索空状态应建议更正、相关结果或更宽泛筛选。
  • 加载状态：需具体命名操作，如“Saving your draft...”“Uploading 3 of 12 photos...”；小于 80ms 跳过加载状态，小于 2s 使用内联指示器，大于 4s 增加预计剩余时间或上下文；不得使用幽默加载文案。
  • 成功消息：需具体且简短，包含相关细节（名称、邮箱、金额），以非阻塞 toast 或内联确认展示，5-8 秒自动消失，可撤销操作应包含撤销动作，常规操作不庆祝。
  • 确认弹窗：应少用，多数操作应可撤销；仅用于不可逆破坏性操作、有重大后果的操作或涉及金钱的操作；结构为标题命名操作、正文说明后果、主按钮命名操作（破坏性用红色）、次按钮命名安全选项；禁止“Are you sure?”和“Yes/No”。
  • 表单标签与帮助文本：标签始终可见，简短具体，去掉“My/Your”，句首大写；帮助文本置于字段上方，解释格式或约束，仅用于非显而易见的要求；占位符仅用于示例，不得作为标签或帮助文本。
  • 语气与语调：voice 保持一致，tone 随场景调整（引导温暖、成功简短、错误冷静、破坏性严肃、空状态乐观、等待安心）。
  • 写作可访问性：链接文本需脱离上下文可理解，替代文本区分信息性、装饰性和功能性图像，仅图标按钮必须有 aria-label，使用 aria-describedby 连接帮助文本，使用 aria-live="polite" 播报动态状态。
  • 翻译就绪性：为文本扩展预留空间（德语 +30-35%、法语 +15-20%、芬兰语 +30-40%、中日韩 -10-30% 但可能需更高行高、阿拉伯语/希伯来语 RTL 布局），不得硬编码字符串宽度，数字、日期、货币作为独立标记，避免习语、双关和文化引用，使用 ICU MessageFormat 处理复数，用伪本地化测试。
  • 一致性规则：一个概念一个术语，一种交互一种模式，维护术语表；常见需统一的选择包括 Delete（不要混用 Remove/Trash/Discard）、Edit（不要混用 Modify/Change/Update）、Create（不要混用 Add/New/Make）、Settings（不要混用 Preferences/Options/Configuration）、Sign in（不要混用 Log in/Login）。
  • 质量检查清单：涵盖按钮、错误、空状态、加载、确认弹窗、链接文本、术语一致性、语气匹配、避免 AI 套话词汇（如 leverage、robust、seamlessly、delve）、i18n 文本扩展测试、仅图标按钮 aria-label。

使用方式

使用该技能时，应先阅读 SKILL.md，然后仅加载任务所需的引用深入文件。按有序指引、检查清单和决策规则执行，而不是挑选孤立片段。产出交付物时，需在重要处明确假设、风险和后续工作。输出应面向执行、简洁，并与仓库基线工程标准保持一致；除非技能明确要求更强标准，否则保留与现有项目约定兼容。优先采用确定性、可审查的步骤，而非模糊建议或特定工具魔法。

适用场景

适用于需要界面微文案标准、评审或生成的任务，例如按钮标签、错误消息、空状态、加载状态、表单标签、确认弹窗、工具提示和引导流程的写作与审查。该技能范围仅限应用内短文案；长文内容（文章、博客、营销页面）应改用 content-writing。

限制

若任务与 ux-writing 无关，或更适合由更具体的配套技能处理，则不应使用。若请求只需简单回答，且该技能的约束或参考没有实质帮助，也不应使用。使用前需收集相关项目上下文、约束和具体问题，并确认期望的交付物类型。不得将示例视为可复制粘贴的真理而不检查适用性、约束或失败模式，也不应默认加载所有参考文件，而应使用渐进式披露。

配套技能

该技能列出以下配套技能及加载时机：practical-ui-design（文本样式视觉系统）、form-ux-design（深层表单标签与验证模式）、content-writing（长文文案写作）、language-standards（多语言标准 EN/FR/SW）、ai-slop-prevention（捕捉通用 AI 文案模式）。

产出证据

该技能可产出 UX 质量类工件，例如内容与微文案评审，格式为 Markdown 文档，评审按钮标签、错误、空状态和确认，示例路径为 docs/ux/content-review-checkout.md。

来源

资料中列出的来源包括：Impeccable ux-writing reference (Bakaus, 2025)；UX Writing Hub 的微文案模式；Nielsen Norman Group 错误消息指南。