第5章 AI Agent 缺失的设计词汇表
从一个无可挑剔的构建开始
构建你心中所想的界面,或改进现有界面。大多数代理(Agent)使用 /impeccable。在 Codex 中,请使用 $impeccable。
安装方式:
$ npx impeccable install
如果你使用 GitHub Copilot 应用,Impeccable 已内置。请在设置 → 实验性功能中启用,然后配置你的项目。
安装选项与工具支持
选择你的代码工具,并为当前项目或所有项目进行安装。安装程序会根据你的工具自动选择对应的构建版本。
* impeccable * Claude Code(hooks + subagent) * Cursor(pre-edit hook) * Gemini CLI(针对模型的设计指引) * Codex CLI(针对模型的设计指引)
每个构建版本都包含该工具支持的文件位置和集成配置,以及针对其模型常见设计错误的指导。
› /plugin marketplace add pbakaus/impeccable
在 Claude Code 聊天中运行此命令。然后打开 /plugin,选择“发现”,并安装 Impeccable。
$ npx skills add pbakaus/impeccable
在终端中运行此命令以安装共享技能。使用推荐的安装程序可进行针对你代码工具的集成配置。
快速上手
› /impeccable init
在你的代理聊天中,将目标受众和愿景保存在 PRODUCT.md 中。后续可通过 npx impeccable update 更新。在 Claude Code 中可通过 /plugin 菜单更新。使用 npx skills update impeccable 更新 Impeccable。
安装选项与初步步骤 →
你在做什么?
在代理聊天中描述期望的成果。你无需知道特殊的命令。
打造新事物
从一个想法、新页面或重新设计开始。选择一个方向,然后将其转化为代码。
/impeccable 为我们的月度读书俱乐部设计一个注册页面
开始新设计 →
改进现有设计
描述感觉不对的地方,或请求一次聚焦的梳理。保留那些已经奏效的决定。
/impeccable 打磨价格页面
改进你的页面 →
想在构建前查看模型(Mockup)吗?
“先模型后编码”(comp-led)能开启更大胆的视觉方向,并包含几轮将图像转化为代码的过程。“直接编码”(code-led)往往能产生更连贯的首次构建,但视觉上的野心较小。
请启用你的代码工具或 OpenAI API 密钥以开启图像生成。对比工作流 →
持续设计
配合设计系统
记录共享规则,让下一个页面融入其中。→
生成变体
在聊天中指定元素和方向,然后在页面上对比。→
在浏览器中迭代
命名或选择一个元素,对比变体,并接受其中一个。→
通过视觉叠加层审阅
理解发现并决定修复什么。→
检查与故障排除
自动设计检查
在代理编辑时提供检测器反馈。→
运行检测器扫描
从终端检查文件或渲染后的页面。→
修复设置问题
查找过时的上下文和损坏的 hooks。→
参考
上下文文件
PRODUCT.md、DESIGN.md 和页面简报中应包含什么。→
配置与忽略
共享默认值、本地覆盖和检测器例外。→
命令参考
当你明确知道想要何种变更时,使用聚焦命令。
创建 (2) impeccable 描述你要制作或改进的内容。 shape 将想法转化为可基于其构建的设计简报。
评估 (2) audit 查找实现问题并确定修复优先级。 critique 找出阻碍设计发展的因素以及首先改进什么。
精化 (8) animate 使用动效使变更、关系和反馈清晰可见。 bolder 让现有部分更具存在感,同时忠于设计。 colorize 使用颜色澄清操作、状态和设计特质。 delight 让有意义的时刻变得惊喜、令人满足且极具个人特色。 layout 安排页面布局,让人们知道往哪里看以及什么元素属于一起。 overdrive 突破预期,让界面感觉非凡。 quieter 减少视觉噪音,同时保留设计个性。 typeset 让文本在整个产品中更易读、扫描和识别。
简化 (3) adapt 让现有设计在不同屏幕、设备或平台上运行。 clarify 帮助人们理解发生了什么以及下一步该做什么。 distill 减少杂乱,让重要内容更易发现。
强化 (4) harden 当数据、连接或操作出错时保持界面可用。 onboard 帮助新用户达到第一个有用的结果。 optimize 找出使界面变慢的原因,修复并衡量结果。 polish 让现有页面感觉完整且工作更佳。
系统 (5) document 记录你的视觉系统,以便后续工作遵循。 extract 将重复的 UI 模式转化为共享组件和样式。 generate 指定元素名称,对比变体,保留你喜欢的。 init 为 Impeccable 提供设计你项目所需的上下文。 live 指向你的页面,探索变体,保留你喜欢的。