SuperAPI AI 工具集

ss-copy

设计与创作

查看项目

更新于 10-15 14:47

技能介绍

用途

ss-copy 是一个 UX 微文案(microcopy)生成技能,用于为界面中的短文本提供符合特定语气与语调的文案,包括按钮标签、错误消息、空状态和 Toast 通知等。其语气定位为“随意但礼貌”(casual-but-polite),像与一位乐于助人的朋友交谈,而非机械的机器人腔调。

主要能力

该技能在生成文案前会先读取 engine/UX-WRITING.md 作为规则集,并参考 DESIGN-LANGUAGE.md 中关于 Microcopy Tone Guide 与 UX Writing 的章节。其核心语气原则包括:

  • 随意但礼貌:友好而非机械。
  • 主动语态:如“We saved your changes”,而非“Your changes have been saved”。
  • 正向表达:如“Free shipping on orders over $30”,而非“Orders under $30 have shipping fees”。
  • 平实语言:如“Send money”,而非“Initiate transfer”。
  • 简洁:每个词都必须有其价值。

针对不同上下文,技能内置了对应的文案模式:

  • 按钮标签(CTA):格式为[动作动词]+[对象](可选)。示例:“Place order”“Get started”“Save changes”“Try again”;反例:“Submit”“OK”“Click here”“Proceed to next step”。每屏一个主 CTA,标签需清楚描述下一步,主 CTA 最多 3 个词。
  • 空状态:格式为[友好观察]+[建议操作]。示例:“No activity yet. Create your first project to get started.”;反例:“No data found.”。始终建议下一步操作,使用相关图标(32px,text-text-tertiary),语气鼓励而非指责。
  • 错误消息:格式为[发生了什么]+[该怎么做]。示例:“Couldn't load the data. Please try again.”;反例:“Error 500: Internal Server Error”。不向用户展示技术错误,归咎于系统而非用户,始终提供恢复操作。
  • Toast 通知:格式为[对已发生事情的确认]。示例:“Saved!”“Changes applied”“Item deleted · Undo”;反例:“Operation completed successfully”。最多 2 行,可逆的破坏性操作需包含“Undo”链接。信息类 Toast 显示 3 秒,操作类 Toast 显示 5 秒。
  • 表单标签与辅助文本:标签用名词短语(“Email address”“Password”);占位符用示例或提示(“name@example.com”);辅助文本用格式指引(“Must be at least 8 characters”);错误用具体问题(“This email is already registered”)。
  • 确认对话框:标题为[关于动作的问题],正文为[后果说明],主按钮为[动作动词](“Delete”“Confirm”),次按钮为“Close”(而非“Cancel”,以避免混淆)。

生成时,技能会提供:主文案(要显示的内容)、变体(若上下文有变化)以及针对该上下文的 Do's 和 Don'ts。

使用方式

该技能遵循注册表优先的产物边界:当 .styleseed/project.json 与 .styleseed/artifacts/index.json 存在时,先解析请求的 artifact ID,然后只读取 .styleseed/bundles/<artifact-id>.md 与 .styleseed/manifests/<artifact-id>.json。对于注册表项目,绝不回退到全局旧版 bundle。旧版项目仅在没有注册表时使用 .styleseed/effective-rules.md。

使用前需遵循每会话一次的更新预检(once-per-session update preflight)。技能接收上下文(Context: $0)与描述(Description: $ARGUMENTS)作为输入。

适用场景

适用于需要生成界面短文案的场景,如按钮标签、错误提示、空状态、Toast 通知、表单标签与辅助文本、确认对话框等。对于韩语/CJK 项目,可参考 §W8 中关于 clear-calm-human“Toss feel”的指引(존댓말 일관성、사용자 관점“내 계좌”、군더더기 빼기)。

限制

以下情况不适用:

  • 长文内容(博客文章、文档、营销页面)——超出范围。
  • 完整的反馈状态设计(不仅是文本)——应使用 /ss-feedback。
  • 品牌语调/语气定义本身——该技能消费语调规范,不创建它。
  • 翻译为非英语语言——仅支持单语言。