登录 注册

impeccable (编程智能体设计词汇库)

曾爆款
去点 Star
AI 应用与 AI Agent
107,392
Stars
0
Forks
0
Watchers
0
Open Issues
未知
许可证
Rust
语言
创建时间
最近更新

项目能做什么

给编程 Agent 用的设计词库,通过指令引导和审查设计,在上线前揪出粗糙的 AI 产物。
来源:AI 基于仓库事实生成 · 内容以仓库实际 README 为准

使用说明 查看原始 README 原仓库文档

项目简介

Impeccable 是一个专为 AI 编程助手(Coding Agent)打造的设计指令与评审系统。

在 AI 辅助前端开发中,模型常常倾向于生成千篇一律的“AI 塑料感设计”(AI Slop,例如全站 Inter 字体、蓝紫渐变、套娃卡片、圆角图标加标题等)。Impeccable 提供了精准的设计控制词汇(如 polish、bolder)和评审工具(如 critique、audit),帮助开发者在代码交付前快速纠正模板化设计并拦截界面瑕疵。

支持主流编程智能体:Claude Code、Cursor、Codex CLI、GitHub Copilot、Devin、Replit Agent、Gemini CLI、Trae 等。


核心功能

  • 定向设计控制(Steer):提供明确意图的专属 Playbook,拒绝模糊要求。
  • bolder:强化平庸保守的设计,让风格更鲜明
  • quieter:收敛过于花哨的界面
  • distill:移除页面不必要的冗余元素
  • colorize / typeset / layout / animate / delight / overdrive:分别针对色彩、排版字体、间距节奏、动效、个性化及高级着色器/滚动效果进行调优
  • 设计评审与代码审计(Review):
  • critique:基于可用性启发式评估对设计进行评分,并排列待修复问题的优先级。
  • audit:针对无障碍(Accessibility)、性能、主题适配和响应式进行技术质量审查,问题划分为 P0(阻塞)到 P3(润色)级别。
  • 确定性设计瑕疵检测(Slop Detector):内置 62 条确定性规则,自动识别拥挤的内边距、混乱的标题层级等质量问题。无需调用 LLM,不消耗 API Key。
  • 交付与边缘覆盖(Finish):
  • polish:上线前的最后一轮视觉细节打磨
  • harden:补充错误状态、国际化(i18n)、内容溢出及边缘情况处理
  • clarify / adapt / optimize / onboard:用于改写文案、多端适配、性能优化及新手指引设计
  • 浏览器实时交互调节(Live Mode):
  • 运行 /impeccable live 会在开发服务器中开启浮层,支持直接点选元素并实时切换设计变体,确认满意后直接写回本地源码。支持 Vite、Next、SvelteKit、Astro、Nuxt 和纯 HTML。

适合谁用

  • 正在使用 Cursor、Claude Code、GitHub Copilot、Trae 等 AI 工具编写前端界面的开发者。
  • 厌倦了 AI 生成高度同质化、缺乏设计感页面的个人开发者与团队。
  • 希望对现有 UI 组件进行精细化迭代、UX 评审和技术质量审计的前端工程师。

安装步骤

  1. 在项目根目录运行安装命令: bash npx impeccable install

  2. 重载你的编辑器/编程工具(如重启 Cursor 或重新加载插件)。

  3. 在你的 Agent 对话框中执行初始化: bash /impeccable init 注:Codex CLI 用户请使用 $impeccable init。


配置说明

  • PRODUCT.md:运行 /impeccable init 时自动生成。它会扫描代码并向你确认产品受众、核心目标与开发约束,后续所有指令均会结合该上下文执行。
  • DESIGN.md:运行 /impeccable document 生成,用于提取并沉淀现有界面的视觉规范,防止后续修改脱离品牌风格。
  • 快捷指令固定:可使用 /impeccable pin <command>(例如 /impeccable pin audit)将高频指令映射为顶级快捷命令(如直接调用 /audit)。

常见问题

此部分原文未说明,请查看原仓库。

原始 README 摘录(英文原文,节选前 3000 字符)
# Impeccable

The design vocabulary for your coding agent. Steer with `polish` and `bolder`, review with `critique` and `audit`, and catch AI slop before it ships.

From your project root:

```bash
npx impeccable install
```

Reload your coding tool, then run `/impeccable init` in your agent (`$impeccable init` on Codex).

Works with 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, and Veto. Full docs live at [impeccable.style/docs](https://impeccable.style/docs).

| Without Impeccable | With Impeccable |
|---|---|
| ![Villa Castagneto built without Impeccable: cream background, a thin serif headline with an italic accent, two pill buttons, and flat vector illustrations in rounded cards](https://github.com/pbakaus/impeccable/raw/main/docs/images/readme-without.webp) | ![Villa Castagneto built with Impeccable: a full-bleed engraved night scene of the villa on its cliff above the sea, a condensed cream and vermilion headline, and a month strip along the bottom](https://github.com/pbakaus/impeccable/raw/main/docs/images/readme-with.webp) |

Same model (Fable 5.1), same brief: a fourteen-room family guesthouse on the Ligurian coast. Without Impeccable, it builds the tasteful default: cream page, thin serif, italic accent, pill buttons. With it, the page is built around one picture: the house at night, seen from the water.

For a full project, see the [Neo Mirai case study](https://impeccable.style/cases/neo-mirai): a conference site taken from mockup to shipped page.

## Why

Inter for everything. Purple-to-blue gradients. Cards nested in cards, gray text on colored backgrounds, a rounded-square icon tile above every heading. Ask an agent for a page with no other guidance and these show up again and again, across models and projects.

- **Words for what you want.** "Make it pop" leaves your agent to guess. `/impeccable bolder the pricing cards` loads a playbook written for that one move and points it at one target.
- **A reviewer.** `critique` scores the design against usability heuristics and ranks what to fix first. `audit` checks accessibility, performance, theming, and responsive behavior, with findings ranked P0 (blocking) to P3 (polish).
- **A slop detector.** 62 deterministic rules flag the tells above, plus quality problems like cramped padding and skipped headings. No LLM, no API key.

Impeccable is strongest on interfaces that already exist: point it at a page or a component and iterate. It builds new pages too; see [Build something new](https://impeccable.style/docs/new-work) for how to get the most out of that harder mode. To start, pick one component:

```
/impeccable critique the pricing cards
```

## How it works

Run `/impeccable init` once per project. It reads your code, asks only what it can't infer (who the product is for, what it needs to do, the constraints), and writes `PRODUCT
阅读完整原文

商业机会分析 AI 生成

CI/CD 自动化 UI Lint 与 AI Slop 防御服务 (SaaS)

产品构想将本地 deterministic rules 延伸到 GitHub Actions / GitLab CI 中,作为前端 PR 的阻断性质检工具,阻止不符合设计标准或充斥 AI 劣质样式的代码合并。
核心功能GitHub App 自动检测 PR 中的 UI 改动、62+条确定性 Slop 规则拦截、可自定义团队 Design Lint 规则、自动生成视觉评审建议。
目标用户工程主管、前端团队负责人、外包验收团队。
难度/周期中等 · 3 - 5 周 · 成本:低 (仅需标准 Web 服务与 GitHub Webhook 运行环境)
收费模式按代码库数量或席位订阅收费 (Freemium: 开源免费,私有仓库 $19-$49/月)。
竞争风险需证明其相对现有 ESLint/Stylelint 插件有不可替代的“AI 审美质检”独特价值。
依据 数据支持的判断

企业级 Design System 与 Agent 提示词资产托管平台

产品构想为企业团队提供私有化托管的 DESIGN.md、PRODUCT.md 与专用 Steer/Critique Playbooks,让多人开发时 Coding Agent 共享一致的品牌视觉语汇。
核心功能Figma Token 一键同步生成 Impeccable 规则、团队级私有 Playbook 市场、品牌一致性合规审计仪表盘、统一分发给所有 IDE 插件。
目标用户拥有自有组件库、设计系统(Design System)的中大型技术团队与设计系统工程师。
难度/周期中等 · 4 - 6 周 · 成本:中等 (前端展示后台、多租户管理服务)
收费模式企业 B2B 订阅 (按 Seat/月计费,如 $15/seat/月)。
竞争风险企业设计系统落地周期长,且企业级工具依赖销售和私有部署能力。
依据 AI推测

高级视觉风格预设包与垂直行业 Playbook 订阅市场

产品构想销售经过专业设计师精调的垂直场景 Playbook(如金融仪表盘、B2B SaaS 极简风、Web3 暗黑风、高转化 Landing Page 专项审查),供独立开发者一键导入。
核心功能开箱即用的行业顶级设计规则集、细分排版系统预设、高阶动效与无障碍合规强化包、一键更新 CLI 扩展。
目标用户独立开发者、出海建站营销人员、中小独立工作室。
难度/周期低 · 1 - 2 周 · 成本:极低 (内容资产开发为主)
收费模式按主题包单次买断 ($29 - $99/包) 或订阅通行证制。
竞争风险Prompt/规则类数字资产极易被破解或泄漏共享,盗版风险高。
依据 尚需验证的假设
AI 基于仓库公开数据分析生成,含推测成分,不构成收益承诺。
报告会保存到 个人中心

竞品与相似项目 GitHub Search 真实检索

项目中文简介Stars语言
arikchakma/maily.to 功能强大的邮件编辑器,助你轻松制作适配各大客户端的精美邮件。 3,996 TypeScript
h3nryprod01/design-taste 面向 Claude Code 的前端设计品味技能,涵盖排版、动效与组件规范。 93 HTML
pbakaus/impeccable-talks Impeccable 项目相关的演讲与技术分享资料。 53 HTML
peterhadorn/webdesign-agency-skills 基于 Impeccable 的 Claude Code 技能,用于网站审计与设计问题修复。 46 -
maxritter/open-claude-design 为编程 Agent 提供的 Claude Design 访问支持与 UI 设计工作流。 43 Python
cesswhite/hato-minimal-template 一款极简优雅的单页及 Landing Page 网页模板。 37 Vue
以上为通过 GitHub 官方 Search API 检索的相似项目,功能差异与优劣势需进一步人工确认,配置 AI 后可生成对比分析。

项目优势与风险

技术成熟度创建于 ,最近推送 ,发布过 100 个 Release
社区活跃Star 107,392 / Fork 0 / Issue 0(数据支持,可自行核实)
许可证未检测到(需人工确认)
主要风险上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价

安装与使用

快速开始(以仓库 README 为准)
git clone https://github.com/pbakaus/impeccable.git
cd impeccable
# 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)
阅读原仓库文档
术语说明:Docker=应用容器(把程序和依赖打包运行);API Key=调用外部服务的密钥;Git Clone=把仓库代码下载到本地。常见错误:API Key 未配置 / 端口占用 / 数据库连接失败,多数项目在 README 的 Troubleshooting 章节有说明。