impeccable

让 AI 写界面自带设计师审美，少返工

impeccable 是一套面向 AI 编码助手的设计语言与技能包，核心目标是让 Claude Code、Cursor 等 AI 工具在生成界面时具备专业设计师的审美与判断力。它通过提供一套可被 AI 读取的设计规范、提示词和组件模式，解决 AI 生成前端代码时常见的配色混乱、间距随意、层级不清、交互粗糙等问题。项目以 JavaScript 实现，可集成到现有 AI 工作流中，让 AI 在写页面时自动遵循统一的视觉规则，产出更接近真实产品级的 UI。它不替代设计工具，而是把设计决策前置到 AI 生成阶段，减少反复返工。

开源 unknown 设计创意

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 78167

维护状态活跃

是否开源是

定价模式 unknown

项目预览

项目数据

分类设计创意

开发团队pbakaus

所属国家

官网地址https://impeccable.style

GitHubhttps://github.com/pbakaus/impeccable

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言JavaScript

技术栈/模型

GitHub 星标★ 78167

30天Star增速

HF 下载量

上线时间2025-11-16 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-08

浏览次数0

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

使用 npx impeccable 安装器时需安装 Node.js；技能本身不需要运行时
一个受支持的 AI 编码工具：Claude Code、Cursor、Codex、Gemini CLI、Grok Build、Hermes Agent、Veto、
首次运行需联网，引擎二进制会下载到 ~/.impeccable/bin/
VS Code 扩展方式要求 VS Code 1.109.3+、Copilot Chat 权限与受信任的本地工作区

安装与启动步骤

1安装技能包

在项目根目录执行，安装器会列出检测到的 harness 目录或已装 CLI，并让你选择提供方与安装范围。
```
npx impeccable install
```
2非交互指定参数

脚本化安装时用这两个参数跳过交互选择，providers 可填多个并用逗号分隔。
```
npx impeccable install --providers=claude,codex,cursor,grok,hermes,veto --scope=project
```
3初始化项目

在 AI 编码工具里运行，把受众、目的、约束、语调等产品事实写入 PRODUCT.md，供后续命令引用。
```
/impeccable init
```
4信任 Hook

仅 Codex 与 Grok Build 需要：Codex 打开 /hooks 批准项目 hook；Grok 先做项目目录信任再运行脚本。
```
/hooks
```
5运行设计命令

安装完成后重新加载工具，用 audit、polish、distill、critique 等命令做设计审查与清理，可附带区域参数。
```
/impeccable audit blog
```
6插件方式安装

不想用 CLI 时可走插件：Claude Code 添加市场、VS Code 装扩展、Grok Build 装轻量插件包。
```
code --install-extension renaissance-geek.impeccable
```
7更新技能

已有安装可用 update 刷新；更新改动 hooks.json 后 Codex 可能需重新批准 hook。
```
npx impeccable update
```

关键配置

配置项	必填	说明	示例
`--providers`	否	指定安装到哪些 AI 工具，多个用逗号分隔	`claude,codex,cursor,grok,hermes,veto`
`--scope`	否	选择装到当前项目还是全局	`project`
`PRODUCT.md`	是	由 /impeccable init 生成的项目事实文件	`PRODUCT.md`

如何确认成功

重新加载 AI 工具后输入 /impeccable，能显示完整命令列表即安装成功；Codex 可用 /skills 或 $impeccable 检查。

常见问题

Q：需要 API Key 吗？

A：不需要。59 条确定性检测规则由 CLI 和浏览器扩展直接运行，不调用 LLM 也不需要 API Key；只有部分 critique 检查走 LLM。

Q：安装后命令不出现怎么办？

A：先重启 AI 工具。Codex 使用 skills 而非 /prompts 命令，可打开 /skills 或输入 $impeccable；仓库级安装在 .agents/skills/。

Q：必须装 Node.js 吗？

A：不必须。技能自带启动器（scripts/impeccable，Windows 为 impeccable.cmd），只有 npx 安装器需要 Node。

Q：可以在多个工具里同时安装吗？

A：可以，用 --providers 一次列出多个工具。注意别在同一工作区重复安装 Impeccable 技能，VS Code 扩展为 skill-only。

Q：Codex 更新后为什么又要批准？

A：Codex 按 hook 定义追踪信任，更新若改动 .codex/hooks.json，就需要重新批准一次项目 hook。

注意事项

首次运行会下载自包含引擎二进制到 ~/.impeccable/bin/，请保证网络可用。
Grok Build 用户需先做项目文件夹信任（/hooks-trust 或启动时加 --trust）。
Veto 接收 ~/.veto/skills/ 下的打包技能，不运行原生编辑 hook。
手动安装可复制 dist/agents/.agents/skills/* 到 ~/.agents/skills/，Copilot 则复制 dist/github/.github 到项目。

核心亮点

提供可直接被 AI 读取的设计规范与提示词，集成成本低
针对 AI 生成 UI 的常见毛病（配色、间距、层级）给出具体约束
以技能包形式组织，便于按项目替换或扩展设计语言

不足之处

依赖具体 AI 工具的提示词机制，换工具时效果可能打折扣
设计语言偏通用，深度定制品牌视觉仍需额外工作

适用场景

用 Claude Code 或 Cursor 快速生成落地页与后台界面
团队统一 AI 生成前端代码的视觉规范
个人开发者没有设计师时提升 AI 产出 UI 的完成度

替代项目

shadcn/ui、Tailwind CSS

项目介绍

impeccable 是设计创意领域的开源项目，由 pbakaus 开发，2025 年首次发布。

在全站 13,916 个收录项目中，它的 GitHub 星标数（78,167）位列前 1%，在设计创意分类的 192 个项目里位列前 3%。

项目目前处于活跃维护状态，最近一次代码更新于 2026-10-07。

它主要面向的使用场景是：用ClaudeCode或Cursor快速生成落地页与后台界面。同类可对比的替代方案包括 shadcn/ui、Tailwind CSS。

上一篇：live-panel-skill

下一篇：ui-ux-pro-max-skill