SuperAPI AI 工具集

audit

设计与创作

查看项目

更新于 10-15 15:45

技能介绍

用途

audit 是 ui-craft 技能下的一个子技能,用于对用户界面执行技术审计,聚焦无障碍(a11y)、性能和响应式三个方面。当用户要求对其 UI 进行审计,或提到“audit”时调用。

主要能力

该技能执行以下不可协商的检查:

无障碍(参考 references/accessibility.md):

  • 每个交互元素具有可见的 :focus-visible
  • 键盘可达,无焦点陷阱
  • 触摸目标 ≥ 44px(移动端)
  • 状态不能仅靠颜色传达
  • 表单标签、错误关联、必填指示
  • 所有动画遵循 prefers-reduced-motion

性能(参考 references/motion.md 的 Rendering Performance 部分):

  • 仅动画 transform / opacity(不涉及 width/top/height)
  • 不使用 transition: all
  • will-change 限定于活动交互,之后移除
  • 图片具有 width/height 或 aspect-ratio(防止 CLS)
  • 滚动/调整大小处理程序中无布局抖动

响应式(参考 references/responsive.md):

  • 移动优先断点,无固定宽度组件
  • 固定元素遵循 env(safe-area-inset-*)
  • 触摸区域不重叠
  • 320px 下无横向滚动

使用方式

  1. 视觉捕获(强制步骤):仅代码审查不足。每次审计/评审都从用户所见的界面开始。按顺序尝试:Playwright MCP(首选,捕获桌面 1280×800、平板 768×1024、移动 375×812 三种视口的全页截图,若支持则捕获深色模式);浏览器 DevTools / Chrome MCP(次选);其他浏览器自动化(agent-browser、cursor-ide-browser,第三选择);最后是请求用户提供截图。若无法自动化,需明确告知用户,不得静默回退到纯代码审查。若用户拒绝提供截图,则运行纯代码审查,并在报告顶部明确标注 [CODE-ONLY REVIEW — visual issues not assessed]。

  2. 执行审计:加载 ui-craft 技能并应用审计视角。注意 audit 与旋钮无关——无障碍和性能不可调。

  3. 输出格式:使用 SKILL.md 中的 Review Format 表格,包含 Before、After、Why 列。按优先级分组:Critical(阻碍可用性/无障碍)→ High-impact(立即明显)→ Quick wins(打磨)。

  4. 不重写代码:除非被要求,否则先报告发现,等待批准后再编辑。

  5. Craft Report:以 Craft Report 收尾(参考 references/review.md → Craft Report),包裹上述发现表格。Checked 说明范围(a11y/perf/responsive,在哪些视口),Passed 列出检查后认为良好的内容,Changed 在批准前保持为空,Verdict 指出最高优先级。即使审计干净也要产出——a11y/perf/responsive 干净本身就是发现。

  6. 下一步:/harden —— 将发现转化为真正的生产覆盖(第 1 级)。

适用场景

  • 用户要求对其 UI 进行审计
  • 用户提到“audit”
  • 需要对界面进行无障碍、性能或响应式方面的技术检查

限制

  • 视觉捕获为强制步骤,若无法自动化且用户不提供截图,只能进行纯代码审查,并明确标注视觉问题未评估
  • 不重写代码,除非用户要求
  • 无障碍和性能不可调,与旋钮无关
  • 需要 ui-craft 技能作为基础,若已安装 ui-craft,应先阅读其 SKILL.md 了解 Discovery + Anti-Slop + Craft Test,再应用本特定视角
  • 具体收费、价格、平台支持等信息暂未提供