Superior UI Audit 用于对现有产品界面做只读审计:对照实际约束该界面的设计系统,验证 UI 问题,并准备后续修改。它主张优先给出少量证据充分的问题,而不是一长串风格偏好。
边界与限制:审计期间将产品源码视为只读,不安装依赖、不格式化文件、不修改生成产物;仅在用户要求,或只读工具确有必要以证明视觉结论时,才渲染或交互界面;功能缺陷、无障碍缺陷、性能问题和代码质量默认不纳入报告,除非用户将其列入范围。若用户要求修复 UI,该审计技能不会取代修复请求,而应使用实现工作流。
追踪界面:从范围内的路由、屏幕、组件族或用户旅程开始,沿布局、组合、组件、变体、Token 和解析后的样式追踪真实路径;相似名称和邻近文件只是候选,不能证明某个所有者影响该界面。记录界面、相关所有者、设计来源、显式例外以及可用时的当前修订。
重建本地契约:仅使用当前有约束力的证据,包括已接受的设计或品牌文档、已发布的 Token 与组件契约、被证明共享所有权的代表性界面、同一用户旅程内的直接矛盾,以及为本次审计提供或检查的渲染证据。草稿和提案描述未来意图,除非仓库将其标记为已接受;缺少文档本身不构成 UI 缺陷。
证明每条发现:一条发现需同时具备观察(所选界面上的确切界面后果)、契约(说明该属性应受什么约束的证据)、连接(证明所引用所有者到达受影响界面的证据)和修正(一项不臆造产品意图的确定修改)。若证据支持多种互不兼容的修法、差异属于有意例外,或所提修正主要改变业务行为,则应拒绝该候选。报告前应重新打开引用来源并主动寻找反证。
报告:最多返回五条发现,按用户影响、置信度、影响范围和修正成本排序,包含审计范围(界面、约束证据、运行时所有者、显式例外)、发现表格(观察问题、证据与连接、必要修正、影响范围、置信度)以及最高杠杆变更(一条发现或“No supported recommendation.”)。若没有通过证明测试的内容,应明确说明,不填充报告。
计划选定工作:当用户选择某条发现或明确请求计划时,读取 references/change-plan.md,为每个根因修正撰写一份自包含计划,使执行者无需审计对话即可理解所有权、范围、保留要求和验证方式。
适用范围:适用于已有产品界面的设计一致性审计与修改规划;具体支持的平台、技术栈和集成方式暂未提供。