dalao.ai

Impeccable

给 AI 编码智能体补上设计语汇的开源技能与命令行工具：24 个设计命令加 62 条确定性检测规则，Apache-2.0 许可开源

关于 Impeccable

Impeccable 是一套面向 AI 编码智能体的开源设计技能与命令行工具：一个技能提供 24 个设计命令，配合浏览器内的实时迭代模式和 62 条确定性检测规则，用来减少 AI 生成前端界面中的常见套路。README 的支持工具列表包括 Claude Code、Codex CLI、Cursor、GitHub Copilot 和 Gemini CLI 等。许可证为 Apache-2.0，公开的技能、命令、命令行工具和检测引擎免费。截至 2026-10-26，最新发布为 engine-v0.1.17，GitHub 发布时间 2026-10-24 07:26 (UTC+8)。

编辑部更新于 阅读约 6 分钟

它解决什么问题

官网首页标题为 The missing design vocabulary for agents.，副标题写把 AI 套路化的界面改成可以上线的界面。GitHub 描述称它是一套让 AI 编码工具更擅长设计的设计语言。

问题与做法。README 写各家模型在相同的 SaaS 模板上训练，缺少设计指引时会反复出现同一批特征，例如处处 Inter 字体、紫到蓝的渐变、卡片套卡片、彩色背景上的灰字。Impeccable 把设计知识写成智能体可调用的技能，用 /impeccable init 在项目里写入 PRODUCT.md 记录产品背景，用 /impeccable document 生成 DESIGN.md 记录现有视觉体系，再由各个命令按这些背景信息做设计和修改。

来源。README 写 Anthropic 的 frontend-design 是第一个被广泛使用的 Claude 设计技能，Impeccable 从它起步。

发展历程。仓库 2025-11-16 09:52 (UTC+8) 创建。作者博客 2026-07-02 宣布成立 Renaissance Geek 作为 Impeccable 背后的公司，由 a16z 投资、Anish Acharya 领投，同时宣布与 GitHub 合作。

近期发布按技能、命令行工具和检测引擎三条线分开：engine-v0.1.17 于 2026-10-24 07:26 (UTC+8)，skill-v4.7.0 于 2026-10-20 01:52 (UTC+8)，cli-v4.7.0 于 2026-10-20 01:53 (UTC+8)。

出品方：Renaissance Geek, Inc.。公司首页团队栏列出 Paul Bakaus（Founder & CEO）与 Fabian Hannemann（Co-founder & COO）。

The missing design vocabulary for agents.

Impeccable 官网首页标题

核心能力

24 个命令。文档把命令分为六组：创建、评估、精修、简化、加固和体系，例如 shape 先产出设计简报，audit 检查可访问性、性能和响应式，critique 评估层级与清晰度，polish 做上线前的收尾，typeset、layout、colorize、animate 分别处理字体、布局、配色和动效。

检测器。README 写 62 条确定性检测规则覆盖 AI 套路特征和通用设计质量，例如侧边色条边框、紫色渐变、弹跳缓动、行长、触控目标过小和标题层级跳跃。命令行工具和浏览器扩展运行这些规则时不需要大模型或 API key；npx impeccable detect 可扫描目录、HTML 文件或网址，支持 JSON 输出和 GitHub Actions 注释，并用退出码区分有无问题。

设计钩子。安装器可在 Claude Code、Cursor、Codex、GitHub Copilot 和 Grok Build 中写入钩子，智能体改动界面文件后自动运行检测，把结果交回智能体。

实时模式。live 与 generate 命令在运行中的开发服务器页面上生成某个元素的多个变体，接受后写回源码；FAQ 写两者适用于 Web 项目。

谁在用

截至 2026-10-26，GitHub API 显示 87,578 个星标、5,234 个 Fork；GitHub 接口的 open_issues_count（含未关闭的 issue 与 PR）为 39。

集成。公司页写 GitHub 是第一个合作方，Impeccable 内置于 GitHub Copilot 应用，在 Settings → Experimental 中开启（均为官方自述）。README 另列 Visual Studio Marketplace 上的 VS Code 扩展、Claude Code 插件市场和 Grok Build 插件等安装渠道。

发布。2026-10-02 至 2026-10-24 间，GitHub Releases 上的技能从 4.4.0 更新到 4.7.0，检测引擎从 0.1.10 更新到 0.1.17。

和同类比

和 Anthropic frontend-design 比：README 写 Impeccable 从 frontend-design 起步。frontend-design 是单个 SKILL.md，描述为对新界面或改版界面给出有辨识度的视觉设计指引；Impeccable 在技能之外加了 PRODUCT.md 与 DESIGN.md 两类项目背景信息、24 个命令、实时模式和不依赖大模型的检测器。

和 UI UX Pro Max skill 比：该项目为 MIT 许可，GitHub 描述为 An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.；Impeccable 为 Apache-2.0，并附带可在 CI 中运行、以退出码报告结果的检测命令行工具。

适合与不适合

适合：

  • 用 AI 编码工具做前端、希望界面少一些模板痕迹的开发者、设计师和产品经理。
  • 已有设计体系、需要新页面沿用现有颜色、组件和规则的团队。
  • 需要在 CI 或 PR 流程中自动检查界面问题的团队，检测器支持 JSON 输出和 GitHub Actions 注释。

不适合：

  • 非 Web 界面为主的项目：FAQ 写 live 与 generate 适用于 Web 项目。
  • 不接受任何对外请求的环境：设计方向功能需要请求官网 API，版本检查默认每天最多一次。
  • 编码工具不允许钩子的环境：自动检测依赖各工具的钩子授权。

上手路径

安装。官网与 FAQ 给出的方式是在项目根目录运行 npx impeccable install，按提示勾选编码工具和安装范围，完成后重新加载编码工具；该安装器需要 Node.js 18.19 或更高版本，package.json 的 engines 字段同为 >=18.19.0。README 另列 Git 子模块、插件安装、官网下载 ZIP 和从仓库复制四种方式。GitHub Copilot 应用内置 Impeccable，在 Settings → Experimental 中开启。

初始化。在智能体对话中运行 /impeccable init 写入 PRODUCT.md，再运行 /impeccable hooks on 开启自动检测。Codex 需在 /hooks 中批准项目钩子，Grok Build 需信任项目文件夹。

更新。npx impeccable update 替换已装文件，不改动 PRODUCT.md 与 DESIGN.md。

关闭上报。运行 npx impeccable telemetry off，或设置环境变量 IMPECCABLE_NO_TELEMETRY=1 或 DO_NOT_TRACK=1；版本检查用 IMPECCABLE_NO_UPDATE_CHECK=1 关闭。

定价与许可证

软件：免费。FAQ 写 Impeccable 公开的技能、命令、命令行工具和检测引擎以 Apache 2.0 许可免费开源。

费用：编码工具或模型提供方的用量费用另计，包括图片生成；用 OPENAI_API_KEY 调用 Impeccable 自带的图片生成时由该 key 计费。公司页列出面向 PR 的自动设计检查产品，标注 In closed beta；隐私政策提到 Impeccable Pro 候补名单。

许可证：LICENSE 为 Apache License 2.0 条款，末尾版权行为 Copyright 2025 Paul Bakaus；仓库根目录的 NOTICE.md 列出第三方来源：ios.md 与 android.md 两个平台参考文件取自 ehmo 的 platform-design-skills（MIT）。GitHub API 与 package.json 均标为 Apache-2.0。

风险与局限

对外请求与记录。隐私政策写项目检测在本机运行，不上传项目文件或检测结果。设计方向功能会向 impeccable.style/api/roll 请求候选方向，并可上报所选卡片类型和位置；记录不含 IP、项目内容或用户与设备 ID，保存在 Cloudflare 的服务中，没有固定删除日期，也无法按单个用户查找或删除。

官网统计。隐私政策写官网首页使用 Google Analytics，所有页面使用 PostHog，记录页面浏览、复制的命令和安装方式等；浏览器发出 Do Not Track 或 Global Privacy Control 信号时，官网的收集方式不变。

钩子与本地脚本。README 写 Claude Code 中已加入的命令钩子独立于模型工具审批运行，首次编辑可能下载并缓存检测引擎；实时模式应用文案修改时会在 shell 中运行 package.json 里可选的 impeccable:manual-edit-validate 脚本，权限与当前用户相同。

分发渠道版本。issue #1023 为用户报告，写 ChatGPT 插件仍显示 v4.3.1，当时技能已到 v4.5.2；截至 2026-10-26 该 issue 仍为未关闭状态。

检测范围。README 写检测器运行无问题只是证据，不代表视觉或可访问性质量达标。

官方材料中的不同说法：

  • 命令清单：README 写 24 commands，其命令表含 craft、不含 impeccable；文档 Command reference 分六组列出 24 项（2、2、8、3、4、5），含 impeccable、不含 craft。

我们的判断

Impeccable 的特点是：用 PRODUCT.md、DESIGN.md 两类项目背景信息文件和 24 个命令约束 AI 编码工具生成的前端界面，62 条检测规则不依赖大模型运行，可接入 CI；许可证为 Apache-2.0，安装器支持 Claude Code、Cursor、Codex、GitHub Copilot 和 Grok Build 等工具。

它的限制：设计方向功能会请求官网 API，上报可以关闭；Claude Code 中的命令钩子独立于模型工具审批运行；实时模式会在 shell 中运行项目里的校验脚本；FAQ 写 live 与 generate 适用于 Web 项目。

资料来源

官方

  1. Impeccable: The missing design vocabulary for agentsimpeccable.style · 访问于 2026 年 10 月 26 日
  2. FAQ | Impeccableimpeccable.style · 访问于 2026 年 10 月 26 日
  3. Privacy Policy - Impeccableimpeccable.style · 访问于 2026 年 10 月 26 日
  4. Docs | Impeccableimpeccable.style · 访问于 2026 年 10 月 26 日
  5. Impeccable READMEGitHub · 访问于 2026 年 10 月 26 日
  6. Impeccable LICENSE (Apache-2.0)GitHub · 访问于 2026 年 10 月 26 日
  7. Impeccable package.jsonGitHub · 访问于 2026 年 10 月 26 日
  8. Third-Party Notices (NOTICE.md)GitHub · 访问于 2026 年 10 月 26 日

动态与深度阅读

版本更新GitHub 版本发布 · Impeccable skill v4.8.0：支持 Devin，检测结果可标注到 PR

Impeccable skill v4.8.0 可通过 npx impeccable install 安装到 Devin 的网页版、CLI 和桌面版，含 .replit 文件的项目会被识别为 Replit Agent。在 GitHub Actions 中运行 impeccable detect --github，会把每条检测结果标注到对应代码行。 偏移 4px 及以上的硬阴影会作为提示而非失败报告。启动器、npm 包和 install 会把下载的引擎与技能附带的摘要列表比对，不匹配就拒绝运行。