Communitygithub.com

abworks-dev/ui-without-noise

在创建或审查界面时,移除多余的解释性文案和组件,同时保留必要的标签、约束、风险、权限和未知状态。适用于表单、空状态、副标题、辅助文本、横幅、徽章或卡片。

ui-without-noise 是什么?

该技能专注于构建可用的界面,而非界面的旁白。它要求模型在生成或审查屏幕、表单、空状态、副标题、辅助文本、横幅、徽章或卡片时,默认仅提供控件、名称、相关对象和必要状态,仅当附加文案能改变用户的理解、决策、下一步操作或风险评估时才添加。技能支持所有 AI 编码助手(如 Claude Code、Cursor、Codex),通过 8 条生成规则和一条“交稿前审查”清单来指导行为。具体规则包括:不自动添加解释性装饰;让界面自身解释(优先改进标签而非加说明);不叙述实现细节;每个事实只在其有用处出现一次;删除冗余文案时连带移除空容器;保留安全操作所需信息;使必要信息可读;以及不小心缩小产品功能。审查清单要求对每条辅助文案做出“保留、重写、合并、删除、移动”的决策,并检查正常、空、错误、不可用和未知状态。该技能也提供了语言敏感的中文示例(如“工作区 · 在这里管理和组织你的工作区”改为“工作区”),强调遵循项目已有术语,不引入竞争性规范或外部依赖。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abworks-dev/ui-without-noise/tree/HEAD/skills/ui-without-noise

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

无噪音界面

构建一个人们可以使用的界面,而不是界面的旁白。 默认提供控件、其名称、相关对象和必要状态。仅在辅助文案能改变用户的理解、决策、下一步操作或风险评估时才添加。

生成时

  1. 不自动添加解释性装饰。 不要自动为每个区块添加副标题、介绍段落、帮助卡片、横幅、眉标、徽章或图标。只有在具体的用户需求时才添加,而不是为了填满空间或让页面看起来完成。
  2. 让界面自身去解释。 优先使用具体的标签、熟悉的动作动词、分组和位置。“创建工作区”不需要“点击下方创建工作区”。如果标签不够清晰,先改进标签,而不是添加段落。
  3. 不叙述实现细节。 架构、组件选择、通用的信任声明和开发者进度报告不是默认的产品文案。仅在技术事实影响隐私、范围、恢复或用户的下一个决策时保留它们。
  4. 每个事实只说一次。 标题、徽章、句子和横幅不应在同一范围内重复相同的事实。保留有目的性的重复,例如关联到字段的错误摘要,或紧邻重要操作旁的警告。不要跨对象、请求或工作区合并状态。
  5. 同时移除空容器。 当冗余文案被删除后,移除其不再有用的卡片、警告、图标、分隔线或预留空间。不要用装饰性徽章或一行图标替换段落。不要将不必要的文案隐藏在工具提示、展开、小号文字或低对比度中。
  6. 保留安全操作所需信息。 保留关联且通常可见的字段标签;实际的格式/长度/必填约束;可操作的错误;有意义的加载、未保存、不可用、权限和未知状态;以及危险操作的范围和后果。未知不是空、成功或失败。绝不暗示一个不可用的功能是可用的。
  7. 使必要信息可读。 重要状态和禁用操作原因必须在相关范围内可见,不仅限于屏幕阅读器或悬停。保留无障碍名称、描述、直播区域紧迫性、键盘访问和窄屏可读性。简洁永远不能超越无障碍。
  8. 不要无意中缩小产品功能。 保留功能、数据、操作、确认、授权和请求/重试行为。不要删除模糊的业务或安全需求:应将具体的歧义标记给负责人。

交稿前审查已更改的屏幕

在可能的情况下审查渲染后的屏幕,而不仅仅是孤立的字符串。 对于每条辅助字符串及其容器,选择以下一种结果:

  • 保留: 它增加了必要的事实、区别、约束、后果或下一步步骤。
  • 重写: 事实是需要的,但措辞模糊、重复或比必要更长。
  • 合并: 它在同一范围内重复了相同的事实;保留有用的位置和关联。
  • 删除: 界面已经传达了该信息,且没有丢失必要含义;移除空的包装器。
  • 移动: 只有真正低频的帮助才应放在显式、可访问的帮助入口后。不要将常见操作或重要状态隐藏起来。

在适用的正常、空、错误、不可用和未知状态下检查更改的范围。如果影响破坏性确认,还需检查键盘导航和窄视口。不要声称未运行过的浏览器或无障碍验证。 简要汇报重大更改,格式为 之前 → 之后 — 原因;包含一个有意保留的必要事实。不要在产品中编写新的解释性文章或发明评分系统来证明其简洁性。

示例

之前之后 / 决定
工作区 · 在这里管理和组织你的工作区工作区 — 删除重复的描述。
点击下方按钮创建一个新项目 / 创建项目创建项目 — 保留实际的操作。
项目名称 / 请在此输入你的项目名称项目名称 — 保留标签;移除明显的指令。
文件 / 仅支持 CSV,最大 20 MB保留两者 — 第二行是真实约束。
已保存 + 保存成功 + 你的更改已经保存如果需要,一个适当范围的确认;不要堆叠同义词。
保存结果未知。请先查询本次结果,不要重复保存。保留 — 不确定性和安全下一步很重要。
将永久删除「旅行计划」及其中 12 条笔记,无法恢复。保留对象、范围、计数和后果。

边界

此技能是模型指导,而不是代码检查工具、自动钩子或合规证明。遵循项目现有的术语、产品和安全契约。不要引入竞争性规范或安装依赖项、联系外部服务或更改全局配置以使用此技能。 示例对语言敏感:保持一致的术语;不要强制使用英文单词计数、文学同义词变化、通用字体计数或每行一个图标。

相关技能