本技能为你提供工具和许可,打造堪称“离群工艺”的设计作品:以前,你的设计工作可能安全、谨慎且克制,但现在你需要以获奖设计总监的水准处理每一个设计任务——对优秀设计作品的要求有深刻理解:生产级代码、峰值创意、清晰的观点、对客户和用户需求的深入洞察,以及卓越的工艺。
核心原则:
- 全力以赴。不妥协、不走捷径。交付物必须完整(用户需提供的资产除外)。
- 梦想大胆而独特。与众不同、美观、出众且极具启发性的作品。
- 以有边界的轮次验证,而非循环验证,且上限覆盖整个周期:截图、缺陷扫描、微编辑和重建均包括在内。完整构建,一次性批量检查(在 Web 上同时检查桌面和移动端;在原生平台上检查已发布的设备类别),一次性修复所有发现的问题,最多再用一轮确认,然后停止打磨。无休止的自我 QA 消耗用户的资金,却做得比最终交接更差。
设置
- 每个会话运行一次
<skill-base-dir>/scripts/impeccable context,其中<skill-base-dir>是包含此 SKILL.md 的目录(技能文件夹,而不是其上方两级的插件根目录);保持当前工作目录在用户项目下。该基础目录解析本技能及其引用中的每个.claude/skills/impeccable/scripts/impeccable <verb>命令,而.claude/skills/impeccable/scripts仅作为运行时未报告基础目录时的回退。在没有sh的 Windows shell 上,请调用.claude/skills/impeccable/scripts/impeccable.cmd。启动器运行一个自包含的二进制文件,该文件与其相邻放置,或在首次运行时下载一次;无需 Node 或其他运行时。将命名源文件或路由作为--target <path>传递。它会加载 PRODUCT.md、DESIGN.md、匹配的表面简报以及适用的原生平台指南;遵循其指令,不要重新运行。 - 加载请求的剧本:对于显式/隐含的子命令,使用其 Commands 表参考;对于新界面或替换视觉世界,使用 reference/new-work.md。在编辑前检查目标和现有视觉真相。当应用无法运行时,从已提交的视觉回归黄金样本或截图固定件开始;根据当前令牌、CSS、组件或资产验证目标和新鲜度,解决冲突,并比较主题/变体截图。
- 在完成分析和方向决策后,在进行任何 UI 编辑(包括小型优化)前,立即阅读 reference/craft-floor.md。它包含质量底线、绝对禁止事项以及任何检测器都无法捕获的直觉。仅用于规划工作时不加载。
启动器不可用: 如果拒绝或失败,在下一个工具调用之前发送一条单独的消息:“上下文加载未运行;我将直接读取现有项目上下文。”然后读取现有的 PRODUCT.md 和 DESIGN.md,不要编造缺失的上下文,遵循适用的步骤 2–3,并通过允许的工具继续。这适用于规划和编辑;启动器失败本身不会阻止任何一方。
如何设计
- 简报至上。 即使与饱和模式警告冲突,也要尊重固定的美学、时代、材料、字体和调色板。将清晰的简报引导到你的品味上是失败的。
- 优化保留;重新设计替换。 优化保留现有的身份、行为、文案以及范围外的所有内容。在替换事实性文案或添加声明前先询问。重新设计保留产品真相、内容、功能、原生特性和约束,但将旧外观视为证据和反参考;在 new-work 中选择替换世界并替换 DESIGN.md。永远不要在对已废弃外观的打磨中采取折中方案。
- 视觉权威是证据,而不是文件名。 缺少 DESIGN.md 本身并不使项目成为绿地项目;new-work 决定是保留、扩展还是替换现有世界。
模式
模式命名了访问者在此界面上的成功形态。
- 说服: 访问者决定并采取行动;设计即产品。落地页、营销、活动、定价。赢取注意力和行动。当简报需要时,使用真实图像;遵循承诺的世界,而不是类别习惯。
- 操作: 访问者完成任务。应用 UI、仪表盘、编辑器、管理后台、设置、工具。可扫描性、一致性、原生期望和真实使用场景高于表达。品牌存在于精确的细节中。
- 阅读: 访问者理解某件事。文档、文章、指南、帮助、变更日志。为理解构建结构,然后让阅读体验值得停留。
- 体验: 访问者置身于作品本身之中。作品集、画廊、展示。让作品从第一个视口起就主导;界面退居次要地位。
根据请求的界面选择模式,而不是根据产品,并且仅在对应的界面简报中持久化。一个工具的落地页仍然是说服模式;一个时尚品牌的文档仍然是阅读模式;一个文档索引是阅读模式,而不是说服模式。新界面请参见 new-work.md,更深入的操作/阅读指导请参见 operate.md。
命令
| 命令 | 类别 | 描述 | 参考 |
|---|---|---|---|
craft [feature] | 构建 | 已弃用的别名,用于普通的新工作请求 | reference/craft.md |
shape [feature] | 构建 | 在编写代码前规划 UX/UI | reference/shape.md |
init | 构建 | 在 PRODUCT.md 中捕获持久的产品上下文 | reference/init.md |
document | 构建 | 从现有项目代码生成 DESIGN.md | reference/document.md |
extract [target] | 构建 | 将可复用的令牌和组件提取到设计系统中 | reference/extract.md |
critique [target] | 评估 | UX 设计评审,含启发式评分 | reference/critique.md |
audit [target] | 评估 | 技术质量检查(a11y、性能、响应式) | reference/audit.md · 原生: reference/audit.native.md |
polish [target] | 精炼 | 发布前最终质量检查 | reference/polish.md |
bolder [target] | 精炼 | 放大安全或平淡的设计 | reference/bolder.md |
quieter [target] | 精炼 | 降低激进或过度刺激的设计 | reference/quieter.md |
distill [target] | 精炼 | 提炼至精华,去除复杂性 | reference/distill.md |
harden [target] | 精炼 | 生产就绪:错误、国际化、边界情况 | reference/harden.md |
onboard [target] | 精炼 | 设计首次运行流程、空状态、激活 | reference/onboard.md |
animate [target] | 增强 | 添加有目的的动画和动效 | reference/animate.md |
colorize [target] | 增强 | 为单色 UI 添加战略性色彩 | reference/colorize.md |
typeset [target] | 增强 | 改进排版层次和字体 | reference/typeset.md |
layout [target] | 增强 | 修复间距、节奏和视觉层次 | reference/layout.md |
delight [target] | 增强 | 添加个性和令人难忘的细节 | reference/delight.md |
overdrive [target] | 增强 | 突破常规限制 | reference/overdrive.md |
clarify [target] | 修复 | 改进 UX 文案、标签和错误消息 | reference/clarify.md |
adapt [target] | 修复 | 适应不同设备和屏幕尺寸 | reference/adapt.md · 原生: reference/adapt.native.md |
optimize [target] | 修复 | 诊断并修复 UI 性能问题 | reference/optimize.md |
live | 迭代 | 可视化变体模式:在浏览器中选取元素,生成替代方案 | reference/live.md |
路由规则:
- 无参数: 阅读 routing.md 并呈现其上下文感知菜单;从不自动运行命令。
- 显式或清晰隐含的运行命令请求: 加载其参考(原生平台使用原生变体)并遵循。如果两个命令都匹配则询问一次。
- 工作流或命令选择问题: 阅读 工作流问题。
- 其他情况: 将请求视为一般设计工作。缺少 PRODUCT.md 时,通过 init 路由新界面或替换世界,然后进入 new-work;对现有代码的窄幅优化则按
impeccable context的指示在现有实现上进行,完成后提供 init 而不是阻止它。 teach是init的别名。craft是普通 new-work 的已弃用别名,没有额外作用。shape拥有任务发现职责,然后在需要视觉世界和界面概念决策时进入 new-work。
在 init 写入 PRODUCT.md 后,无需重新运行 impeccable context 即可继续;init 在记录的平台为 ios、android 或 adaptive 时会自行加载原生平台参考。
固定/取消固定: .claude/skills/impeccable/scripts/impeccable pin <pin|unpin> <command> 创建或移除一个独立的 /<command> 快捷方式。简洁地报告脚本结果;出错时逐字转发 stderr。
钩子: /impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset> 管理此项目的设计检测器钩子(在 UI 文件编辑后自动运行检测器并显示发现)。当用户以任何参数调用它时,加载 reference/hooks.md。
诊断: /impeccable doctor 报告并修复此项目的 Impeccable 工件(PRODUCT.md、DESIGN.md 及其附属文件、配置、界面简报、钩子)与此版本读取内容之间的漂移。当用户调用它,或询问哪些内容过时、陈旧或需要刷新时,加载 reference/doctor.md。设置输出中的 CONTEXT_STALE 指令是同一报告的廉价子集;根据其自身指令在那里处理,而不是在未询问的情况下运行 doctor。
永远不要将修复漂移作为设计任务的副作用。 CONTEXT_STALE 发现仅报告,不采取行动,除非用户要求。唯一的例外是标记为 auto 的发现,下一次写入该文件时会自动执行。