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

第40章 Agent 缺失的设计词汇表

通过可视化叠加进行审查发现问题所在,定位发生位置,然后选择改进方向。本页共 7 个小节大多数 agent 使用 /impeccable。在 Codex 中使用 $impeccable。一个页面可以通过所有自动化检查,却仍然让人困惑。Critique 能帮你解释原因。可视化叠加提供了一种在页面上定位已检测出问题的方式,比如难以阅读的文本。

本指南以结账页面为例:支付按钮比总价更抢眼,而运费文本又太淡。你将阅读审查结果、选择修复方案并验证效果。

开始之前

在你的编码工具中安装 Impeccable。如有需要,请参阅 getting started。 选择一个页面和一个任务。提供其源码路径或 agent 可以打开的 URL。说明用户需要完成什么,以及哪些部分尚未完成。 若要使用叠加功能,请安装 Chrome 扩展,或使用支持该功能的浏览器工具的 agent。即使没有叠加,审查仍然可以解释各项发现。

1. 请求一次 critique 在 agent 对话中运行:

/impeccable critique the checkout page. Customers need to check the full total before paying. Impeccable 结合两类证据:

设计审查:页面如何引导用户完成任务、哪些地方显得平庸或不一致、哪些内容值得强调。 自动化检查:在源码或渲染页面中发现已知问题模式,并给出位置和解释。

综合报告会告诉你值得保留的优点、优先问题、可用性评分,以及可能影响工作的问题。它还会说明哪些检查已运行、哪些不可用。Critique 不会改动设计。

为什么 critique 使用相互独立的评估? 设计审查独立于检测器运行,这样检测结果就不会影响初始判断。当编码工具支持多个独立 agent 时,Impeccable 会使用它们,并在需要时请求授权。如果是在单一共享上下文中运行,报告会指出这一局限。 各评估结果事后汇总。结论一致可以强化发现,但检测器的警告仍然需要结合你的页面来判断是否合理。

2. 阅读优先问题 先看影响主任务的问题。以这个结账页面为例,可能会读到两条发现:

设计审查:支付按钮出现在总价之前。应在要求付款前展示完整金额,并把金额写进按钮文案。 检测器:运费文本对比度过低。应让费用清晰可读,避免被忽略。

修改前订单摘要立即支付咖啡 · 2 包$40.00运费$8.00总计$48.00建议修改后订单摘要咖啡 · 2 包$40.00运费$8.00总计$48.00支付 $48.00结账页面与审查发现的示意图,数值为虚构。修改后费用清晰可读,完整总价出现在支付操作之前。这些是建议的修改,不是真实的审查记录,也不是可用的结账流程。 检测器能发现对比度问题;而识别出页面过早要求付款,则需要审查任务流程和阅读顺序。两条发现互为补充,缺一不可。

3. 在页面上定位检测到的问题 安装 Chrome 扩展后,打开你的页面,点击 Impeccable 扩展图标,选择 Scan page。如果发现结果被隐藏,可使用 Show overlays。轮廓和标签会把检测到的问题模式与页面元素关联起来。 如果你的 agent 能在 critique 过程中生成叠加层,报告中会说明其位置。即使 agent 能检查页面,浏览器限制也可能阻止生成。如果未能生成,请依据报告中的源码位置和文字发现继续工作。

在一个故意有缺陷的页面上试用叠加 这个现有 demo 在一个刻意夸张的落地页上运行浏览器检测器。其中的示例文案和宣传语均为虚构。标签是真实的检测器输出,但不构成完整的设计审查。

全屏打开 demo 以便更充分地检查。

4. 提出你想要的修改 先回答可能影响方案的问题,再向 agent 提出聚焦的请求。以图示的结账页面为例:

把总价显示在支付按钮上方,并把金额写进按钮文案。让运费清晰可读。商品、价格和支付行为保持不变。 你可以用日常语言描述修改方案。想对比不同布局时使用 Live Mode;想进行更全面的打磨时使用 polish。

5. 检查结果 刷新页面并再次选择 Scan page。确认特定的检测器问题已解决。然后隐藏叠加层,实际执行一次任务:每项费用是否可读?能否确认总价?支付控件是否可用?同时检查窄屏和键盘操作。 如果你大幅调整了流程或布局,请对同一目标重新运行 critique。关注任务完成度是否更好、决策是否更清晰。发现数量减少或评分提高只是辅助证据,不是最终目标。

我应该如何使用评分和保存的审查结果? 可用性检查按 0 到 4 分评分。不适用的检查标记为 n/a,总分相应调整。请结合理由阅读评分;不要把最大分不同的总分当作相同标准来比较。 Impeccable 会把 critique 报告保存在 .impeccable/critique/ 下,并可展示同一目标的趋势。如果保存失败,报告应当说明。模拟用户视角可以提示值得调查的方向,但不能替代真实用户测试。

如果结果令人困惑

没有检测器发现,但页面仍感觉不对劲:参考 critique 的设计分析。任务顺序、产品契合度和品牌气质无法完全靠模式检测捕捉。 某个警告看似是有意为之:检查其影响并记录决策理由。Configuration & covers 章节介绍了狭窄的检测器例外情况;隐藏叠加层只会改变你的所见。 叠加层没有出现:查看扩展的扫描提示或 agent 的运行记录。浏览器限制或注入失败都可能阻止生成。你仍然可以依据源码位置和文字审查继续工作。

audit 用于调查实现质量,包括无障碍、性能和边界情况。critique 命令指南涵盖审查本身的用法。

评论 (0)