Cursor、Claude Code、Codex都能用Impeccable多平台安装实战【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccableImpeccable 是一款面向 AI 编程助手的设计技能包一套 Skill、23 个设计命令、59 条确定性检测规则帮你把 Cursor、Claude Code、Codex 里 AI 生成的前端页面从模板脸提升到产品级。本文是一份多平台安装实战指南全程 1 条命令起步5 分钟跑通。为什么需要 ImpeccableAI 写前端代码有个通病同一个模型训练在同样的 SaaS 模板上产出的页面长得几乎一样——Inter 字体包打天下、紫到蓝的渐变、卡片套卡片、标题上方必配圆角图标块。Impeccable 做的事情很直接23 个设计命令polish、audit、critique、distill、bolder、quieter、animate……和 AI 说同一种设计语言59 条确定性检测规则不依赖 LLM、不需要 API KeyCLI 和浏览器扩展都能直接跑️一条安装流程/impeccable init会生成PRODUCT.md并推荐DESIGN.md之后的每条命令都知道你的受众、品牌调性和设计约束设计钩子Design Hook在 Cursor、Claude Code、Codex 等平台上AI 每次编辑 UI 文件后自动触发检测把问题实时反馈给模型完整能力对照见官方文档docs/HARNESSES.md贡献者指南见 docs/DEVELOP.md。5 种安装方式速览按场景选一种方式适合谁复杂度一条命令① CLI 安装器绝大多数人推荐⭐ 最简单npx impeccable install② Git Submodule想让团队通过 Git 统一版本管理⭐⭐git submodule add ...③ 插件市场安装Claude Code / Grok Build 重度用户⭐ 最简单/plugin marketplace add④ 官网下载 ZIP不方便跑 Node 的环境⭐手动解压⑤ 手动拷贝排查问题 / 兜底方案⭐⭐⭐cp -r ... 新手直接选方式①其他方式都是它的补充。方式一CLI 安装器推荐——最快配置方法前提Node.js ≥ 22.18见 package.json。一键安装步骤在项目根目录执行npx impeccable install安装器会自动完成四件事探测已有的 harness 目录如~/.claude、~/.codex、~/.grok或项目本地的.cursor让你确认或自定义要安装的提供商Cursor、Claude Code、Codex、Gemini、Grok Build、GitHub Copilot 等询问安装范围当前项目project还是全局global安装设计钩子清单对 Claude Code、Cursor、Codex、GitHub Copilot、Grok Build 写入对应的 hook 配置文件脚本化安装跳过交互选项在 CI 或批量脚本中用参数直接指定提供商和范围npx impeccable install --providersclaude,codex,cursor,grok --scopeproject刷新已有安装只需npx impeccable update 不想装钩子加--no-hooks即可跳过不会留下任何配置。三大平台安装要点Cursor、Claude Code、Codex安装器是通用的但每个平台有两个容易踩坑的细节单独拎出来说。️ Cursor记得开两个开关Cursor 对 Skill 的支持需要手动开启进入Cursor Settings → Beta切换到Nightly 渠道进入Cursor Settings → Rules开启Agent Skills安装后 Skill 落在项目内.cursor/skills/impeccable/钩子配置在.cursor/hooks.json会在 AI 的写入落盘前拦截不符合设计规范的内容。如果钩子没生效保存文件会自动重载必要时重启 Cursor。 Claude Code项目级与全局级# 项目级推荐只对当前项目生效 cp -r dist/claude-code/.claude your-project/ # 全局级所有项目共用 cp -r dist/claude-code/.claude/* ~/.claude/Claude Code 的钩子写在.claude/settings.local.json本机专属、已被 gitignore编辑完成后自动运行检测并把发现反馈给模型。 Codex装完记得批准钩子这是三个平台里唯一必须手动操作一步的# 项目本地安装 cp -r dist/agents/.agents your-project/ mkdir -p your-project/.codex cp dist/codex/.codex/hooks.json your-project/.codex/hooks.json安装或更新后打开/hooks并批准项目钩子。Codex 按钩子定义做信任追踪每次更新只要.codex/hooks.json变化就可能再次要求批准。三个平台的钩子挂载点对照源码参考 docs/HARNESSES.md平台钩子清单文件检测时机Cursor.cursor/hooks.json写入落盘前拦截Claude Code.claude/settings.local.json编辑完成后反馈Codex.codex/hooks.json编辑完成后反馈方式二Git Submodule 安装——团队协作最优解团队想把 Impeccable 锁定在项目里、随仓库版本走用 submodulegit submodule add https://gitcode.com/GitHub_Trending/im/impeccable .impeccable npx impeccable link --source.impeccable --providersclaude,cursor git add .gitmodules .impeccable .claude .cursor git commit -m Add Impeccable skillsproviders可选值包括claude、cursor、gemini、codex、github、grok、opencode、pi、qoder、trae、rovo-dev、vibe。后续更新两步走git submodule update --remote .impeccable npx impeccable link --source.impeccable --providersclaude,cursor方式三插件市场安装Claude Code 专属捷径/plugin marketplace add pbakaus/impeccable添加市场后打开/plugin从列表里安装 Impeccable 即可。Grok Build 用户则用grok plugin install pbakaus/impeccable#plugin --trust装完怎么用3 条命令上手安装后重启你的 AI 工具然后在对话框里/impeccable init # 首次必跑采集设计上下文生成 PRODUCT.md 和 DESIGN.md /impeccable audit # 跑一轮技术质量检查可访问性、性能、响应式 /impeccable polish # 上线前最后一遍打磨大多数命令支持指定范围比如/impeccable audit the header、/impeccable polish the checkout form。高频命令还能用/impeccable pin audit创建独立快捷方式/audit。不经过 AI 也能用——独立 CLI 可直接扫描文件、目录甚至线上 URLnpx impeccable detect src/ # 扫描目录 npx impeccable detect https://example.com # 扫描线上页面 npx impeccable detect --json . # CI 友好的 JSON 输出规则目录和忽略配置管理入口在 docs/HARNESSES.md 与 package.json 描述的能力矩阵中都有覆盖。常见问题速查表安装排错清单问题解法装完 Skill 不出现重启 AI 工具Cursor 确认已切 Nightly 并开启 Agent SkillsCodex 钩子不生效打开/hooks批准项目钩子Windows 下 hooks 被禁用Grok Build 钩子不跑先用/hooks-trust或--trust信任项目目录钩子清单损坏导致安装中断重跑并加--force损坏文件会备份为.bak不想提交.impeccable/里的临时文件按 README 提供的工作块加入.gitignore保留config.json、design.json、critique/*.md等共享产物想升级统一用npx impeccable updatesubmodule 用户先update --remote再link小结一条命令全平台设计升级5 分钟npx impeccable install 重启工具 /impeccable init14 个平台Cursor、Claude Code、Codex、Gemini CLI、GitHub Copilot、Grok Build、OpenCode、Qoder、Trae 等全覆盖双保险23 个命令管怎么改59 条检测规则 设计钩子管改得对不对装好后跑一次/impeccable audit看看 AI 生成的页面里藏着多少模板脸——大概率会让你想立刻执行下一条polish。【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考