SuperAPI AI 工具集

stop-describing-ui

设计与创作

查看项目

更新于 10-15 17:03

技能介绍

用途

停写说明书(stop-describing-ui)用于去除用户界面中带有解释性质的文案。其立场是:界面展示用户能做什么,界面不需要自我解释。每一句话都是用户在行动前必须先阅读的内容,因此只有当缺少它会使用户犯下真实错误时,才保留该句。

该技能适用于撰写、编辑或审查任何 UI 文本,包括标题、空状态、按钮标签、开关等控件文案。

主要规则

  1. 不要描述功能:改为命名动作。标题、控件及其标签本身已经说明屏幕用途。
  2. 使用具体动词:选择能指明实际发生什么的动词,并给它配上作用对象。避免使用 New、Create、Manage、Set up、Configure、Go、OK 等笼统动词。
  3. 只保留最关键的一条后果:当一个动作有多个影响时,只说明最重要的一个,其余由该后果隐含。不可逆或破坏性影响(如删除数据、扣费、通知客户)属于关键后果,始终保留。
  4. 不要描述后端行为:数据存于何处、记录了什么、同步了什么、后台运行什么,都不是用户关心的事。
  5. 同一控件可撤销时不要解释如何撤销:关闭某功能的开关也能重新打开它。只有当撤销需要另一个控件或位置时才说明如何撤销。
  6. 不要解释页面已经告诉用户的内容:页面标题、导航和分区结构本身携带含义。
  7. 不要陈述不存在的内容:当屏幕已经显示时,不要写“暂无项目”或“无法切换”。例外是用户否则会尝试并失败的限制,例如其角色无法执行的操作,保留为配图标的一行短句。
  8. 展示如何启用,不要用文字描述:如果某功能需要通过订阅、升级、连接或打开设置来启用,就把对应按钮或开关放在屏幕上,而不是写一句话告诉用户去哪里做什么。
  9. 不要只依赖文字:把长文拆成短句,每句以图标开头,用间距和分组来组织结构。不要使用 ->、>、|、✔️、!、→ 或 : 作为分隔符、箭头、项目符号或强调,改用图标或间距。

使用方式

撰写 UI 文案时,边写边套用以上规则。审查 UI 文案时,逐条字符串套用每条规则,并以修改前后的对照形式呈现结果。

检查清单

对每条字符串依次提问:

  1. 它是否在解释功能是什么?删除它,或改成具体的动作标签。
  2. 动词是否笼统?替换为能命名真实动作及其对象的动词。
  3. 它是否列出多个后果?只保留最关键的一个。
  4. 它是否提到存储、日志、同步或其他内部机制?删除。
  5. 它是否解释如何用同一控件撤销?删除。
  6. 页面标题或导航是否已经说明?删除。
  7. 它是否在说某物缺失或不可用?删除,除非用户否则会尝试并失败。
  8. 它是否在告诉用户如何启用某功能?替换为按钮或开关。
  9. 它是否是一整段文字,或用符号作分隔符?拆分为图标开头的短句并使用间距。

如果检查后什么都不剩,那就什么都不留。空的辅助文字槽位优于填充句。

适用场景与限制

该技能面向 UI 文案的撰写与审查,附带修改前后的对照示例和逐条检查清单。资料未提供其具体实现形式、安装命令、支持的平台或工具集成方式,这些信息暂未提供。