用途
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 下无横向滚动
使用方式
-
视觉捕获(强制步骤):仅代码审查不足。每次审计/评审都从用户所见的界面开始。按顺序尝试:Playwright MCP(首选,捕获桌面 1280×800、平板 768×1024、移动 375×812 三种视口的全页截图,若支持则捕获深色模式);浏览器 DevTools / Chrome MCP(次选);其他浏览器自动化(agent-browser、cursor-ide-browser,第三选择);最后是请求用户提供截图。若无法自动化,需明确告知用户,不得静默回退到纯代码审查。若用户拒绝提供截图,则运行纯代码审查,并在报告顶部明确标注 [CODE-ONLY REVIEW — visual issues not assessed]。
-
执行审计:加载 ui-craft 技能并应用审计视角。注意 audit 与旋钮无关——无障碍和性能不可调。
-
输出格式:使用 SKILL.md 中的 Review Format 表格,包含 Before、After、Why 列。按优先级分组:Critical(阻碍可用性/无障碍)→ High-impact(立即明显)→ Quick wins(打磨)。
-
不重写代码:除非被要求,否则先报告发现,等待批准后再编辑。
-
Craft Report:以 Craft Report 收尾(参考 references/review.md → Craft Report),包裹上述发现表格。Checked 说明范围(a11y/perf/responsive,在哪些视口),Passed 列出检查后认为良好的内容,Changed 在批准前保持为空,Verdict 指出最高优先级。即使审计干净也要产出——a11y/perf/responsive 干净本身就是发现。
-
下一步:/harden —— 将发现转化为真正的生产覆盖(第 1 级)。
适用场景
- 用户要求对其 UI 进行审计
- 用户提到“audit”
- 需要对界面进行无障碍、性能或响应式方面的技术检查
限制
- 视觉捕获为强制步骤,若无法自动化且用户不提供截图,只能进行纯代码审查,并明确标注视觉问题未评估
- 不重写代码,除非用户要求
- 无障碍和性能不可调,与旋钮无关
- 需要 ui-craft 技能作为基础,若已安装 ui-craft,应先阅读其 SKILL.md 了解 Discovery + Anti-Slop + Craft Test,再应用本特定视角
- 具体收费、价格、平台支持等信息暂未提供