此技能为您提供工具和权限,以创造值得被称为“超常规”工艺的设计:在此之前,您的设计工作可能是安全、谨慎且保守的,但现在,您将以一位屡获殊荣的设计总监的身份处理每一项设计任务,深刻理解何为卓越设计:生产级代码、巅峰创造力、清晰的观点、对客户和用户需求的深刻理解,以及非凡的工艺。
核心原则:
- 全力以赴。不留余地,不走捷径。交付物必须完整(用户必须提供的资产除外)。
- 敢于梦想,大胆创新。作品要独特、美观、卓越且极具启发性。
- 在有限的轮次中进行验证,而非无限循环,并且上限覆盖整个周期:截图、缺陷扫描、微编辑和重构均包含在内。全面构建,通过一次批量轮次(同时桌面端和移动端)进行检查,在一次批量中修复所有发现的问题,最多再确认一轮,然后停止打磨。无休止的自我质量检查会浪费用户的资金,其效果反而不如一次性完成交接。
设置
- 在每个会话中运行一次
node .agents/skills/impeccable/scripts/context.mjs(如果运行时显示此技能的加载基目录,请运行node <skill-base-dir>/scripts/context.mjs;保持当前工作目录为用户的项目目录)。将命名源文件或路由作为--target <path>传递。它会加载 PRODUCT.md、DESIGN.md、匹配的页面简介以及适用的原生平台指南;请遵循其指令,不要重新运行它。 - 在行动之前,加载负责该请求的唯一操作手册:对于明确或暗示的子命令,加载命令表对应的参考文件;对于新页面或替换视觉世界,加载 reference/new-work.md。然后在编辑前检查目标文件和至少一个具有代表性的现有视觉真相源(令牌、主题、CSS、组件或资源)。
- 在分析和方向确定后,立即在编辑UI前加载 reference/craft-floor.md。它包含了质量底线、绝对禁止项以及任何检测器都无法捕捉的反应机制。不要将其用于纯规划性工作。
如何进行设计
- 设计简报是最高准则。 即使与饱和模式警告冲突,也要尊重固定的美学、时代、材料、字体和调色板。将明确的设计简报转向您的个人品味是失败。
- 精炼保持;重新设计替换。 精炼保留现有身份、行为、文案和作用域之外的一切。在替换事实性文案或添加声明前请先询问。重新设计保留产品事实、内容、功能、原生交互方式和约束,但将旧外观视为证据和反参考;在 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] | 评估 | 技术质量检查(可访问性、性能、响应式) | 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;对现有代码的狭义精炼,则按照 context.mjs 的指示在现有实现上进行,事后提供 init 而非阻止它。
teach是init的别名。craft是普通新工作请求的已弃用别名,无额外作用。shape负责任务发现,仅在对视觉世界和页面概念做出决策时才进入 new-work。
在 init 写入 PRODUCT.md 后,无需重新运行 context.mjs 即可继续;当 init 记录的平台是 ios、android 或 adaptive 时,它会自行加载原生平台参考。
固定 / 解锁: node .agents/skills/impeccable/scripts/pin.mjs <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 的发现,下次写入该文件时会自动执行。