pbakaus/impeccable

GitHub 2026-10-28T19:01:36.533168

项目简介

impeccable 是一套面向 coding agent 的「设计词汇表」（agent skills），它把原本模糊的审美判断转换成 Agent 可以直接调用的命令。它最突出的能力体现在三个方面：先用 polish（打磨）和 bolder(更激进) 这类动词引导 Agent 修改界面，让它知道该往哪个方向改；再用 critique（批评）和 audit（审计）进行反向评审，把生成与验收串起来；同时把 “AI slop”（一眼就能看出由模型生成的模板化视觉）当作明确的敌人，在产出上线前就拦下来。它解决的关键问题是：Agent 能写代码，但不知道什么算好看。

技术亮点

用动词定义设计意图：把“再好看一点”这种模糊反馈变成 polish、bolder 等语义明确的指令，减少反复修改 prompt 的来回次数，也让不同成员对同一条指令的理解保持一致。
正向修改与反向评审组成闭环：steer 与 review 是两套彼此独立的技能，前者负责改动，后者负责否定改动，避免模型“自己改、自己说好”的自我循环。
anti-slop 作为明确的目标：把紫色渐变、居中超大标题、千篇一律的卡片网格这类“AI 味”当作可识别的缺陷，而不是风格偏好来讨论。
轻量、不绑定特定宿主：以 Markdown 技能描述为主要载体，不绑定特定 IDE 或模型；更换 Agent 时，迁移成本主要是复制文件。
只做局部改进，不重做整个界面：强调在已有界面上做打磨，而不是让模型推翻重来，对已经有代码基础的项目更友好。

架构解析

从公开信息看，impeccable 属于“提示层框架”，而非运行时库。最外层是技能定义：一段可被 Agent 发现的命令描述和触发词汇，说明何时该调用、调用后应产出什么。中间层是设计准则与指令模板：涵盖排版层级、间距节奏、对比度、动效克制程度等判断标准，它把这部分原本存在于设计师头脑里的经验整理成可注入的规则。底层是执行策略——先诊断再修改、修改后自评、输出变更说明。安装时，通常只需把技能目录放进 Agent 的 skills/commands 目录；宿主在匹配到关键词时注入上下文。它不引入额外服务，也不接管渲染，价值全部来自“注入哪些约束”和“如何验收”。

适用场景

用 Claude Code / Cursor 快速生成 landing page 后，跑一轮 polish，修掉间距不一致、字号没有层级、按钮权重混乱的问题。
在合并前评审：新页面在进入主分支之前，用 audit 对照既有视觉规范做一次检查。
品牌焕新：用 bolder 把过度保守的界面推向更强的对比度与更大的字级，而不是让它继续停留在默认样式里。
设计系统真正生效：把团队规范写成技能，让不同成员的 Agent 产出趋于一致。
为没有设计师的项目提供保障：开源项目、文档站、GitHub Pages 这类缺少设计资源的界面。

生态对比

与 v0 / Lovable 这类生成式 UI 产品相比：它们从零生成整页，impeccable 则在既有代码上修改，并且可以插进任意 Agent 工作流。
与 shadcn/ui、Tailwind CSS 相比：后者提供实现层的组件与样式，impeccable 提供决策层的评判标准；两者互补，它并不替代后者。
与各类 awesome-prompts / 系统提示合集 相比：它把设计知识整理成有限的动词和一套验收流程，强调可重复的评审，避免一次性堆砌的长提示。

项目信息

仓库地址: https://github.com/pbakaus/impeccable
许可证: Apache-2.0
开发语言: Rust
Stars: 92,261 | Forks: 5,451 | 热度 100.0
主页: https://impeccable.style

查看原文