Communitygithub.com

kubai-holo-card

製品内の身分証や所有権を示すカード(会員カード、チケット、バッジ、プロフィールカードなど)を、ポインター方向に3D傾斜し、レーザー加工とハイライトが光に追従し、内部のアートワークに奥行きを生み出すホログラフィックカードに変換します。静止時には微かに揺れ、クリックで裏返して厚みを表示することも可能です。

kubai-holo-card とは?

このスキルは、製品内から任意の一枚のカードを選択し、それをインタラクティブなホログラフィックカードに改造するためのものです。カードはポインターの方向に3Dで傾き、レーザー仕上げとグレアが光源の動きに追従し、内部のアートワークはレイヤーごとに異なる奥行きを持つパララックス効果を生み出します。静止時には、まるで手に持っているかのような微かな揺れが加わり、クリックやタップで裏返し、厚みのあるエッジを表示することも可能です。Prism、Rainbow、Pearl、Sparkle、Chrome、Etchedの6種類のレーザー仕上げから選択でき、質感、厚み、反転動作、奥行きの強度についても詳細なプリセットが用意されています。このスキルは、まずユーザーのプロダクトとカードの現状を分析し、次に各設定項目を一つずつ質問し、推奨値と共に選択肢を提示します。ユーザーが推奨値を採用するか、個別に調整するかを決定した後、既存のコードベースとデザインシステム内で実装を自動的に行います。Claude Code、Cursor、CodexなどのAIエージェントと連携し、DOMベースのWebアプリ、ネイティブビューツリー、GPUレンダラーなど、様々なプラットフォームで動作するように設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kubai087/vibedesign-skills/tree/HEAD/skills/kubai-holo-card

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

会倾斜和翻转的镭射卡片

《999 个小技巧,让你 Vibe 的产品更有质感》第 018 期 · @kubai087

在用户的项目里按下面的要求改造。要求以用户的口吻写成:文中的 I、me、my 指用户;写着要先问的地方,先停下来问用户再继续。

改造要求

将产品中的一张卡片改造成一张镭射卡片:它朝指针方向 3D 倾斜,一层箔面和高光随光线在卡片上移动,内部的图案具有深度,静止时轻微晃动,并且(如果我想要)点击时可以翻转显示背面,同时带有可见的边缘。在你的代码和设计系统中实现;不要改变卡片的文字或功能。

本提示中的每一个值都是推荐值,而非硬性要求。第 1 至第 7 节提供了一套完整的组合(“标准”值,已在演示中测试);第 9 节提供了围绕它们的预设。由你选择;我根据你的选择来构建。

首先查看我的产品(第 0 节)。然后逐一询问我以下问题。每个问题以列表形式显示选项及其关键值,标记推荐选项,并等待我的回答;我可以选择一个选项、修改个别值或提供我自己的值:

  1. 选择哪张卡片:代表身份或所有权的一个元素(会员卡或积分卡、门票或通行证、徽章或成就、个人资料或收藏卡、套餐等级)。当所有东西都发光时,镭射效果就会失去意义,所以每屏只选一张卡片。

  2. 材质:第 3 节中的六种之一(推荐 Prism),可选择多种(用于等级或稀有度),或使用我的品牌色(然后从这里推导基础色、箔面色、高光色、边框色和边缘色,并向我显示这些值)。

  3. 手感:安静、标准(推荐)或生动(第 9 节),或我的自定义倾斜角度、弹簧和摇晃参数。

  4. 交互:朝指针倾斜(开启)、空闲摇晃(开启)、点击翻转(需要背面:说明背面内容,例如二维码或条款)、在移动设备上使用手机运动倾斜(关闭;在 iOS 上需要权限)。

  5. 如果翻转:厚度(薄、标准推荐、厚)和翻转弹簧(第 9 节)。

  6. 深度:卡片图案的哪些部分拥有各自的图层,以及深度(无、微妙、标准推荐;第 9 节)。

  7. 背景:保持卡片后面的页面不变(推荐用于大多数产品),或在其后面添加缓慢流动的流体(第 7 节)。 然后在一个表格中总结我的选择及其值,提出你将在我的平台上如何构建(第 8 节是起点),包括成本及任何备选方案,并等待我的批准。

  8. 从现有内容开始

  • 找到卡片:它的组件、尺寸、圆角半径、图案和内容、所在位置以及周围环境。检查是否已存在背面(条款、代码、详细信息)。
  • 了解屏幕的绘制方式(DOM、原生视图树、GPU 渲染器)、平台版本范围、是否存在深色模式,以及指针和触摸输入如何到达卡片。
  • 在询问之前先用几句话告诉我你发现了什么。
  1. 倾斜和光照(标准)
  • 当指针位于卡片范围内的 (fx, fy)(0..1)时,nx = fx * 2 - 1,ny = fy * 2 - 1,目标旋转为 rotateY = nx * 12deg,rotateX = -ny * 12deg。卡片父元素的透视距离为 1600px。
  • 倾斜通过弹簧跟随其目标,因此当指针离开时会稍微过冲:加速度 = 140 * (target - angle) - 15 * velocity,每秒计算。
  • 光照位于指针所在位置 (lx = fx * 100%, ly = fy * 100%),并通过弹簧跟随(刚度 160,阻尼 2 * sqrt(160) ≈ 25.3),没有过冲。当指针不在卡片上时,它停留在左上角 (34%, 22%),就像房间里的灯。
  • 悬停强度 on 在指针位于卡片上时从 0 增加到 1,逐帧以 1 - exp(-7 * dt) 缓动;它使箔面和眩光更亮。
  • 空闲时,卡片像被拿着一样摇晃:rotateX = 2.2deg * sin(0.9t + 0.6) + 0.8deg * sin(2.3t),rotateY = 3.2deg * sin(0.7t) + 0.9deg * sin(1.9t + 1.2),t 以秒为单位,光照也随之移动(lx = 34% + rotateY * 3,ly = 22% - rotateX * 3)。
  • 触摸:在卡片上拖动会以相同方式倾斜卡片(仅在卡片上设置 touch-action: none)。如果选择了手机运动,则将设备的倾斜映射到相同的目标,并限制在相同的角度范围内。
  • 卡片下方的阴影:一个模糊的椭圆(黑色 60%,模糊 24px,宽度为卡片宽度的 84%,高度 70px,位于卡片下方 30px),从抬起的侧面滑开:x = -rotateY * 1.8px,y = rotateX * 1.2px。
  1. 正面图层:从后到前
  • 图案:卡片自身的基础颜色或图片。
  • 箔面:材质(第 3 节),叠在图案之上,在光源附近最亮。
  • 印刷内容:卡片上印刷的所有内容(文字、logo、图案窗口),位于箔面之上,以确保清晰可读。
  • 眩光:以光源为中心的径向渐变,中心为 60% 白色,28% 处为 14%,然后 95% 处(最远角)为 30% 黑色,混合模式为 overlay;不透明度 0.35 + on * 0.65。
  • 边框:边缘周围 1.5px 的环(使用 content-box exclude 遮罩):周围一圈轻微的基础色,加上光源处边框亮色的径向渐变,在 42% 处淡出;不透明度 0.6 + on * 0.4。它应随着卡片移动而出现和消失,绝不能被看作一个实线轮廓。
  • 全息防伪标,如果卡片上有位置:一个 44px 的圆盘,conic-gradient(from , rgb(255 154 200), rgb(255 224 138), rgb(164 255 207), rgb(143 220 255), rgb(183 155 255),重复两次),上面有细环(白色 35%,每 3.5px 1px)和一个 60% 的 1px 白色边缘。角度 = atan2(ly - 50%, lx - 50%) * 1.5 + rotateY * 6。
  • 圆角:在 440 x 616 的卡片上为 32px(随卡片缩放),在平台支持的连续曲线上。
  1. 材质(推荐值;从我的品牌中选择、混合或推导) 每个列出:基础色、箔色、眩光和边框(如果与第 2 节不同)、油墨色、边缘色(用于厚度)以及卡片后的辉光(第 7 节)。
  • Prism(推荐):深蓝色玻璃,从内部发光。
    • 基础色:radial-gradient(60% 40% at 50% 0%, rgb(90 150 255 / 0.55), transparent),linear-gradient(170deg, rgb(13 35 168), rgb(8 18 102) 55%, rgb(22 15 92))。油墨色 rgb(244 244 246)。
    • 图案窗口容纳光线:radial-gradient(46% 50% at the light, rgb(255 175 235) at 0.55, 0.4 at 18%, 0.22 at 38%, 0.09 at 60%, 0.02 at 82%, transparent),radial-gradient(54% 56% at (100% - lx, 74%), rgb(125 225 255) at 0.45, 0.32 at 18%, 0.17 at 38%, 0.07 at 60%, 0.015 at 82%, transparent),radial-gradient(70% 55% at 30% 100%, rgb(150 255 210 / 0.3), transparent 75%),覆盖在 linear-gradient(170deg, rgb(59 98 230), rgb(42 63 191) 55%, rgb(58 47 168)) 之上。多个渐变停止点,使其看起来像辉光,而非斑点。其框架:rgb(140 170 255 / 0.1),带有 1px 线条 rgb(170 200 255 / 0.28)。
    • 箔面:一个 2px 的发光边框,radial-gradient(at the light, rgb(170 220 255 / 0.9), transparent 60%),遮罩在环上;不透明度 0.15 + on * 0.45。眩光不透明度 0.25 + on * 0.45。
    • 边缘色 rgb(26 42 138)。辉光色相 228。
  • Rainbow:随着倾斜滑动的彩色条纹。
    • 基础色:radial-gradient(130% 80% at 25% 0%, rgb(59 62 76), rgb(27 28 35) 62%)。油墨色 rgb(245 245 247)。
    • 箔面:repeating-linear-gradient(115deg, rgb(255 95 126) 0%, rgb(255 184 107) 2.6%, rgb(244 255 107) 5.2%, rgb(107 255 181) 7.8%, rgb(95 210 255) 10.4%, rgb(139 123 255) 13%, rgb(255 107 214) 15.6%, rgb(255 95 126) 18%),background-size 200%,background-position 位于光源处,在光栅 repeating-linear-gradient(125deg, transparent 0 2px, rgb(0 0 0 / 0.3) 2px 3px) 之下;mix-blend-mode color-dodge,filter brightness(0.72) saturate(1.25),不透明度 0.3 + on * 0.6,由 radial-gradient(farthest-corner at the light, rgb(0 0 0) 5%, rgb(0 0 0 / 0.16) 72%) 遮罩。
    • 边缘色 rgb(42 44 53)。辉光色相 285。
  • Pearl:白色卡片,带有柔和光泽,在边缘处最强,如同画框。
    • 基础色:linear-gradient(160deg, rgb(253 252 255), rgb(241 238 248))。油墨色 rgb(23 21 46)。
    • 箔面:linear-gradient(115deg, rgb(255 196 225) 0%, rgb(201 184 255) 12%, rgb(180 233 255) 24%, rgb(194 255 216) 36%, rgb(255 243 184) 48%, then the same again),background-size 260%,position 位于光源处,multiply,不透明度 0.7 + on * 0.3,由 radial-gradient(70% 60% at 50% 45%, rgb(0 0 0 / 0.35) 30%, rgb(0 0 0) 100%) 遮罩。
    • 眩光:soft-light,白色 90%,在 55% 处淡出,不透明度 0.5 + on * 0.5。边框:基础色 rgb(60 50 120 / 0.06),光源色白色 95%。
    • 边缘色 rgb(230 226 242)。辉光色相 300。
  • Sparkle:精细的闪光。
    • 基础色:radial-gradient(120% 80% at 75% 5%, rgb(40 51 106), rgb(16 20 43) 65%)。油墨色 rgb(238 240 255)。
    • 闪光:一个 240px 的图块,包含约 950 个点,半径 0.45 到 1.85px(大多很小),alpha 0.35 到 1,用作 alpha 遮罩。
    • 箔面,使用 screen 混合,两层,每层由闪光遮罩(第二层偏移 117px,71px)和 radial-gradient(at the light, rgb(0 0 0), rgb(0 0 0 / 0.3) 45%, rgb(0 0 0 / 0.12)) 遮罩: 第一层:repeating-linear-gradient(60deg, rgb(255 139 210) 0 3%, transparent 5% 8%, rgb(139 243 255) 10% 13%, transparent 15% 18%, rgb(255 243 139) 20% 23%, transparent 25% 28%),size 260%,position (lx * 1.6, ly); 第二层:repeating-linear-gradient(-35deg, rgb(169 139 255) 0 3%, transparent 5% 9%, rgb(139 255 196) 11% 14%, transparent 16% 20%, rgb(255 255 255) 22% 24%, transparent 26% 30%),size 260%,position (100% - lx, ly * 1.4)。 暗色间隙使每个闪光点在其自己的角度发光,然后熄灭。
    • 边缘色 rgb(26 32 72)。辉光色相 235。
  • Chrome:银色镜面,高光与倾斜方向相反移动。
    • 基础色:linear-gradient(125deg, rgb(228 230 234) 0%, rgb(141 147 158) 16%, rgb(246 247 249) 30%, rgb(124 130 141) 46%, rgb(217 220 225) 60%, rgb(148 154 165) 76%, rgb(241 242 244) 100%),background-size 220%,background-position (100% - lx, 100% - ly)。油墨色 rgb(27 29 36)。
    • 箔面:linear-gradient(115deg, rgb(255 143 199), rgb(255 226 143) 14%, rgb(149 255 208) 28%, rgb(143 214 255) 42%, rgb(192 155 255) 56%, then again),size 240%,position 位于光源处,overlay,不透明度 0.3 + on * 0.35。
    • 眩光:soft-light,白色 85%,30% 处 10%,95% 处黑色 18%。边框:基础色白色 18%,光源色白色 95%。印刷线条的蚀刻外观:text-shadow 0 -1px 0 rgb(60 64 76 / 0.55),0 1px 0 rgb(255 255 255 / 0.95)。
    • 边缘色 rgb(180 184 194)。辉光色相 200。
  • Etched:仅在光线下可见的图案。
    • 基础色:哑光 rgb(18 18 20),带有精细的同心环,repeating-radial-gradient(circle at the artwork's center, rgb(255 255 255 / 0.05) 0 1.2px, transparent 1.6px 7px)。油墨色 rgb(237 237 238)。
    • 箔面:linear-gradient(115deg, rgb(255 95 126), rgb(255 184 107) 10%, rgb(244 255 107) 20%, rgb(107 255 181) 30%, rgb(95 210 255) 40%, rgb(139 123 255) 50%, then again),size 300%,position 位于光源处,由相同的环和 radial-gradient(at the light, rgb(0 0 0), rgb(0 0 0 / 0.5) 18%, transparent 42%) 遮罩;不透明度 0.25 + on * 0.75。眩光不透明度 0.2 + on * 0.4。
    • 将图案窗口保持为简单的哑光面板(radial-gradient(70% 60% at 50% 35%, rgb(29 29 33), rgb(15 15 17))),以便环在窗口处停止。
    • 边缘色 rgb(27 27 30)。辉光色相 190。
  • 所有材质,除非另有说明,边框的基础色为 5% 白色,光源色为 50% 白色。文字在所有角度下保持清晰可读:检查其下方箔面的最亮和最暗时刻。
  1. 翻转(仅当选择时;标准值)
  • 点击(或轻触,或聚焦时的 Enter 和 Space 键)使卡片绕垂直轴旋转 180 度,使用弹簧(刚度 70,阻尼 11),因此在大约 0.8 秒内稳定,伴有微小过冲;再次点击则翻转回原位。
  • 翻转时,卡片向观看者提升:translateZ(|sin(angle)| * 40px);在侧视时,阴影宽度缩小最多 45%,并下降 14px。
  • 厚度 10px:正面位于卡片中间前方 5px,背面位于其后 5px,两者均旋转 180 度,backface-visibility hidden;两者之间是 10 份卡片轮廓,使用材质的边缘色,均匀分布。仅在翻转时绘制边缘。
  • 背面使用相同的材质、眩光和边框,光源镜像(lx 变为 100% - lx)。使用与正面相同的边距进行布局。
  • 任何改变正面的内容(另一种材质、新内容)都在卡片侧视时进行,因此永远不会看到切换过程。
  1. 图案内部的深度(标准值)
  • 为图案的每个部分赋予其自身在卡片正面之后的深度 d(负值:在卡片正面之前),并通过 d * sin(angle) 移动它:x = -d * sin(rotateY + turn),y = d * sin(rotateX)。这正是真实 3D 的效果。
  • 在演示中:其后的图片为 90px,指南针刻度盘为 50px,其中间环为 34px,虚线环为 20px,指针在正面之前 12px(-12);角落的印刷内容位于表面,不移动。绘制最底层时应比其窗口更大(每边 100px),以使其边缘永远不会显示。
  • 如果图案可以有响应,就让它响应:指南针指针朝向指针方向弹簧运动(加速度 = 60 * angle difference - 5.5 * velocity,选择短路径),空闲时漂移 12deg * sin(0.77t) + 6deg * sin(2.16t);刻度盘每秒旋转 9 度,虚线环每秒向相反方向旋转 18 度。小而慢,且只有一个移动元素。
  1. 节奏和可访问性
  • 悬停进入和离开、倾斜和光照是连续的;翻转在大约 0.8 秒内稳定。
  • 切换材质:在 420ms 内交叉淡入淡出正面,或在翻转期间于侧视时进行交换。
  • 减少动效:无倾斜、无摇晃、无翻转动画(翻转变为即时交换或 200ms 交叉淡入淡出);光照仍可跟随指针;背景保持静止。
  • 卡片保持其角色:链接或按钮保持原样,背面可通过键盘访问并宣告,没有重要内容仅在一个角度可见。
  1. 背景(仅当选择时)
  • 卡片后的辉光:radial-gradient(closest-side, hsl(<finish's hue> 85% 64% / 0.3), transparent),860px 宽,其不透明度 (0.04 + 0.12 * on) / 0.3。
  • 其后的缓慢流动流体:值噪声的 fBm(4 个八度,每个由矩阵 (1.6, 1.2; -1.2, 1.6) 旋转,振幅减半),扭曲两次:p = position / height * 1.25 + flow;q = (fbm(p), fbm(p + (5.2, 1.3) - flow.yx));r = (fbm(p + 3.5q + (1.7, 9.2) + 1.3 * flow), fbm(p + 3.5q + (8.3, 2.8) - flow));f = fbm(p + 3r)。Color = mix(a, b, clamp(2.4f²)),然后通过 clamp(0.95 * |q| - 0.35) 向 c 混合,乘以 0.5 + 1.1f²。使用 smoo...

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

kubai-book-cards

卡片在悬停或聚焦时像书一样翻开一定角度,显示里面的内页,静止时外观保持不变。提供普通卡片、拟物精装书和极简文档三种风格。适用于文档、知识库、作品集和模板市场(book hover cards)。

kubai-easing-curves

按使用场景为项目中的动画设置缓动曲线和时长:入场用 ease-out,离场用 ease-in,位置变化用 ease-in-out,小的确认反馈用 overshoot,拖动松手后用 spring,并统一为动效 token(easing, motion curves)。

kubai-liquid-glass

为图片、壁纸或视频上方的卡片和面板添加液态玻璃材质:背景模糊与提亮、边缘折射与色散、根据背景自动调整的着色和文字颜色,深色和浅色模式下文字都清晰可读,布局保持不变(liquid glass, glassmorphism)。

kubai-scroll-cards

改造现有长页面:选出值得讲的段落,用五种由滚动驱动的卡片交互呈现——层叠卡片(新卡片逐张盖住旧卡片,旧卡片缩小、变暗)、卡组飞出(顶部卡片向一侧甩出,下一张顶上来)、横向展廊(页面固定,纵向滚动推动横向作品集)、封面轮播(中间一张最大,两侧缩小、转开、变暗)、图片展开(小图铺满屏幕,标题从景物后升起形成景深)。效果全部由滚动位置驱动,读者控制节奏,回滚即倒放,不劫持滚动;尺寸按不同屏幕和视窗高度计算,手机工具栏不会挡住内容,矮屏自动退回普通段落。附多档预设,开始前逐项询问,由你选择或调整,确认后按现有技术栈实现(scroll-driven animation, sticky, cover flow, svh)。

関連スキル