进阶 impeccable.style 2026-11-22 15:26:08 · 2 阅读

第38章 Impeccable 安装与入门指南

安装与入门

安装 Impeccable,然后构建或改进一个页面。

本页共 5 个部分

大多数 agent 使用 /impeccable。在 Codex 中使用 $impeccable。

你需要一个编程工具、一个项目文件夹,以及 Node.js 18.19 或更高版本。空项目或刚脚手架生成的应用都可以。

我可以使用哪些编程工具?

Impeccable 支持 Claude Code、Codex、Cursor、GitHub Copilot、Gemini CLI、Grok Build、Antigravity、OpenCode、Pi、Hermes Agent、Devin、Replit Agent、Kiro 等编程工具。安装程序会让你选择工具并安装对应的构建版本。

使用 GitHub Copilot 桌面应用?Impeccable 已内置。在 Settings → Experimental 中启用即可,然后直接跳到第 2 步,无需使用终端安装程序。

其他安装方式请参见主页上的安装选项。

1. 安装 Impeccable

在终端中打开项目文件夹并运行:

npx impeccable install

按提示选择编程工具,并选择为当前项目还是所有项目安装。然后重新加载你的编程工具。

其他安装方式请参见主页上的安装选项。

用 Git submodule 共享团队版本

在项目文件夹中,把 Impeccable 添加为 submodule 并关联团队使用的编程工具:

git submodule add https://github.com/pbakaus/impeccable vendor/impeccable npx impeccable link --source=vendor/impeccable --providers=claude,cursor

把 claude,cursor 替换成团队实际使用的工具。如果想使用已有的本地代码目录,可以把 --source 指向该文件夹。关联方式使用本地源码,无需全局安装 Impeccable。已有的 skill 目录会保持不变,除非你用 --force 显式替换。

提交 .gitmodules、submodule 引用以及生成的链接文件。团队成员通过以下命令获取记录的版本:

git submodule update --init --recursive

要升级到更新的版本,先更新 submodule,刷新链接,然后检查并提交新引用:

git submodule update --remote vendor/impeccable npx impeccable link --source=vendor/impeccable --providers=claude,cursor

安装或更新后请重新加载编程工具。关联方式只安装 skills,不安装设计钩子(design hooks);请按照自动检查的设置流程和工具的信任要求单独配置。

后续命令都在 agent 对话框中输入。可以在任意命令框中选择你的编程工具,示例会采用对应的语法。

命令没出现,或者已启用自动检查?

如果重新加载后 Impeccable 没有出现,请重新运行安装程序,并检查编程工具和安装范围的选择。

如果启用了自动设计钩子,需要在编程工具中允许它运行。它会检查 UI 改动,并把发现的问题反馈给你的 agent。

2. 让 Impeccable 了解你的项目背景

Impeccable 需要知道你的项目服务哪些人,以及这些人需要完成什么。用以下命令保存这些背景信息:

/impeccable init

Impeccable 会先读取项目,然后请你补充缺失的信息。描述目标用户是谁,以及他们的需求应该影响哪些设计决策。例如:

我们的客户每周都会补购同样的耗材。他们需要快速找到常用商品并完成结账,而且经常是在手机上操作。

还要写明工作中必须保留的内容,比如已确定的产品名称或无障碍要求。颜色和字体可以留到设计阶段再定。

Impeccable 会把确认后的背景信息保存在 PRODUCT.md 中。继续之前请先阅读,纠正它理解有误的地方;后续命令都会依据这个文件来指导工作。

选择新设计的起始方式

先出设计稿(comp-led)可以在视觉方向上走得更远,但把图片转成代码会丢失细节,需要多轮提示和评审。直接编码(code-led)通常能产出更连贯的初始实现,但视觉上更保守。两种路径都包含设计方向和评审环节。

init 可能会询问哪种路径作为默认值,之后也可以在设计选择器中切换。详见工作流与默认值对比。

已有设计系统?在开发之前先记录下来

/impeccable document

Impeccable 会读取界面,把颜色、排版和组件规则记录到 DESIGN.md 中。请审阅该文件,确保后续工作延续你希望保留的设计决策。没有样式的脚手架项目可以跳过这一步。

具体工作流参见"与设计系统协作"。

3. 选择第一个任务

用日常语言描述即可。根据项目情况选择路径:

构建新东西:创建页面或重新设计界面。

改进现有设计:在保留优点的前提下打磨页面。

构建新东西

描述页面、目标受众,以及访客应该能完成什么:

/impeccable design a signup page for our monthly book club. Help visitors understand the next event and reserve a seat.

Impeccable 会帮你补全缺失的细节,产出可选、可调整的设计方向,然后构建并评审界面。在"设计稿优先"工作流中,需要你在实现前确认设计方案。成熟产品内的新页面会沿用该产品的视觉体系。

方向选择器、设计稿、重新设计以及会话间延续的内容,参见"构建新东西"。如果想在实现前先停在方案阶段,可以使用 shape。

改进现有设计

描述哪里感觉不对,或指定一个页面做集中打磨:

/impeccable polish the pricing page

polish 会在现有设计内优化间距、排版、文案标签和交互状态。可以在请求中加上约束条件,比如"保持我们的配色和现有的套餐名称"。

不确定哪里需要改进?先运行 /impeccable critique the pricing page,查看分析结果,再决定处理哪些问题。示例参见"改进现有设计"。

4. 评审结果

打开页面,实际走一遍主要任务流程。能否成功预订座位?能否对比套餐并做出选择?同时在窄屏下检查一下,并审阅代码改动。

告诉 agent 哪些要保留、哪些要调整。例如:

套餐对比现在更易读了,保留。但把月付/年付切换器恢复到它上方。

如果整体设计仍感觉不对,描述你想改的地方,或要求重新设计。polish 是用来打磨现有设计的。

接下来可以尝试

保持后续页面的一致性:使用"与设计系统协作"记录共享决策,复用已有组件。

对比视觉方案:在对话中通过指定元素和方向来生成变体,或在 Live Mode 中选择,然后在页面上对比并将选中的版本合入代码。

上线前检查:/impeccable audit the pricing page 会审查无障碍、性能、响应式等实现问题。

更新用 npx impeccable install 安装的版本,在终端运行 npx impeccable update。通过 Marketplace 安装的版本,则在编程工具的插件菜单中更新。

评论 (0)