Designing Delight That Earns Its Place: Inside Impeccable‘s `/delight` Reference
Designing Delight That Earns Its Place: Inside Impeccable‘s `/delight` Reference
📅 发布时间:2026/9/9 15:09:27👁 浏览次数:
Designing Delight That Earns Its Place: Inside Impeccables/delightReference【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable导读Impeccable 的设计技能skill中/delight不是加彩蛋而是把产品的性格注入到真正值得纪念的交互时刻。本文以 delight.md 这一 playbook也在 plugin/skills/impeccable/reference/delight.md 同步维护为主线完整拆解它从寻找时机到定义 delight thesis、再到构建情绪时刻保护体验验证的全流程。读完你会掌握一套可执行的判断框架什么时候值得做一点愉悦设计、用什么最小系统去实现它、以及如何确保它不伤害可访问性、性能与任务主线。1. 这份文档在 Impeccable 技能体系中的位置Impeccable 的核心入口是技能清单 plugin/skills/impeccable/SKILL.md它把任务路由到一组命令每个命令对应reference/目录下的一份 playbook命令类别职责Referencedelight [target]EnhanceAdd personality and memorable touchesreference/delight.mdanimate [target]EnhanceAdd purposeful animations and motionreference/animate.mdpolish [target]RefineFinal quality pass before shippingreference/polish.md在命令元数据里delight 的触发语义被精确定义见 command-metadata.json 中delight条目Add moments of joy, personality, and unexpected touches that make interfaces memorable and enjoyable to use. Elevates functional to delightful. Use when the user asks to add polish, personality, animations, micro-interactions, delight, or make an interface feel fun or memorable.也就是说当用户提到加一点个性 / 让界面有趣 / 想要难忘的感觉时模型会先读取 delight 的 reference 文档而不是凭直觉堆装饰。这份文档开头用一个引用块声明了它无法从代码里推断出的前提Additional context needed: the brands emotional range.这是整套方法论的第一条纪律愉悦设计的前提是知道品牌的情感幅度emotional range如果从目标、DESIGN.md、文案声音中都无法推断才允许向用户提问。2. 先读懂访问者模式再决定个性可以走到多远delight 文档开门见山给出了结论式的立场Delight is not a layer of generic whimsy; it is product character revealed through a useful interaction, a humane response, or an unexpectedly considered detail.它不是通用俏皮图层而是通过一次有用的交互、一个有人情味的回应、一个意想不到的用心细节所显露出的产品性格。因此第一件事是确定当前 surface 的 visitor mode。SKILL.md 定义了四种模式Persuade / Operate / Read / Experiencedelight playbook 把它们归并成两组给出不同的个性配额模式组个性可以流动到哪里纪律Persuade Experience声音voice、构图、动效、探索discovery都可以承载个性制品本身仍是焦点个性不能淹没主体Operate Read把愉悦集中在首次使用、完成、恢复、掌握等有意义时刻可靠性托起其余一切个性必须退到精确细节里从源码结构看这一分组与 SKILL.md 的 Modes 一节一脉相承Persuade 强调design is the productExperience 强调let the artifact lead from the first viewport而 Operate/Read 强调 scanability、一致性、理解优先。delight 的写法是对 Persuade/Experience 可以放开一些对 Operate/Read 要把愉悦钉在少数关键时刻——比如空状态引导、保存成功的确定性反馈、出错后的恢复路径。3. 寻找时机先勘察不制造庆祝在动任何有趣的手笔之前文档要求同时勘察五类输入target当前要处理的界面DESIGN.md已承诺的视觉世界与设计语言product voice产品声音repeated-use frequency重复使用频率emotional context情绪语境随后在这六类信号中寻找机会值得被承认的努力effort worth acknowledging——用户在过程中投入了真实劳动可以被转化为信息的等待waiting that can become informative——等待本身无法避免时能否传递有用的上下文能起到引导作用的空状态 / 首次使用态an empty or first-use state that can orient——此时愉悦要先完成指明下一步的本职需要同理心的错误或恢复时刻an error or recovery moment that needs empathy物理或言语反馈能表达品牌的交互an interaction whose physical or verbal response could express the brand——例如开关、拖拽、提交按钮的物理隐喻人们会乐于发现的实用能力a useful capability people might enjoy discovering。同时它给了两条反向红线Do not manufacture a celebration for an ordinary click. Ask only when the brands emotional range or the stakes cannot be inferred.即不要为一个普通点击制造庆祝只有品牌情感幅度或用户输不起的程度无法推断时才提问比如涉及金钱、隐私、数据丢失的高风险操作语气必须格外谨慎。4. 定义一个唯一的愉悦论点one delight thesis与 animate playbook 要求先写 motion thesis、visualize 强调单一视觉焦点一致delight 要求把愉悦收敛成一句话State in one sentence what the user should feel and why that feeling belongs to this product.这句话同时回答两个问题用户应该感受到什么这种感受为什么属于这个产品而不是任何相邻产品都能照抄随后选择能承载它的最小系统the smallest system that can deliver it候选机制有五类最小系统说明对有意义动作的独特回应一个 distinctive response而非通用 hover 效果承载声音又澄清语义的产品化文案product-specific language边澄清边带性格具有可辨认材质行为的交互/转场有真实物理世界依据的动效语言根植于产品世界的插画 / 声音 / 触觉 / 环境细节素材必须从产品世界观长出揭示真实效用的探索奖励discovery reward 背后是真实功能不是装饰关键句是Derive the treatment from product mechanism and visual world, not a stock catalog.处理手法必须从产品机制与视觉世界派生而不是从素材库里取。这也呼应了 SKILL.md 的 quality floor 精神craft-floor.md——出离常规、有观点、来源可溯。5. 为情绪时刻而构建六种状态逐一落地playbook 把情绪时刻拆成六种典型状态每种都有明确的行为准则Success成功Match the response to the effort and consequence.响应的规模必须与用户付出的努力和后果相称。重大里程碑如发布、下单、完成导入可以适当展开庆祝日常保存这种例行动作感到确定就够了——reliable 的确定感本身就是最好的反馈。Waiting等待Show truthful progress, useful context, or product-specific activity. Never fake work or delay completion to stage a flourish.展示真实的进度、有用的上下文或产品化的活动状态。严禁假造工作、严禁为了给一个炫技动画让路而人为拖慢完成——这与 animate playbook 中Long feedback feels like latency过长的反馈会像延迟的计时纪律互为印证。Empty and first use空状态 / 首次使用Make the next action clear before adding personality.先让下一步动作清楚再考虑加个性。空状态的首要职责是指引个性是第二层。Error and recovery错误与恢复Lead with the problem and recovery. Warmth may reduce stress; jokes must not trivialize loss, money, privacy, or blocked work.永远先讲问题和恢复路径。温暖可以减压但玩笑绝不能轻浮化数据丢失、金钱、隐私、被阻塞的工作这类高代价场景。Repeated interaction重复交互Keep the response satisfying after the hundredth use.第 100 次使用后依然要令人满意。变化variation只有在仍然连贯、可预测、足以建立信任时才有价值——也就是说变化不能以牺牲可预测性为代价。Discovery探索Reward curiosity without hiding required functionality.可以奖励好奇心但绝不能把必需功能藏起来只作为彩蛋。最后一条统摄性纪律Copy must use the products language. Generic whimsy is worse than neutral clarity.文案必须使用产品自己的语言通用俏皮话比中性的清晰更糟。6. 保护体验愉悦的不可为清单delight 必须不违反以下六条底线这构成了它在工程上不被放纵的护栏不得延迟、阻塞或遮蔽主任务delay, block, or obscure the primary task不得覆盖平台惯例或可访问性override platform conventions or accessibility不得添加未被要求的陈述性主张add unrequested factual claims——比如在文案里替产品声称最强/最安全这类无据事实未经同意不得播放声音且必须遵守静音设置play sound without consent or ignore mute settings不得变成强制、不可跳过、或重复后令人疲惫mandatory, unskippable, or exhausting on repeat不得添加与时刻不相称的依赖或资产成本add a dependency or asset cost disproportionate to the moment。对于有作者设计的动效文档明确指向 animate.md——它承载了完整的动效方法论按 100–150ms即时反馈、150–300ms常规状态变化、300–500ms布局/浮层/视图转场、500–800ms精心编排的焦点入场的时长表选择节奏离场快于入场使用cubic-bezier(0.16, 1, 0.3, 1)这类自然减速而非反射性的弹跳曲线必须为prefers-reduced-motion提供有意图的替代方案同时保留承载意义的反馈。delight 还要求尊重读屏器、键盘、触摸、本地化与文化语境Nonessential loops stop when hidden. Make celebration intensity proportional to frequency and consequence.非必要的循环动效在隐藏时必须停止庆祝强度要与使用频率和后果成正比——这也和 animate 中nonessential loop must stop when offscreen完全一致。7. 验证清单防止 charm 退化成 friction当体验被加入愉悦元素后用以下六条标准自检Verification不可迁移性这个时刻足够具体相邻产品不能原封不动地照搬真实收益它确实改善了理解力comprehension、信心confidence、动机motivation或情绪恢复emotional recovery中的至少一项无繁荣时依然成立去掉装饰界面仍然快速且意图明显——flourish 是加法不是拐杖重复不增摩擦第 N 次使用时charm 没有变成 friction全路径可用静音、键盘、触摸、本地化路径全部工作世界感正确结果像被选中的那个世界的自然表达而不是一份泛化的 delight 处理。最后一步是交接When the personality feels earned, hand off to/impeccable polishfor the final pass.当个性挣得了存在资格后交给 polish 做收尾。polish 的完整流程见 polish.md它按系统先行→收集证据→分诊→整体打磨→验证并收尾推进其中分诊顺序把功能缺陷、状态缺失、设计系统漂移放在视觉与动效不一致之前——这恰好守护了 delight 的核心承诺愉悦不得以正确性为代价。8. 从 playbook 到命令它如何被加载与执行在运行时delight playbook 不是给人手抄的规范而是可路由、可测试的技能资产路由SKILL.md 的 Commands 表登记了delight [target]参数提示为[target]当用户请求与 command-metadata.json 中delight的描述匹配时模型加载 delight.md 并遵循其指令。同源同步同一份 playbook 在skill/reference/源与plugin/skills/impeccable/reference/发布副本中维护两份文件逐字一致说明它是经过校验、可随版本发布的正式 reference。执行入口SKILL.md 的allowed-tools声明技能通过Bash(npx impeccable *)获得工具能力会话开始时先运行node skill-base-dir/scripts/context.mjs读取 PRODUCT.md、DESIGN.md 与 surface brief——delight 寻找时机时依赖的正是这些已加载的项目事实。与其他参考的关系animate作者化动效的落地细则、polish最终质检与交接都是 delight 工作流的相邻环节当设计进入排版、间距与色彩层级问题时应分别路由到 layout/typeset/colorize而非在愉悦层里解决结构问题。9. 结语把惊喜当作一种受约束的设计决策回看整份 playbook最值得记住的三条心智模型是愉悦要有来源——derive from product mechanism and visual world不允许从素材库空降愉悦要有配额——在 Persuade/Experience 可以流动在 Operate/Read 只集中到首次使用、完成、恢复与掌握这几个关键时刻愉悦要有边界——不得延迟任务、覆盖无障碍、无据加主张、强制重复或代价失衡验证的最后一条标准永远是它是否仍然像被选中的那个世界。当某一次交互确实值得被记住、且个性确实挣到了资格时再把它交给 polish 完成最后一道质检——这就是 Impeccable 眼里delight与加戏的本质区别。【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考