Repolode
提交项目
pbakaus

pbakaus/impeccable

面向 AI 编程助手的设计指导工具，提供设计技能、24 条命令和 61 条确定性检测规则，用于改进 AI 生成的前端界面。

在 GitHub 查看官网
Star
83,060
Fork
5,022
未关闭 Issue
48
最近提交
15小时前

这是什么？

Impeccable 是一套面向 Claude Code、Cursor、Codex CLI、Gemini CLI 等 AI 编程工具的设计技能与工具集。它通过 polish、audit、critique、distill、animate 等命令，让 AI 与开发者使用统一的设计词汇；初始化步骤会把产品受众、用途和约束等信息记录到 PRODUCT.md 中，供后续命令参考。

项目还提供独立的 CLI 和浏览器扩展，可对 HTML 文件、源码目录或线上 URL 运行 61 条确定性检测规则，无需 LLM 或 API Key。这些规则针对 AI 生成前端中常见的问题，如过度使用的字体、紫色渐变、卡片嵌套、弹跳缓动，以及小触控目标、跳级标题等通用设计缺陷。

在支持的工具中，可安装的 hook 会在直接编辑界面文件后运行检测，并把结果反馈给 AI 助手。实时模式允许在浏览器中针对本地开发服务器或静态 HTML 迭代调整页面元素。

核心功能

  • 01通过 /impeccable init 将产品上下文记录到 PRODUCT.md。
  • 02提供 24 条命令，涵盖设计评审、审计、打磨、排版、布局和动效等。
  • 0361 条确定性检测规则，可通过 CLI、浏览器扩展或 AI hook 运行。
  • 04实时浏览器模式，可针对本地开发服务器或静态 HTML 调整元素。
  • 05安装器支持 Cursor、Claude Code、Codex CLI、Gemini CLI 等多种 AI 编程工具。

适用场景

  • 提升 AI 编程助手生成的前端代码的视觉质量。
  • 在上线前检查现有网页的无障碍、响应式与布局问题。
  • 在 CI 中对 HTML 或 JSX 运行检测，发现常见的 AI 通用设计模式。
  • 在不修改源码的情况下，扫描线上页面的设计反模式。

快速上手

  1. 1

    在项目根目录安装该技能

    npx impeccable install
  2. 2

    在 AI 编码工具中运行一次性初始化命令

    /impeccable init

使用前须知

  • 使用 npx 安装程序需要 Node.js，但手动和 Git 安装方式无需 Node.js。
  • 部分工具需要额外步骤，例如在设计钩子运行前批准钩子或设置信任。

标签

#ai-agents#frontend#design#ui-ux#linter#claude-code#cursor#accessibility

常见问题

impeccable 是什么？
面向 AI 编程助手的设计指导工具，提供设计技能、24 条命令和 61 条确定性检测规则，用于改进 AI 生成的前端界面。 Impeccable 是一套面向 Claude Code、Cursor、Codex CLI、Gemini CLI 等 AI 编程工具的设计技能与工具集。它通过 polish、audit、critique、distill、animate 等命令，让 AI 与开发者使用统一的设计词汇；初始化步骤会把产品受众、用途和约束等信息记录到 PRODUCT.md 中，供后续命令参考。
impeccable 可以免费使用吗？用的什么许可证？
impeccable 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
impeccable 还在维护吗？
活跃维护中。impeccable 最近一次提交是在 2026年10月19日。
impeccable 适合用来做什么？
提升 AI 编程助手生成的前端代码的视觉质量。 在上线前检查现有网页的无障碍、响应式与布局问题。 在 CI 中对 HTML 或 JSX 运行检测，发现常见的 AI 通用设计模式。 在不修改源码的情况下，扫描线上页面的设计反模式。
impeccable 怎么安装和运行？
在项目根目录安装该技能: npx impeccable install 在 AI 编码工具中运行一次性初始化命令: /impeccable init
在哪里获取 impeccable？
源代码和安装说明在 GitHub 上：https://github.com/pbakaus/impeccable

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目