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 评审和技术质量审计的前端工程师。
安装步骤
-
在项目根目录运行安装命令:
bash npx impeccable install -
重载你的编辑器/编程工具(如重启 Cursor 或重新加载插件)。
-
在你的 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 | |---|---| |  |  | 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 章节有说明。