用途
audit 是一个代码层面的技术质量审计技能,属于 pbakaus/impeccable 技能集。它对实现进行系统性技术质量检查,并生成一份带评分的综合报告。它的定位是记录问题,而不是修复问题——修复工作留给其他命令处理。它是代码级审计,而非设计评论,只检查实现中可测量、可验证的内容。
使用前提(强制)
必须先调用 /impeccable,其中包含设计原则、反模式以及 Context Gathering Protocol。使用前必须遵循该协议——如果尚不存在设计上下文,必须先运行 /impeccable teach。
主要能力:五个诊断维度
审计会在五个维度上执行检查,每个维度按 0-4 分打分。
1. 可访问性(A11y):检查对比度问题(文本对比度低于 4.5:1,或 AAA 要求低于 7:1)、缺失 ARIA(交互元素缺少正确的 role、label 或 state)、键盘导航(缺少焦点指示、Tab 顺序不合理、键盘陷阱)、语义 HTML(标题层级不当、缺少 landmark、用 div 代替 button)、alt 文本(缺失或质量差)、表单问题(输入无 label、错误提示差、缺少必填标识)。评分:0=不可访问(未通过 WCAG A),1=重大缺口,2=部分实现,3=良好(基本满足 WCAG AA),4=优秀(完全满足 WCAG AA,接近 AAA)。
2. 性能:检查布局抖动(在循环中读写布局属性)、昂贵动画(动画化 width、height、top、left 而非 transform/opacity)、缺少优化(图片无懒加载、资源未优化、缺少 will-change)、打包体积(不必要导入、未使用依赖)、渲染性能(不必要的重复渲染、缺少 memoization)。评分:0=严重问题,1=重大问题,2=部分优化,3=良好,4=优秀。
3. 主题(Theming):检查硬编码颜色(未使用设计 token)、损坏的深色模式(缺少深色变体、深色下对比度差)、token 不一致(用错 token、混用 token 类型)、主题切换问题(切换主题时不更新的值)。评分:0=无主题化,1=极少 token,2=部分实现,3=良好,4=优秀(完整 token 系统,深色模式完美)。
4. 响应式设计:检查固定宽度(在移动端破坏布局的硬编码宽度)、触控目标(交互元素小于 44x44px)、横向滚动(窄视口下内容溢出)、文本缩放(文字变大时布局破坏)、缺少断点(无移动/平板变体)。评分:0=仅桌面,1=重大问题,2=部分实现,3=良好,4=优秀(流式、适配所有视口、触控目标正确)。
5. 反模式(关键):对照 impeccable 技能中所有 DON'T 准则检查。查找 AI 生成痕迹(AI 配色、渐变文字、玻璃拟态、hero metrics、卡片网格、通用字体)以及通用设计反模式(彩色上的灰色、嵌套卡片、bounce 缓动、冗余文案)。评分:0=AI slop 图集(5+ 痕迹),1=强烈 AI 美学(3-4 痕迹),2=有一些痕迹(1-2 明显),3=基本干净(仅细微问题),4=无 AI 痕迹(有辨识度、有意图的设计)。
报告结构
生成的报告包含:审计健康分表(五维度评分 + 总分 ??/20 + 评级区间,18-20 优秀、14-17 良好、10-13 可接受、6-9 较差、0-5 严重);反模式判定(先从这里开始,通过/失败:看起来是否像 AI 生成?列出具体痕迹);执行摘要(总分、按 P0/P1/P2/P3 统计的问题数、Top 3-5 关键问题、建议下一步);按严重级别分类的详细发现(P0 阻塞=阻止任务完成,立即修复;P1 重大=明显困难或 WCAG AA 违规,发布前修复;P2 次要=烦扰,存在变通,下次修复;P3 打磨=可修可不修),每个问题记录名称、位置、类别、影响、违反的标准、修复建议和建议命令;系统性与模式问题;正面发现;按优先级排序的建议动作。
建议命令
推荐的命令只能从以下列表中选择:/animate、/quieter、/shape、/optimize、/adapt、/clarify、/layout、/distill、/delight、/audit、/harden、/polish、/bolder、/typeset、/critique、/colorize、/overdrive。需将发现映射到最合适的命令,如果推荐了任何修复,以 /polish 作为最后一步。
使用方式
执行后按上述流程运行检查并生成报告。向用户展示摘要后,应告知:可以要求一次运行一个、全部一起运行,或以任意顺序运行;修复后重新运行 /audit 可看到评分提升。
约束与限制
要求彻底但可操作,避免过多 P3 问题造成噪音,聚焦真正重要的内容。禁止:报告问题而不解释影响、提供泛泛建议、跳过正面发现、忘记排优先级(不能一切都是 P0)、报告未经核实的误报。该技能只做审计记录,不执行修复。具体安装命令、官方文档与平台支持信息暂未提供。