Impeccable 评测:设计技能、规则检测与一次可复现检查

实测 Impeccable 4.8.0 的 HTML 检测流程,解释设计命令、项目上下文和 Live 模式的边界,并给出接入现有前端项目的选型建议。

AgentIndex · 发布于 2026-11-04 · 更新于 2026-11-04

Impeccable 值得考虑的场景,是你已经有一个能运行的界面,希望编程智能体围绕具体问题持续改进:价格卡片的层级不清楚、表单出错后不知道怎么恢复,或者移动端内容挤在一起。它把这些设计任务组织成具名命令,并提供规则检测器,让一部分问题能被重复检查。

我们的判断是:先在一个已有组件上试用,比直接让它重做整个产品更容易判断价值。采用前应明确三件事:哪些检查由固定规则完成,哪些修改仍由模型生成,以及团队如何保留有意选择的品牌样式。这些判断比 GitHub 星数更能帮助选型。

本文验证了什么

核验日期为 2026-11-04。我们阅读了项目 README、检测器、上下文文件、Hooks 和 Live 模式的官方说明,并实际运行了 npm 包 [email protected] 的帮助命令及两个本地 HTML 样本。检测过程没有调用生成模型,也没有向当前项目安装技能或 Hooks。

实际测试范围仅为检测器的单个受控样本。 我们没有测试模型生成的设计质量、真实用户完成任务的速度、浏览器插件或 Live 模式,也没有进行不同模型之间的对照实验。下面的选型建议由已核实的工作机制及这次检查推导,不是产品效果排名。

三种能力需要分别评估

能力提供什么你需要检查什么
设计技能用 critique、typeset、layout、polish 等命令组织任务模型是否遵循产品目标,改动是否解决具体问题
规则检测对源码或渲染页面报告可识别的模式规则是否适用于团队设计,是否存在误报或漏报
Live 模式在运行中的本地网页选择元素、比较变体并接受到源码实际框架适配、源码定位及接受后能否正常构建

具名命令的实际价值,在于把“再好看一点”变成有范围的任务。例如要求检查结账表单的错误恢复,比只要求整体“更高级”更容易验收。官方也建议先选定组件或区域;设计技能依然需要一个编程智能体来执行,检测器本身不会替你完成产品设计。命令与项目说明

检测器检查:4 条提示如何消失

我们准备了一个 HTML 文件:使用 Inter、紫蓝渐变、从 h1 跳到 h3,没有显式设置标题字号。随后以固定版本执行检测,避免把将来的行为混入今天的结果:

npm exec --yes --ignore-scripts [email protected] -- \
  impeccable detect --json before.html
样本实际退出码实际返回规则
修改前2overused-font、flat-type-hierarchy、skipped-heading、ai-color-palette
修改后0空数组 []

修改后样本改用系统字体和白底深色文字,将 h3 改为 h2,并显式设置 h1 为 32px、h2 为 24px。两个文件还包含其他人工调整,因此这不是逐个变量的消融实验。完整输入、结果和重跑方法保存在本站仓库的检查样本。

其中最值得留意的是字号提示:初始文件没有写标题字号,检测结果将标题与正文都报告为 16px。这个结果说明你需要检查检测器所看到的样式上下文,不能把它直接当成真实浏览器截图的结论。对于依赖外部 CSS、运行时样式或组件库的项目,应另外扫描运行中的页面。

官方说明中,退出码 2 表示发现问题,1 表示目标无法扫描。因此 CI 应区分“有待审阅项”和“扫描失败”。源码扫描和 URL 扫描的覆盖面也不同,颜色对比等依赖实际渲染的信息需要页面模式。检测器说明

把产品约束放在命令前面

如果产品服务的是值班人员,主要目标可能是迅速读出故障状态;如果是内容编辑器,长时间阅读和输入才是重点。同一个“更醒目”的命令,在这两类界面中应产生不同结果。

Impeccable 用 PRODUCT.md 保存产品背景,用 DESIGN.md 记录已有视觉系统。建议先检查这两个文件是否写清用户任务、约束和需要保留的规则,再让智能体改组件。品牌字体、已有间距规范和状态颜色应有明确依据,避免每次审查都重新争论。上下文文件说明

对于检测器提示的品牌字体,也不必为了清零而替换。记录团队有意保留的选择,再复核可读性和可用性,比把规则通过数当成设计评分更合理。零提示只表示此次检测没有命中已运行的规则。

建议的接入顺序

  1. 在一个可回滚的开发分支选定一个组件,记录它当前的任务完成障碍。
  2. 先独立运行检测器,确认输出格式和团队要保留的样式。
  3. 再按官方安装流程接入技能,并检查写入的项目上下文。
  4. 让智能体只修改一个区域,审阅差异并运行原有构建及交互检查。
  5. 确认手动流程有用后,再考虑自动检查或 Live 模式。

Hooks 是单独的接入步骤:技能安装完成,不等于宿主已允许自动执行。官方列出了不同宿主的信任和配置要求;接入后需要确认检查确实运行,而不只是配置文件存在。自动检查说明

Live 模式的接受操作会落到项目源码,官方当前将其标为 beta。我们建议用它比较局部方案时,仍保留对源文件差异的审阅和构建验证;本文没有实际验证该模式。Live 模式说明

哪些团队适合采用

已有产品界面、能描述用户任务、愿意逐次审查修改的团队,适合先做一个小范围试点。尤其当多个编程智能体反复引入相同的视觉模式时,固定规则能提供一致的讨论依据。

如果目标只是格式化代码,应先使用现有格式化工具;如果需要完整的无障碍验收,仍应保留键盘、读屏及真实页面检查;如果还没有确定产品服务谁,应先解决需求。我们的建议是用一次真实组件的改进结果决定是否扩大采用,而不要用这次样本的“4 变 0”推断所有页面都能变好。

相关选题:Cognee 长期记忆选型、Parlant 客服智能体选型。