Impeccable：给编码 Agent 的设计词汇

项目简介

Impeccable 是给编码 Agent 准备的一套设计词汇。你用 polish、bolder 这类命令引导 Agent 调整界面，用 critique、audit 做审查，并在代码交付前用内置的检测器发现 AI 生成页面常见的「slop」痕迹。README 中的对比示例显示：同一个模型、同一份需求，加了 Impeccable 后页面会围绕一张夜景图重新组织，而不是落回米色背景加细衬线的默认样式。

它支持 Claude Code、Cursor、Codex CLI、GitHub Copilot、Devin、Replit Agent、Gemini CLI、Grok Build、OpenCode、Google Antigravity、Kiro、Trae、Rovo Dev、Qoder、Mistral Vibe、Pi、Hermes Agent、DeepSeek Harness、Veto 等编码工具。

主要功能

• 引导改动（Steer）：bolder 放大保守设计、quieter 收敛喧闹页面、distill 精简冗余内容、colorize 给灰色界面加色彩、typeset 修字体与层级、layout 调间距与节奏、animate 补过渡反馈、delight 增加个性、overdrive 做着色器与滚动驱动效果。
• 审查（Review）：critique 按可用性启发式给设计打分并排优先级；audit 检查可访问性、性能、主题和响应式，发现按 P0–P3 分级。
• 收尾（Finish）：polish 做发布前最后一遍；harden 处理错误、i18n、溢出等边界；还有 clarify、adapt、optimize、onboard。
• 浏览器内迭代：live 打开开发服务器并叠加浮层，选中元素后就地热替换变体，接受后写回源码，支持 Vite、Next、SvelteKit、Astro、Nuxt 和纯 HTML；generate 可直接生成指定元素的变体。
• 上下文文件：init 读取代码并写出 PRODUCT.md，document 记录现有视觉体系到 DESIGN.md，后续命令都会读取它们。
• Slop 检测器：62 条确定性规则，无需 LLM、无需 API key，可标出滥用字体、渐变、嵌套卡片、对比度不足、内边距过挤、跳级标题等问题。

安装与使用

在项目根目录执行：

npx impeccable install

安装器会识别你使用的编码工具，询问装到当前项目还是全局，并在支持时提供设计 hook（建议接受）。重载工具后，在 Agent 中运行 /impeccable init（Codex 中为 $impeccable init）。

之后用一个命令加一个目标即可，例如：

/impeccable critique the onboarding flow
/impeccable polish settings

检测器也可以脱离 Agent 直接跑：

npx impeccable detect src/
npx impeccable detect https://example.com
npx impeccable detect --json .
npx impeccable detect --github src/
npx impeccable detect --list-rules

另外提供 Chrome 扩展，可把检测结果叠加到任意在线页面上。

注意事项

• 检测器退出码 2 表示有发现，1 表示某个目标无法扫描。
• 源码文件（如 JSX、TSX）只跑模式规则；对比度、字号过小等规则需要渲染页面，因此还需指向本地开发服务器，如 npx impeccable detect http://localhost:5173。
• live 模式只应编辑本地检出，不要注入已部署的网站，也不要为它放宽生产环境的 CSP。应用文案修改会调用 package.json 中的可选脚本 impeccable:manual-edit-validate，在不熟悉的仓库里使用前请先检查。
• 个别工具需要额外放行 hook：Codex 中打开 /hooks 批准，Grok Build 运行 /hooks-trust，Hermes Agent 需执行 hermes plugins enable impeccable-design-hook。
• Node 仅用于 npx，技能本身依赖随包分发的独立引擎二进制，或首次下载到 ~/.impeccable/bin/。
• Impeccable 在已有界面上迭代效果最好，新建页面属于更难的模式。

---

本作品整理自 GitHub 开源项目 pbakaus/impeccable，原作者 @pbakaus，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。