Communitygithub.com

benjaminstelzer/scoville-ui-anti-ai-slop

框架感知的UI质量防护栏,用于抵御AI设计中的“糊弄”现象。

scoville-ui-anti-ai-slop 是什么?

该技能是一个严格但实用的UI质量防护栏,旨在防止AI代理在用户界面中引入“设计糊弄”(即次优、不一致或不可访问的模式)。它强制采用层次化的决策方法:系统与安全需求优先,其次是用户请求、仓库指令、产品规范、框架指南,最后才是该技能自身的通用原则。关键原则包括:不得将平行设计语言伪装成最佳实践,不得覆盖可访问性约束,不得发明专有字体或调色板。它维护着一个清晰的所有权模型,在其中UI负责布局、行为及框架对齐,而代码和Scribe(文案)则分别处理其特定领域的问题。该技能支持所有主流代理框架,并引用专门的参考文件来指导框架对齐与验证流程。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add benjaminstelzer/scoville-ui-anti-ai-slop

在你喜欢的 AI 中提问

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

文档

Scoville UI Anti-AI-Slop

改善产品的界面。将可用性、信息设计、适配性、可访问性和清晰度视为成果;不要安装一套伪装成最佳实践的次级设计语言。

如果用户明确排除此技能,请停止阅读参考文件、使用技能导向的工具、更改任何内容或提出基于技能的完成声明。优先级更高的项目或宿主指令可能仍会要求使用该技能;请报告该确切冲突。排除同级技能仅排除该技能本身,并不授权在此处复制其合约。

首先解决所有权问题

按此顺序解决每个关注点:

  1. 系统、安全及具有法律约束力的可访问性要求;
  2. 明确的用户请求,包括对已报告的限制(针对非约束性目标)的知情接受;
  3. 仓库指令;
  4. 规范的产品需求、设计系统组件、包装器、主题、语义令牌及批准的资产;
  5. 解决剩余问题的所属框架或平台;
  6. 与上述所有者一致的、经过深思熟虑的本地模式;以及
  7. 针对剩余差距的本技能通用UI原则。

不允许较低优先级来源覆盖较高优先级所有者。揭示实质性的冲突。重复的本地约定仅在其是经过深思熟虑、当前有效且适用于相同界面的情况下才被考虑。

当未指定可访问性目标时,Web UI使用WCAG 2.2 Level AA,其他平台使用所属平台的当前指南。使用受支持的组件和API。如果规范所有者无法满足最低要求,请报告确切限制,而不是用平行设计语言来掩盖它。

在遇到以下情况时,请先阅读framework-alignment.md再决定所有者:技术栈不熟悉、所有权不明确、多个UI层相互作用、似乎不存在规范的视觉所有者,或支持的定制路径不确定。

保持家族所有权的清晰区分

此技能独立工作。代码负责工程范围、代码所有权、完整性、风险和证明。UI负责框架对齐、层次结构、布局、交互呈现、响应式适配和渲染证据。Scribe负责含义、术语、本地化以及仅在可见或可访问的措辞可变时的保真度;固定的源精确字符串不会激活它。

UI负责文本布局、可读性、间距、缩放,以及所需标签或可访问名称是否存在且已关联。Scribe(如适用)负责其内容的含义。不要复制同级规则或重复其验证。

路由工作

  1. 仅在必要时审查请求的界面、仓库指令、框架版本、规范所有者及最接近的同类界面。
  2. 确定主要任务、优先级、受影响的状态、内容变化、输入及响应式转换。
  3. 重用规范组件、令牌、变体、布局、断点及交互。仅针对其所有者处已证明存在的差距添加基本元素。
  4. 为达成成果及必要状态做出最小的一致更改。
  5. 仅验证可能反驳结果的已渲染条件。在报告中分离渲染证据、源审查及未验证的行为。对于未实现的方向或仅基于源的审计,明确说明该方向或发现未经渲染,且渲染行为仍未验证;不要为了报告该边界而加载验证。

在做出关于任务流程、层次结构、布局、可读性、状态、可访问性结构或响应式行为的质量决策之前,请阅读ui-quality.md。对于仅需证据的问题,单独加载验证,除非接口本身也需要被评判。

在界面更改之后或声称渲染行为、响应式行为、观察到的交互、视觉质量或可访问性之前,请阅读validation.md。不要为仅限源的审计加载它,该审计将发现限定于审查的结构,并明确将渲染和交互行为留作未验证。构建或源审查无法证明渲染行为。

保护UI完整性底线

切勿通过以下方式改进外观:发明平行视觉语言、绕过语义令牌、重建可访问组件、移除焦点或输入适配、隐藏必需内容、使用单一视觉提示作为含义的唯一载体、忽略已更改状态的恢复,或通过全局主题覆盖应用本地异常。

不要强制使用偏好的字体、调色板、圆角、阴影、卡片模式、断点、像素值或时髦的禁令。量化规则来自可访问性标准、平台或设计系统——而非本技能。

当仅被要求审计或提供建议时,返回基于观察到的证据并按优先级排序的发现,而不要进行编辑。

相关技能