用途
impeccable 是一个设计方向的智能体技能,用于支持从设计构思到最终交付的完整界面设计工作。它把每个设计任务当作由获奖级设计总监来完成:要求产出达到生产级代码质量、具备明确的观点、理解客户与用户需求,并追求出色工艺。
主要能力
根据资料,该技能通过一组子命令(Commands)组织能力,分为若干类别:
- 构建类:shape(写代码前规划 UX/UI)、init(在 PRODUCT.md 中记录持久产品上下文)、document(从现有项目代码生成 DESIGN.md)、extract(抽取可复用的 token 与组件进入设计系统)。craft 是普通 new-work 请求的已废弃别名。
- 评估类:critique(启发式评分的 UX 设计评审)、audit(无障碍、性能、响应式等技术质量检查,原生平台有独立参考)。
- 精修类:polish(交付前的最终质量检查)、bolder(放大安全或平淡的设计)、quieter(收敛过于强烈或刺激的设计)、distill(去除复杂性,提炼本质)、harden(面向生产:错误、i18n、边界情况)、onboard(首次运行流程、空状态、激活)。
- 增强类:animate(有目的性的动画与动效)、colorize(为单色界面添加策略性色彩)、typeset(改进字体层级与字体)、layout(修正间距、节奏与视觉层级)、delight(增加个性与记忆点)、overdrive(突破常规限制)。
- 修复类:clarify(改进 UX 文案、标签与错误信息)、adapt(适配不同设备与屏幕尺寸,原生平台有独立参考)、optimize(诊断并修复 UI 性能)。
- 迭代类:live(视觉变体模式:在浏览器中选择元素并生成替代方案)。
使用方式
- 每个会话运行一次
node <skill-base-dir>/scripts/context.mjs,其中<skill-base-dir>是运行时报告的该技能已加载基础目录,并保持 cwd 位于用户项目。该基础目录解析本技能及其引用中的每个node .agents/skills/impeccable/scripts/...命令;仅当运行时不报告基础目录时,才以.agents/skills/impeccable/scripts作为回退。可通过--target <path>传入具名源文件或路由。 - 路由规则:无参数时读取 routing.md 并展示上下文感知菜单,绝不自动运行命令;显式或明显隐含某命令时加载对应参考并遵循;否则视为通用设计工作。
- 编辑 UI 前需先加载
reference/craft-floor.md(仅在纯规划工作时不必加载)。 - Pin / Unpin:
node .agents/skills/impeccable/scripts/pin.mjs <pin|unpin> <command>创建或移除独立的$<command>快捷方式。 - Hooks:
$impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset>管理本项目的设计检测钩子(在 UI 文件编辑后自动运行检测器并呈现发现)。 - Doctor:
$impeccable doctor报告并修复本项目 Impeccable 产物(PRODUCT.md、DESIGN.md 及其 sidecar、配置、surface brief、钩子)与当前版本读取内容之间的漂移。
设计模式
按目标界面而非产品类型选择模式:
- Persuade:访客做出决定并行动,设计即产品(落地页、营销、活动、定价)。
- Operate:访客完成任务(应用 UI、仪表盘、编辑器、后台、设置、工具)。
- Read:访客理解内容(文档、文章、指南、帮助、更新日志)。
- Experience:访客置身作品之中(作品集、画廊、展示)。 模式仅持久化在对应的 surface brief 中。
核心原则
- 全力以赴,不设对冲、不走捷径,交付物必须完整(用户需提供的素材除外)。
- 大胆而宏大,追求独特、美丽、出色且极具启发性。
- 以有界轮次验证,而非循环:完整构建后用一次批量轮次检查(Web 同时覆盖桌面与移动;原生平台覆盖已发布设备类别),一批修复全部问题,最多再确认一轮后停止打磨。开放式自我 QA 会浪费用户成本。
- brief 优先:即便与饱和模式警告冲突,也尊重指定的美学、年代、材质、字体与配色;把清晰 brief 引向自身品味属于失败。
- 精修保留既有身份、行为、文案与范围外内容;重构保留产品事实、内容、功能、原生可供性与约束,但把旧外观作为证据与反参考,并在 new-work 中选定替代世界、替换 DESIGN.md。
- 视觉权威是证据而非文件名:缺失 DESIGN.md 本身并不代表项目是全新的。
限制与说明
- 使用前需运行 Setup 的 context.mjs,并遵循其指令,不要重复运行。
- 在分析与方向确定后、编辑 UI 前才加载 craft-floor.md。
- teach 是其 init 的别名;craft 已废弃且不再增加内容。
- init 写入 PRODUCT.md 后,无需重新运行 context.mjs 即可继续;当记录的平台为 ios、android 或 adaptive 时,init 会自行加载原生平台参考。
- 绝不把修复漂移作为设计任务的副作用;CONTEXT_STALE 发现只报告、不处理,除非用户要求;标记为 auto 的发现除外。
- 本技能的相关参考文档(routing.md、new-work.md、operate.md、各命令参考等)与具体脚本命令内容已在资料中给出,此处不改动代码内容。
- 关于收费、价格、可用平台等具体信息,资料中暂未提供。