项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 114444
技术标签
使用教程
环境要求
- 使用 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
上一篇:live-panel-skill
同类项目推荐
shaders
开源
一行组件接入 WebGPU 炫酷着色器效果
WebGPU components for React, Vue, Svelte, Solid, JS & Framer
impeccable
开源
让 AI 写界面自带设计师审美,少返工
The design vocabulary for your coding agent. Steer with polish and bolder, review wi···
SDesign
开源
复制一段话就换整套审美,64 套风格随便挑
去 AI 味设计系统库 · 6 美学家族 × 64 套设计系统 · 复制一段提示词粘给任意 AI 就出片···
open-design
开源
让 AI 代工做界面,本地跑完随手改
The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create···
presenta-lib
开源
用代码批量生成演示文稿和图片,自动化视觉内容生产
The javascript presentation library for the automation era.
designpull
开源
看到喜欢的网站,一键扒下它的设计配方
Generate Google Stitch compatible DESIGN.md files from any website using AI vision. ···
better-design
开源
组件库现成摆好,AI 做界面直接抄作业
Open-source design MCP server + shadcn/ui registry — AI design systems for Claude C···
hue
开源
装一次,AI 写的每个界面都长成你的品牌样
open-source skill that learns any brand and turns it into a complete design system. ···
claude-directory
开源
复制即用的 AI 生成界面组件,快速搭出炫酷落地页
AI-assisted design experiments with documented asset provenance, scoped licensing, a···