进阶 impeccable.style 2026-11-22 15:26:07 · 2 阅读

第13章 为 Agent 补齐缺失的设计词汇表:用 audit 修复实现问题

修复实现问题并确定修复优先级

本页包含 3 个部分

大多数 Agent 使用 /impeccable。在 Codex 中,使用 $impeccable。

使用 audit 检查界面在实际使用中是否可靠:用户能否通过键盘导航、在暗色模式下阅读,以及在手机上完成操作?Impeccable 会检查实现细节并按严重程度排序生成报告。它不会修改代码。

试一试

/impeccable audit the checkout flow

指定页面、组件或流程。在发布前、重大变更后,或怀疑存在质量问题时运行。

工作原理

对于 Web 项目,报告涵盖五个领域:

* 无障碍:标签、对比度、语义和键盘访问。 * 性能:加载、渲染、动画和不必要的资源消耗。 * 主题:一致的 token 和对项目主题的支持。 * 响应式行为:布局、触控目标以及不同屏幕尺寸下的可用性。 * 实现完整性:重复出现的不一致性和经过验证的反模式问题。

每个发现项都会解释问题发生的位置、对页面使用者的影响以及修复方法。例如:

P1 · 支付按钮没有可见的键盘焦点 按 Tab 键到达按钮时,没有任何视觉反馈表明它已被选中。请添加可见的焦点状态,并在全流程支付过程中进行检查。

*这是一个示例发现项,而非实际审计的输出结果。*

优先修复最严重的问题

| 优先级 | 含义 | 修复时机 | | :--- | :--- | :--- | | P0 · 阻断 | 某人无法完成任务 | 立即 | | P1 · 重大 | 显著困难或无障碍失败 | 发布前 | | P2 · 轻微 | 存在可行替代方案的问题 | 下次改进迭代 | | P3 · 打磨 | 对使用影响较小的细微问题 | 处理更高优先级问题之后 |

请 Impeccable 处理这些发现项,或按照其建议的命令操作。Harden 用于处理缺失的状态和边缘情况,optimize 用于解决性能问题,polish 用于优化现有体验。重新运行 audit 以检查修复效果。

评分机制

每个 Web 领域的得分为 0 到 4 分,总分 20 分。总分概括了评估结果;具体的发现项则告诉你需要关注什么。即使总分很高,仍可能包含阻断性问题。

审计 iOS 或 Android 应用

当项目上下文识别为原生应用时,audit 会使用平台特定的检查,包括屏幕阅读器、文本缩放、触控目标和平台惯例。Web 检测器不会在原生界面上运行。

如需获得关于设计清晰度、层级或个性的反馈,请使用 critique。

评论 (0)