SuperAPI AI 工具集

antislop-human

前端与建站

查看项目

更新于 11-10 16:20

技能介绍

antislop-human 是 antislop 系统的一部分,属于面向 AI 编程代理的规则集合中的“人类技能”。它需要与核心文件 antislop.md 一起阅读:核心文件承载机制(目的测试、三个层级、交付门),而本技能深入人类一侧的细节,即 UI 中那些会排除不同视力、不同手部操作方式和不同设备设置用户的部分。

用途

当任务涉及构建或编辑 UI 时,应同时加载本技能与 antislop.md。它的目标是确保界面对于不同用户保持可用,关注对比度、键盘、焦点、状态以及移动端中会排除用户的细节。可访问性不是最后附加的额外清单,而是“UI 站得住脚”这一核心承诺的一部分。核心中的交付门仍然是门,本技能末尾的“人类技能清单”是与之并行运行的补充。

主要能力

本技能涵盖以下方面:

颜色与对比度:低对比度文本、文字覆盖在照片或渐变上、灰底灰字的幻觉、非文本对比度。要求满足 WCAG AA 最低标准:普通文本 4.5:1,大号文本(18px 以上)3:1;非文本 UI 组件边界和状态指示器需达到 3:1。

对比度检查器:提供三层工具,从最方便到最不方便依次为脚本、公式、参考表。脚本位于本技能文件夹中的 contrast-check.py,可用 python3(macOS/Linux)或 python(Windows)运行,接收两个十六进制颜色并输出比值和两种文本尺寸的判定。公式为 WCAG 2.x 对比度公式,参考表列出常见配对的比值和判定。

键盘:移除焦点轮廓、仅鼠标模式、损坏的 Tab 顺序。要求每个交互元素可通过键盘到达和操作,对话框可用 Escape 关闭,源顺序与视觉顺序一致。

焦点与状态:弱或不可见的焦点指示器、仅用颜色反馈、缺失的 UI 状态。要求焦点指示器可见且对比度达标,颜色信号需搭配文本、图标或图案,每个数据视图具备空、加载、错误三种状态。

缩放与移动端使用:无法缩放的文本、移动键盘遮挡表单。要求文本可缩放至 200% 不被裁剪,聚焦输入框时滚动到键盘上方。

交互提示:可点击但无指针光标、用 div 或 span 假装控件、仅图标无名称的控件、无悬停/激活/禁用状态、忽略用户设置的动效、无真实标签的表单字段、缺失页面级语义。要求启用控件显示 cursor: pointer,使用原生元素,提供可访问名称和可见标签,尊重 prefers-reduced-motion。

WCAG 2.2 深度:提供按需阅读的参考文件,包括 references/A11Y-PATTERNS.md(可复制标记)和 references/WCAG.md(按级别列出所有 WCAG 2.2 成功标准)。

使用方式

将本技能与 antislop.md 一起加载,用于构建或编辑 UI 的任务。每个条目采用相同结构:Tell(模式)、Why(排除了谁,以及为何读起来像未完成)、Fix(应做什么),并引用核心规则 R-XX。对于无法用肉眼验证的每种颜色配对,使用对比度检查器。脚本存在时优先运行脚本,若文件缺失,公式和表格本身是完整的,不要因脚本而阻塞。

适用场景

适用于任何涉及 UI 构建或编辑的任务,尤其是需要确保界面可被不同视力、不同操作方式和不同设备设置的用户使用的场景。包括但不限于:颜色与对比度检查、键盘可访问性、焦点管理、状态反馈、移动端缩放与键盘处理、交互提示和页面语义。

限制

本技能不涵盖移动端布局机制(断点、缩放、网格、溢出、点击目标),这些属于 antislop-layoutmobile 的关注范围。本技能只保留移动端中会排除用户的细节:缩放和屏幕键盘。页面级语义仅适用于生成整个文档的任务,不适用于单个组件。Lighthouse 分数本身永远不能证明符合性。