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

第36章 Agent 缺失的设计词汇——自动设计检查

自动设计检查在 agent 工作过程中及时发现设计问题。本页共 5 个部分。大多数 agent 使用 /impeccable。在 Codex 中使用 $impeccable。Design hooks 会在 agent 处理 UI 文件时运行检测器,让 agent 有机会在改动还在上下文中时就修正问题。

开启检查 在你的 AI 编码工具中查看当前配置: /impeccable hooks status 开启或关闭本项目的检查: /impeccable hooks on /impeccable hooks off

在你的编码工具中允许 hooks

Claude Code

在交互式会话中接受工作区信任。打开 /hooks 查看 Impeccable 的 PostToolUse 和 Stop hooks。项目安装通常使用 .claude/settings.local.json;插件安装可以自带 hooks。 Claude Code 的 hook 与信任指南

Codex

在应用中打开 Settings → Hooks,或在 CLI 中使用 /hooks。审查并信任 Impeccable 的 PostToolUse 和 Stop hook 定义。新增或修改的定义需要重新审查。 Codex 的 hook 与信任指南

Cursor

信任工作区,然后在 Customize → Hooks 中查看项目的 .cursor/hooks.json。文件变更时 Cursor 会重新加载。如果仍未出现,重启 Cursor 并查看 Hooks 输出通道。 Cursor 的 hook 指南

GitHub Copilot

将 .github/hooks/impeccable.json 提交并合并到仓库默认分支。这是 Copilot CLI 和云端 agent 共用的项目 hook。在 CLI 中,还需接受文件夹的信任提示。 Copilot 的 hook 配置指南

Grok Build

运行 /hooks-trust 审查并信任 .grok/hooks/ 中的项目 hooks。用 /hooks 查看已加载的 hooks。 Grok Build 的 hook 指南

工作过程中的流程

01 Agent 修改 UI 代码。Hook 会检查对组件和样式的受支持编辑。 02 检测器发现问题。它会指出问题并给出修正方向。 03 Agent 可以响应。它可以修复问题,或说明这是有意为之的选择。

反馈的送达时机取决于你的编码工具。Cursor 会在写入落地前检查待提交的写入。

Claude Code 和 Codex:编辑后给出针对性反馈,并在 agent 完成回合时做一次更全面的检查。 Grok Build:编辑发生时即被追踪,检测结果在 agent 完成回合时送达。 GitHub Copilot:受支持的编辑之后立即运行完整检测器。 Cursor:完整检测器会检查受支持的待提交写入。发现问题可以阻止写入,让 agent 先行修改。

为什么有些检查要等到回合结束

对 Claude Code 和 Codex 来说,逐次编辑检查只关注即时问题:图片损坏、溢出、可读性差、渐变文字、发光效果,以及设计系统偏离。更全面的检查在 Stop 事件(即 agent 完成回复时)对本次会话触及的 UI 文件运行。之前已报告的问题会被过滤掉。

这样未完成的工作可以自然推进,不必在每次编辑后重复同样的提示。如果之后没有新问题,再次结束时也会保持安静。

把 hook.perEditRules 设为 "all" 可在每次编辑后运行完整规则集。Cursor 和 Copilot 本来就用完整规则集,因为 Impeccable 不会把它们的检测结果推迟到 Stop 阶段。Grok 虽然在编辑时就扫描,但反馈仍通过 Stop 送达。

Hooks 只检查 Web 代码。如果项目的 PRODUCT.md 声明为 ios、android 或 adaptive,它们会跳过该项目。原生界面审查请使用 audit。

确认检查正常运行 安装或迁移项目后,运行 doctor: /impeccable doctor 它能发现脚本路径已失效的 hook,或已安装配置与启用状态不一致的情况。没有消息可能意味着编辑干净、处于静默模式,或 hook 未激活;仅凭安静无法判断是哪种情况。

保留有意的选择 对于确认属意的例外,记录具体值及其理由: /impeccable hooks ignore-value overused-font Inter --reason "Brand font" 该例外对手动检测扫描同样生效。Configuration & ignores 介绍了更细的文件范围、私有例外,以及更宽泛的规则或文件排除方式。

安装与排错详情

支持的文件类型与跳过安装

内置文件类型包括 .tsx、.jsx、.html、.vue、.svelte、.astro、.css、.scss、.sass、.less、.ts 和 .js。纯 JS 和 TS 文件保持安静,除非发现设计问题。 通过 detector.extensions 可添加服务端模板类型。 如需在单次安装或更新时跳过 hook 配置: npx impeccable install --no-hooks npx impeccable update --no-hooks

静默模式、日志与环境变量覆盖

运行时选项位于 .impeccable/config.json 的 hook 下。本地覆盖(包括安装授权)位于被 gitignore 的 .impeccable/config.local.json。 hook.quiet: true 会屏蔽“干净”和“待确认”的提示,但保留新发现的问题。它不会关闭检查。 调试时,可将 hook.auditLog 设为路径,例如 .impeccable/hook.ndjson。每次调用会写入一行 JSON。日常工作中建议关闭日志。 IMPECCABLE_HOOK_DISABLED、IMPECCABLE_HOOK_QUIET 和 IMPECCABLE_HOOK_LOG 会为接收到这些环境变量的进程覆盖对应的配置项。Status 会报告相关的覆盖情况。

Hook 清单损坏会阻止安装

遇到格式错误的清单时,安装和更新会停止而不是直接覆盖。请先检查该文件。如果决定替换,使用 --force 重新运行;Impeccable 会先用 .bak 扩展名备份损坏文件,然后再替换。

评论 (0)