数据库客户端后端前端CLI桌面应用数据可视化AI 应用【免费下载链接】whodbWhere data access meets operational intelligence项目地址https://gitcode.com/gh_mirrors/wh/whodb点击查看免费下载本文以 WhoDB 仓库中.agents目录下 Impeccable 设计技能的delight参考文档为核心拆解这套为 AI 编码代理编写的前端体验方法论它如何定义delight愉悦感、如何为一次交互机会确立单一 thesis、如何围绕六种情感时刻构建响应以及它的验证清单与边界保护规则。读完后你能掌握一套可复用的克制型愉悦设计工作流并理解 WhoDB 自己的设计系统PRODUCT.md / DESIGN.md是如何为这类增强提供品牌输入的。delight 是什么不是随机撒糖而是产品性格的显形delight [target]是 Impeccable 技能 Enhance增强类别下的子命令其定位在技能元数据中表述为Add moments of joy, personality, and unexpected touches that make interfaces memorable and enjoyable to use. Elevates functional to delightful. —— command-metadata.json而参考文档 delight.md 开篇L3给出了一条比元数据更严格的定义Make the experience memorable at moments that earn it. 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.即愉悦感不是覆盖在界面上层的一层通用俏皮而是产品性格通过一次有用的交互、一个得体的响应、一个出人意料但深思熟虑的细节显露出来。这一整篇 playbook 本质上是一份写给编码代理的约束文档文档第一行还声明了执行前缺失的上下文——Additional context needed: the brands emotional range品牌情感幅度只有当品牌情感幅度或风险等级无法从项目上下文推断时才向用户提问L23。这与同目录其他 playbook如 clarify.md 需要audience knowledge and emotional state、animate.md 需要performance constraints采用完全一致的结构声明前置上下文 → 分节给出操作规则 → 收尾给出 Verify 清单与交接指令。在 Impeccable 技能中的位置从 SKILL.md 的 Commands 表看delight与animate动画、colorize配色、typeset排版、layout布局同属 Enhance 类而bolder/quieter/distill属于 Refine 类放大/收敛/精简既有设计。文档结尾L70规定当个性感觉是被赢得的the personality feels earned时交接给$impeccable polish做最终打磨。也就是说 delight 在流水线中的位置是context.mjs加载 PRODUCT.md / DESIGN.md / 表面简报SKILL.md Setup 节 要求每个会话运行一次按 Commands 表路由到delight.md并按其规则修改 UI编辑 UI 前需加载 craft-floor.md质量底线与绝对禁令完成并自检后交给polish。此外pin.mjs 支持将delight固化为独立快捷命令$delightnode .agents/skills/impeccable/scripts/pin.mjs pin delight # 移除 node .agents/skills/impeccable/scripts/pin.mjs unpin delight该脚本会在项目根目录下探测所有已安装 Impeccable 的 harness 目录.claude、.cursor、.codex、.agents等见 L23-L26 的HARNESS_DIRS并创建/移除对应的 pin 标记文件。在 live.md 的浏览器实时变体模式中delight也是一个 action其变体维度被限定为不同风味的人格micro-interaction / typographic surprise / illustrated accent / sonic-or-haptic / easter eggL172。Visitor mode同一份 delight 规则在两类界面上的不同浓度文档 L7-L10 将规则按 visitor mode 分叉mode 概念定义在 SKILL.md 的 Modes 节Persuade / Operate / Read / Experience 四种Persuade Experience落地页、作品集、展示型界面个性可以贯穿 voice语气、composition构图、motion动效与 discovery发现感前提是工件artifact本身仍是焦点Operate ReadApp UI、仪表盘、编辑器、文档把愉悦感集中在有意义的时刻——首次使用、完成、恢复、精通其余一切由可靠性reliability承载。这与 WhoDB 自身的定位完全吻合。PRODUCT.md 将用户定义为管理多个数据库系统、常在事故或维护期间工作的 DBA / DevOps 工程师设计原则第一条就是Speed is the feature品牌人格是Confident, clean, capable…clarity and speed ARE the personality。DESIGN.md 的 Creative North Star 是Quiet Confidence并明确拒绝了过度俏皮的 SaaSillustration-heavy、rounded pastels、startup energy——这正是 delight playbook 警告的 generic whimsy 的具象。因此对 WhoDB 前端而言delight 落在 Operate 分支可靠性承载一切愉悦感只出现在值得的时刻。operate.md L61 对此有近乎同义的表述Consistency over surprise…delight is saved for moments, not pages.一致性优先于惊喜愉悦留给时刻而非页面。Find the opportunity六类值得加码的交互机会文档 L12-L23 规定了机会发现的方法论。执行者应先检查五类输入目标界面、DESIGN.md、产品语气、复用频率、情感上下文然后只寻找以下六类机会机会类型原文表述在数据库工具中的对应场景值得被承认的努力effort worth acknowledging一次大表导出、一次成功的批量迁移可以变得有信息量的等待waiting that can become informative查询执行进度、连接建立过程能定向的空/首次使用状态an empty or first-use state that can orient首次连接前的引导、无 schema 时的提示需要同理心的错误或恢复时刻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隐藏的高级筛选、快捷键随后是两条硬约束L23不要为一次普通点击制造庆祝Do not manufacture a celebration for an ordinary click只在品牌情感幅度或风险等级无法推断时才提问。这两条直接对抗最常见的反模式——把 confetti、bounce、干得好式文案撒到每一次 hover 上。Define one delight thesis先立论再选最小系统L25-L35 是全篇的方法论核心。它要求用一句话陈述用户应该感受到什么以及为什么这种感受专属于这个产品然后选择能交付该感受的最小系统候选形态共五类对一次有意义动作的有辨识度的响应a distinctive response to a meaningful action既能澄清又携带语气的产品专属语言product-specific language具有可辨识材质行为的交互或过渡an interaction or transition with a recognizable material behavior;扎根于产品世界的插图、声音、触感或环境细节揭示真实工具价值的发现式奖励a discovery reward that reveals real utility。最后一条原则处理方案必须从产品机制与视觉世界中推导而不是从库存目录stock catalog里挑一个现成的——禁止凡是产品 UI 都能直接搬用的通用特效。这一节实际上把 delight 从加特效重新定义为一次设计决策先有论点thesis再为论点选最便宜的实现。这与 WhoDB 的 token 驱动设计系统DESIGN.md 要求一切样式经由var(--font-size-*)/var(--radius-*)/var(--spacing-*)与 CSS 自定义属性表达天然兼容——任何 delight 细节如果想存活于密度切换small/medium/large 档位与双主题Paper/Ink之下就必须落在 token 体系内而不能是硬编码的一次性样式。Build for the emotional moment六种情感时刻的构建规则L37-L46 把情感时刻拆成五个具体类别每一类都有明确的该做什么/不该做什么Success成功响应必须与付出的努力和后果匹配——重大里程碑可以展开expand例行保存只需确定感simply feel certain。对应到数据库工具一条DELETE成功后不应有火箭升空而一次跨库迁移完成则可以有一个值得记住的确认。Waiting等待展示真实的进度、有用的上下文或产品专属的活动绝不伪造工作量、绝不为了表演而延迟完成。Empty and first use空与首次使用先让下一个动作清晰再谈个性。顺序不能反。Error and recovery错误与恢复以问题和恢复路径开头温度warmth可以降压但玩笑绝不能轻视数据丢失、金钱、隐私或被阻塞的工作。Repeated interaction重复交互响应在第一百次使用时依然令人满意变化variation只有在保持连贯且可预测到值得信任时才成立。Discovery发现奖励好奇心但不隐藏必需功能。L46 收了一记重锤Copy must use the products language. Generic whimsy is worse than neutral clarity.——文案必须使用产品自己的语言通用的俏皮比中性的清晰更糟。WhoDB 仓库中已经能看到这种方法的影子例如 schema 视图的空状态不是这里什么都没有式的敷衍而是明确指向没有表这一事实的No tables found且这条文案在 schema-viewer.yaml 中随 30 种语言本地化维护——这正是空状态先定向orient、再谈个性、且文案走产品语言三条规则的落地形态。Protect the experiencedelight 的六条禁区L48-L59 用一份禁止清单划出边界任何 delight 实现都不得延迟、阻塞或遮蔽主任务覆盖平台惯例或可访问性添加未经请求的事实性声明未经同意播放声音或无视静音设置变得强制、不可跳过、或在使用中令人疲惫为某个时刻添加与时刻不成比例的依赖或资产成本。随后是对其他 playbook 的引用与通用要求凡涉及自作者动效authored motion加载 animate.md——它规定了 100–150ms 即时反馈 / 300–500ms 布局过渡等时长梯度、退出快于进入、以及不得为现有栈能表达的效果引入依赖尊重屏幕阅读器、键盘、触控、本地化与文化语境非必要的循环动效在不可见时必须停止庆祝的强度要与发生频率和后果成正比。这条不可见即停止在 WhoDB 前端有真实对应物index.css 中为加载标记loader mark的多个 SVG 部件定义了prefers-reduced-motion: reduce分支约 L648-L661当用户系统偏好减弱动效时所有animation被置为none仅保留静态形态L803 还有一处同类媒体查询。这既是 PRODUCT.md 中Respectprefers-reduced-motion原则的实现也是 delight 禁区第 2 条不覆盖平台惯例与可访问性的代码证据。Verify交付前的六问与 polish 交接L61-L70 是自检清单每一条都是可执行的验收标准这个时刻具体到邻近产品无法原样照搬the moment is specific enough that a neighboring product could not use it unchanged——这是anti-stock-catalog原则的验收形式它改善了理解、信心、动机或情绪恢复去掉这个装饰后界面依然快速且显而易见fast and obvious without the flourish重复使用不会让魅力变成摩擦静音、键盘、触控与本地化路径全部可用结果感觉属于所选定的世界而不是一套通用的delight 处理。全部通过后按 L70 的指令hand off to $impeccable polish for the final pass进入 polish.md 的收尾流程建立系统认知 → 收集证据 → 分诊 → 全路径打磨 → 再次走查。在 WhoDB 仓库中实操 delight 的完整路径把上述文档放回它的运行环境实际操作序列是# 1. 每个会话运行一次上下文加载读入 PRODUCT.md、DESIGN.md、表面简报 node .agents/skills/impeccable/scripts/context.mjs --target frontend/src # 2. 在编码代理中调用 delight 子命令target 指向具体表面 # 路由规则见 SKILL.md Commands 表Enhance 类 → reference/delight.md $impeccable delight frontend/src/pages/... # 3. 可选把 delight 固定为独立快捷命令 node .agents/skills/impeccable/scripts/pin.mjs pin delight几点前提与限制需要说明context.mjs的路径解析规则其文件头注释 L11-L24是活动项目根 →.agents/context/→docs/→ 仓库根 →$IMPECCABLE_CONTEXT_DIR依次回退WhoDB 的 PRODUCT.md 与 DESIGN.md 都在仓库根目录因此任意工作目录启动都会被正确解析。若找不到 PRODUCT.md脚本会打印NO_PRODUCT_MD:技能据此把请求导向 init 流程而非直接执行 delight。delight 是纯 UI 工作SKILL.md 明确声明该技能Not for backend-only or non-UI tasks所以它的 target 应指向前端表面如frontend/src/下的页面/组件而不是 Go 后端或 CLI。由于 WhoDB 采用 token 驱动样式DESIGN.md 要求经clidey/ux的 CSS 自定义属性扩展组件禁止!important覆盖组件内部delight 产出的任何视觉细节若要合规也必须落在 token 与语义角色上——这既是 DESIGN.md 的 Density-Tier Rule也是 delight 不成比例成本禁区的工程化表达。小结delight.md的价值不在于提供一套加特效的清单而在于提供一套反特效的方法论先确定品牌情感幅度再从六类机会中挑选真正值得的时刻用一句话立住专属本产品的 thesis选最小系统实现用六条禁区守住主任务与可访问性最后以去掉它界面依然清晰为验收线交给 polish。WhoDB 仓库中的 Quiet Confidence 设计体系——空状态的克制文案、本地化的状态语言、prefers-reduced-motion下的动效降级——正是这套方法论在 Operate 型产品上的实际落点对一款以快速、清晰、克制为性格的数据库管理工具来说最好的 delight 往往是不喧宾夺主的那一种。赞分享数据库客户端后端前端CLI桌面应用数据可视化AI 应用【免费下载链接】whodbWhere data access meets operational intelligence项目地址https://gitcode.com/gh_mirrors/wh/whodb点击查看免费下载相关推荐Impeccable 实战/impeccable delight 命令如何为界面注入“产品性格”Impeccable 实战 /impeccable delight 命令如何为界面注入“产品性格” Impeccable 是一个“让 AI 编码助手更懂设计”AI 技能前端CLIdsh-pluginImpeccable 的 /impeccable delight 命令用情感时刻为 AI 生成界面注入克制的产品性格Impeccable 的 /impeccable delight 命令用情感时刻为 AI 生成界面注入克制的产品性格 Impeccable 是面向 AIAI 技能前端CLIdsh-pluginImpeccable 的 Delight 设计方法在值得的时刻为 AI 生成界面注入产品性格Impeccable 的 Delight 设计方法在值得的时刻为 AI 生成界面注入产品性格 本文基于 Impeccable 设计语言中 delight 参考AI 技能前端CLIdsh-plugin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考