Back to Details

ss-copy

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

UX Microcopy Generator

UX微文案生成器

When NOT to use

不适用场景

  • For long-form content (blog posts, docs, marketing pages) — out of scope
  • For full feedback state design (not just text) → use 
    /ss-feedback
  • For brand voice/tone definition itself — this skill consumes a voice spec, doesn't create it
  • For translations to non-English languages — single-language only
Context: $0 Description: $ARGUMENTS
Read 
engine/UX-WRITING.md
first — it's the rule set this skill applies: buttons name the action (not "Submit"), errors help instead of blame, empty states invite, money copy stays calm, one term per concept. Korean/CJK projects: see §W8 for the clear-calm-human "Toss feel" (존댓말 일관성, 사용자 관점 "내 계좌", 군더더기 빼기).
  • 长内容（博客文章、文档、营销页面）——超出适用范围
  • 完整反馈状态设计（不只是文本）→ 使用
    /ss-feedback
  • 品牌语气定义本身——本技能基于已有的语气规范生成文案，不负责创建规范
  • 非英语语言翻译——仅支持单语言
上下文: $0 描述: $ARGUMENTS
请先阅读
engine/UX-WRITING.md
——这是本技能遵循的规则集：按钮要明确动作（而非"Submit"），错误提示要提供帮助而非指责，空状态提示要引导用户，涉及金钱的文案要保持冷静，同一概念统一术语。韩语/CJK项目：请查看§W8中清晰、冷静、人性化的"Toss风格"（존댓말 일관성, 사용자 관점 "내 계좌", 군더더기 빼기）。

Instructions

操作说明

  1. Read the design language reference:
    • DESIGN-LANGUAGE.md
      sections on Microcopy Tone Guide and UX Writing
  2. Apply the voice principles:
  1. 阅读设计语言参考文档：
    • DESIGN-LANGUAGE.md
      中关于微文案语气指南和UX写作的章节
  2. 应用语气原则：

Tone Rules

语气规则

  • Casual but polite: Friendly, not robotic. Like talking to a helpful friend.
  • Active voice: "We saved your changes" not "Your changes have been saved"
  • Positive framing: "Free shipping on orders over $30" not "Orders under $30 have shipping fees"
  • Plain language: "Send money" not "Initiate transfer"
  • Concise: Every word must earn its place
  • 亲切礼貌：友好自然，不要生硬刻板，就像和乐于助人的朋友交谈一样。
  • 主动语态：使用“我们已保存你的更改”而非“你的更改已被保存”
  • 正向表述：使用“订单满30美元免运费”而非“订单未满30美元需支付运费”
  • 简洁直白：使用“转账”而非“发起转账操作”
  • 简洁凝练：每一个词都要有存在的意义

Copy Patterns by Context

不同场景的文案模板

Button Labels (CTA)

按钮标签（CTA）

Format: [Action verb] + [Object] (optional)
Good: "Place order", "Get started", "Save changes", "Try again"
Bad:  "Submit", "OK", "Click here", "Proceed to next step"
  • One primary CTA per screen
  • Label must clearly describe what happens next
  • Max 3 words for primary CTA
格式: [动作动词] + [对象]（可选）
示例："Place order", "Get started", "Save changes", "Try again"
反例："Submit", "OK", "Click here", "Proceed to next step"
  • 每个页面仅保留一个主要CTA
  • 标签必须清晰描述后续动作
  • 主要CTA最多3个单词

Empty States

空状态提示

Format: [Friendly observation] + [Suggested action]
Good: "No activity yet. Create your first project to get started."
Bad:  "No data found."
  • Always suggest a next action
  • Use a relevant icon (32px, text-text-tertiary)
  • Tone: encouraging, not blaming
格式: [友好表述] + [建议操作]
示例："还没有任何活动。创建你的第一个项目开始吧。"
反例："未找到数据。"
  • 务必给出下一步建议操作
  • 使用相关图标（32px，text-text-tertiary）
  • 语气：鼓励性，而非指责性

Error Messages

错误提示

Format: [What happened] + [What to do]
Good: "Couldn't load the data. Please try again."
Bad:  "Error 500: Internal Server Error"
  • Never show technical errors to users
  • Blame the system, not the user
  • Always provide a recovery action
格式: [问题说明] + [解决方法]
示例："无法加载数据，请重试。"
反例："Error 500: Internal Server Error"
  • 切勿向用户展示技术错误信息
  • 归咎于系统，而非用户
  • 务必提供补救措施

Toast Notifications

弹窗通知（Toast）

Format: [Confirmation of what happened]
Good: "Saved!", "Changes applied", "Item deleted · Undo"
Bad:  "Operation completed successfully"
  • Max 2 lines
  • Include "Undo" link for reversible destructive actions
  • Info toasts: 3 seconds. Action toasts: 5 seconds.
格式: [操作确认信息]
示例："已保存！", "更改已应用", "项目已删除 · 撤销"
反例："操作成功完成"
  • 最多2行内容
  • 可逆的破坏性操作需包含“撤销”链接
  • 信息类弹窗：显示3秒。操作类弹窗：显示5秒。

Form Labels & Helpers

表单标签与辅助说明

Label: Noun phrase ("Email address", "Password")
Placeholder: Example or hint ("name@example.com")
Helper: Format guidance ("Must be at least 8 characters")
Error: Specific issue ("This email is already registered")
标签: 名词短语（"Email address", "Password"）
占位符: 示例或提示（"name@example.com"）
辅助说明: 格式指引（"至少8个字符"）
错误提示: 具体问题（"该邮箱已注册"）

Confirmation Dialogs

确认对话框

Title: [Question about the action]
Body: [Consequence explanation]
Primary: [Action verb] ("Delete", "Confirm")
Secondary: "Close" (not "Cancel" — avoids confusion)
  1. Generate copy for the requested context, providing:
    • Primary copy (what to display)
    • Variants (if context varies)
    • Do's and Don'ts for the specific context
标题: [关于操作的问题]
正文: [后果说明]
主要按钮: [动作动词]（"Delete", "Confirm"）
次要按钮: "Close"（而非"Cancel"——避免混淆）
  1. 根据请求的场景生成文案，需包含：
    • 主文案（展示内容）
    • 变体（若场景存在差异）
    • 该场景下的注意事项（Do's and Don'ts）