Impeccable

Impeccable 是面向 AI Agent 的前端 UI 设计与界面优化工具，可接入 Claude Code、Cursor、Codex 等编程工具。官网提供安装入口、命令文档和可视化案例，帮助你按具体问题选择界面评审、排版调整、布局简化或交付前打磨等任务。对于已有页面，希望把“哪里不对”说清楚并继续修改的人，这里也是查阅官方工作流的入口。

先找到对应的资料

第一次访问，可以先看官方文档中的安装与起步说明，再按当前页面的问题找命令。官网把规划、评审、细化、简化和交付检查分组说明，可以按任务决定从评审还是修改开始。

• 命令与使用文档：https://impeccable.style/docs/，查看各命令处理的任务及使用条件。
• 原型落地案例：https://impeccable.style/cases/neo-mirai/，观察虚构会议的页面原型怎样转为带导航、轮播与响应式布局的实际网页。
• 源码与版本：https://github.com/pbakaus/impeccable，核对支持的工具、更新记录和开源许可证。

官方 Neo Mirai 案例同时展示原型、品牌工具包和实际页面。它适合用来理解视觉参考如何参与实现，以及浏览器检查怎样发现遮挡、裁图和交互状态问题；案例展示的是官方制作流程，不代表任何项目安装后都能自动得到同样效果。

按界面问题选任务

Impeccable 把设计意见拆成较明确的入口。已有页面可以先评审，再根据发现的问题选择局部修改：

接入现有项目

采用官方推荐的安装器时，在前端项目根目录运行：

npx impeccable install

选择所用的 AI 工具以及项目级或全局范围，重新加载工具后，通过 /impeccable init 初始化项目上下文。Codex 使用 /skills 或 $impeccable 入口；启用自动检查 Hook 时，还需按宿主提示完成授权。

项目通过 PRODUCT.md 记录受众、用途和约束，通过 DESIGN.md 记录视觉系统。这样，排版与配色调整可以参照同一组产品事实和设计约定，局部打磨也有明确范围。

更完整的安装步骤、命令选择和使用边界，可参阅Impeccable 安装与前端设计审查介绍，并结合官方文档核对当前参数。

模型用量与编辑范围

设计与打磨命令依托所选 AI 工具运行，相应模型用量按该工具计算。项目另有不需要 LLM API Key 的独立检测器，可检查源码或已渲染页面。规则检测结果仍需结合实际页面判断，不能用“没有告警”代替对界面体验的检查。

Live 模式用于本地源码与开发环境中的视觉迭代，线上网站可做检测，但不能直接作为可写回的 Live 编辑环境。

项目采用 Apache 2.0 许可证。官网与主要文档为英文；本文基于官方资料和案例整理，未在本机安装或复现完整设计流程。