Communitygithub.com

kubai-book-cards

卡片在懸停或聚焦時像書一樣翻開一定角度,顯示裡面的內頁;靜止時外觀保持不變。提供普通卡片、擬物精裝書及極簡文件三種風格。

kubai-book-cards 是什麼?

kubai-book-cards 是一個為 AI 代理(如 Claude Code、Cursor、Codex)設計的技能,用來改造使用者產品中的卡片元件。當滑鼠懸停或鍵盤聚焦時,卡片會像書本一樣翻開,露出內頁,而靜止時完全保持原有外觀。該技能提供三種風格:預設的普通卡片、擬物精裝書(skeuomorphic hardcover)以及極簡文件(minimal documentation),並支援多種選項,例如翻開角度、頁數、鉸鏈方向(左、右、上)、觸發方式等。它詳細說明了圖層疊加順序(封面、頁面、背板)、基於彈簧的動畫、光線與陰影計算、圓角處理、無障礙設計(確保頁面不影響 accessibility tree)以及效能最佳化(僅動畫 transform 與 opacity、使用 requestAnimationFrame 統一管理)。這個技能特別適合文件、知識庫、作品集和模板市場等場景,讓產品在互動時更有質感。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/kubai087/vibedesign-skills/tree/HEAD/skills/kubai-book-cards

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

懸停時像書一樣翻開的卡片

《999 個小技巧,讓你的 Vibe 產品更有質感》第 006 期 · @kubai087

在使用者的專案裡按下面的要求改造。要求以使用者的口吻寫成:文中的 I、me、my 指使用者;寫著要先問的地方,先停下來問使用者再繼續。

改造要求

Make the cards in my product open a little, like a book, when hovered. At rest a card must look exactly as it does today; only hover or focus reveals that it is a small book with pages inside.

0. 從現有內容開始

  • 找出我命名的卡片元件(或我在格線/列表中指定的那個),就地改裝。重複使用它的標記、設計 token、圓角、陰影以及動畫或彈簧工具。
  • 保持卡片的 footprint、內距、內容和版面不變。卡片周圍不能有任何移動。
  • 如果我要求建立新卡片,則按照下方選擇的風格建立一個全新的方形卡片(約 280 x 280)。
  • 任何我未設定的選項都使用標記 * 的預設值。

1. 選擇風格

預設*:普通產品卡片,懸停前與一般卡片完全相同。

  • 表面:純白色(或我的卡片表面 token),無紋理。
  • 邊緣:1px 的細線,使用我的邊框顏色。
  • 陰影:淺色、中性冷灰色,強度減半。
  • 字體:產品的無襯線字體。標題 24/600,說明 15 柔和,元資料 14 柔和。
  • 封面:現有卡片 UI:一個 48px 的圖示方塊,右上角一個 ↗ 箭頭,標題,說明,以及一條細線分隔線下方的元資料頁尾。
  • 牆面:我的正常頁面背景。
  • 內頁:白色,靠近書脊處帶有微弱的色調,一個小標題和 4-6 行灰色文字。

擬物精裝書:畫廊牆上的精裝書。

  • 表面:細緻的書皮布紋理,覆蓋深邃的封面顏色。
  • 邊緣:帶有光澤的斜角:頂部邊緣明亮,底部邊緣較暗。
  • 陰影:暖色、近乎中性的灰色(絕不是橘色),全強度。
  • 字體:左下角一個襯線字體標題。封面上沒有其他內容。
  • 封面:滿版圖片或動態 ASCII 場景,頂部有柔和光澤,底部有陰影。
  • 牆面:暖色灰泥,帶有細微紋理,每本書上方有一盞聚光燈。
  • 內頁:奶油色紙張帶有紋理,斜體章節標題,左右對齊的文字行,以及書口處的薄書頁邊緣。

極簡:文件卷宗。

  • 表面:純色灰白、淺灰或石墨色,每張卡片一個色調。
  • 邊緣:微弱的斜角或細線。
  • 陰影:冷色中性灰色。
  • 字體:頂部是等寬字體的章節編號和版本,下方有一條細線分隔;兩行的無襯線字體標題,以及底部一個小的灰色標籤。
  • 封面:一個小的灰色線條圖,其中一個元素使用墨水色。
  • 牆面:冷灰色,帶有微弱的 24px 點狀網格和來自上方的柔和光線。
  • 內頁:冷白色,無襯線字體的標題和灰色文字行。

符合我的產品:從我的 token 中獲取表面、邊緣、陰影、字體和牆面,並保持封面與現在的卡片完全相同。

2. 選項(預設值標記 *)

  • 強度:輕微 (A = 24deg) | 書本* (A = 42deg) | 戲劇性 (A = 60deg)。
  • 頁數:2 | 3 | 4* | 6。
  • 鉸鏈:左* | 右 | 上。
  • 觸發方式:懸停* | 按壓(按住時打開) | 滾動到視野(在 60% 可見時打開一次,約 1.2 秒後關閉)。鍵盤聚焦也始終會打開它。
  • 內頁顯示:空白紙張 | 文字行* | 來自卡片的真實預覽內容(其下一個欄位、短列表、圖表縮圖)。
  • 封面:現有卡片 UI* | 圖片 | 動態 ASCII 場景 | 純色。
  • 陰影方向:從上方* | 從左上角。
  • 陰影強度:無 | 淺 | 正常* | 深。
  • 圓角:符合我的 token* | 連續(超橢圓)。
  • 動畫感覺:乾脆 (k 320, 阻尼 0.9) | 預設* (k 240, 阻尼 0.86) | 柔和 (k 160, 阻尼 0.8)。全部幾乎不 overshoot。
  • 減少動畫:微幅上浮* | 無。
  • 觸控:按壓* | 滾動到視野 | 關閉。

3. 圖層堆疊

  • 在卡片的連結內部,將封面放在一個帶有 transform-style: preserve-3d 的 body 元素上。在其後方堆疊 N 個頁面和一個背板,全部使用絕對定位在相同的正方形上。
  • 順序,從前到後:封面 (n = 0),頁面 (n = 1..N),背板 (n = N + 1,永不移動)。
  • 封面保留卡片的所有現有內容。頁面和背板僅是裝飾用途:aria-hidden,沒有連結,沒有 tab 停駐點。
  • 靜態外層元素的 perspective:約 1100px,原點朝向鉸鏈(左鉸鏈為 30% 50%,右鉸鏈為 70% 50%,上鉸鏈為 50% 30%)。
  • 每一層鉸鏈邊的 transform-origin:左為 left 0 50%,右為 right 100% 50%,上為 top 50% 0。backface-visibility: hidden。
  • 使用 translateZ((N + 1 - n) x 0.6px) 提升第 n 層,使各層在深度上不會互相干擾。
  • 頁面位於封面內側 8px 處(書脊處為 4px),如同書芯,圓角 = 封面圓角 - 8。
  • 背板:在平面卡片(預設、極簡)上,從封面內縮約 6px,圓角 = 封面圓角 - 6,這樣它永遠不會從封面透視縮短的角落露出。在擬物風格中,它與封面齊平,封面顏色加深約 28%。

4. 動畫

  • 第 n 層向觀看者旋轉的角度為 angle(n) = A x 0.7^n 並在 delay(n) = 28ms x n 後開始。封面領先;頁面在它後面展開。
  • 方向:左鉸鏈為 rotateY(-angle),右鉸鏈為 rotateY(+angle),上鉸鏈為 rotateX(+angle)。
  • 每一層使用自己的彈簧(參見動畫感覺),約在 0.3 秒內穩定。
  • 反向關閉:最內層頁面首先關閉,延遲 = 28ms x (N - n),回到 0deg。
  • 如果滑鼠中途離開,從當前角度和速度重新定位。絕不跳躍。
  • 專案中沒有彈簧工具?使用 CSS transition 即可:transition transform 約 420ms,帶有輕微 overshoot,例如 cubic-bezier(0.3, 1.2, 0.5, 1),並在打開狀態下設置 transition-delay 為 28ms x n,在靜止狀態下設置為 28ms x (N - n)(目標狀態的延遲生效,因此關閉反向執行)。

5. 光線與陰影

  • 光線來自上方,因此陰影沿牆壁向下投射。
  • 陰影是卡片後方的兩個實心形狀,每個模糊一次。靜止時它緊貼卡片,就像任何平面卡片一樣:
    • 接觸陰影:較小且顏色較深,位於底部。卡片下半部,每側內縮約 4px,模糊約 4px,向下約 2px,不透明度約 22%。
    • 環境陰影:微弱。模糊約 14px,向下約 6px,不透明度約 12%。
  • 絕不使用 box-shadow:它是一個空心環,一旦封面旋轉開來就會顯示為輪廓。
  • 色調:接近中性的灰色,向牆壁方向偏移(暖色牆壁用暖灰色,冷色牆壁用冷灰色)。絕不純黑色,絕不飽和。
  • 強度按比例調整兩個不透明度:light 0.5(預設風格),normal 1,deep 1.4。
  • 打開時:交叉淡入到第二組預先模糊的陰影,該組更長更柔和(接觸陰影模糊約 12px,向下 12px;環境陰影模糊約 38px,向下 26px),並使用 transform 將其向下移動約 14px 並放大約 4%。使用一個進度值 o (0..1) 在其自身的彈簧 (k 200, 阻尼 0.9) 上驅動它:靜止組合的不透明度為 1 - o,打開組合的不透明度為 o。
  • 書頁陰影:每個頁面都有一個從書脊開始的漸層疊加層(32% 暗 -> 在 55% 處為 8% -> 在 85% 處為 0)。其不透明度為 clamp(gap / 6, 0, 1) x max(0, 1 - gap / 30) 其中 gap = 前一葉片的旋轉角度減去此葉片的角度。當前面的葉片剛剛脫離該頁面時,頁面被陰影覆蓋;一旦它們分開,頁面就被照亮。
  • 封面(擬物、極簡):頂部邊緣有柔和光澤,底部有一點陰影。

6. 圓角與邊緣

  • 將每一層(封面、頁面、背板)裁剪為一個形狀路徑,並沿著該精確路徑繪製其邊緣(細線或斜角),例如在圖層上描繪 SVG 路徑。不要將 CSS 邊框或 inset box-shadow 與 clip 混用:它們在角落不一致,並且在圖層分開時會顯示第二個邊框。
  • 符合我的 token:使用 token 圓角;嵌套圓角 = 外層圓角 - 內縮量。
  • 連續:超橢圓角落 |x|^n + |y|^n = 1,其中 n = 2^1.25(與 CSS corner-shape: superellipse(1.25) 相同的曲線)。根據圖層大小生成 clip-path: path(...),重複用於邊緣,並在調整大小時重新生成。

7. 互動與無障礙設計

  • 點擊測試在靜止的 footprint 上進行:監聽靜態外層元素的 hover,並為所有移動中的圖層設置 pointer-events: none,這樣旋轉的封面永遠不會移動目標,卡片也絕不會在邊緣處閃爍打開和關閉。
  • 游標:整個卡片上顯示為手指指針。
  • 整個卡片保持為一個 或 ,並帶有其當前的 accessible name。頁面不會向無障礙樹添加任何內容。
  • :focus-visible 會像 hover 一樣打開它。將焦點環保持在外部元素上,沿著靜止形狀。
  • 減少動畫:沒有展開和旋轉。封面向上浮起約 2px,陰影交叉淡入到打開組合。
  • 觸控:沒有 hover。使用 Touch 選項;輕觸必須在第一次嘗試時就啟動卡片。

8. 效能

  • 僅對 transform 和 opacity 進行動畫。永遠不要對 blur、box-shadow、clip-path、width、height 或 top/left 進行動畫。
  • 永遠不要對模糊半徑進行動畫:一次性模糊每個陰影,然後交叉淡入兩個預先模糊的版本。
  • 所有卡片共用一個 requestAnimationFrame 循環。跳過彈簧已靜止的卡片,並在沒有物件移動時停止循環。
  • 僅在值發生變化時才寫入樣式(快取每個元素的最後一個字串)。
  • 每幀不讀取版面:測量一次,並在調整大小時再次測量(ResizeObserver)。
  • 動態畫布封面:最多以約 30fps 繪製,並在離開畫面(IntersectionObserver)或標籤頁隱藏時暫停。

9. 動態 ASCII 封面(僅在選擇時)

  • 將一個小場景繪製為每個字元儲存格(約 6 x 9px)的一種顏色。
  • 根據亮度從 " .:-=+*#%@" 中選取每個字元。
  • 在下方繪製顏色的暗淡副本(約 40%),並在上方繪製彩色字元,這樣間隙看起來就像網點。
  • 從預渲染的字形圖集中印出字元,而不是每幀都進行文字排版。保持動畫緩慢且無縫循環。

10. 完成後

  • 列出你更改或新增的每個檔案。
  • 列出你使用的風格和每個選項,並標記哪些是預設值。
  • 註明任何在靜止狀態下看起來不再相同的內容。

Individual skills in this repo

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

kubai-easing-curves

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

kubai-holo-card

把产品里代表身份或收藏的卡片(会员卡、门票、徽章、个人卡片)改成镭射卡片:卡片朝指针方向 3D 倾斜,镭射与高光随光线移动,内部图案按深度产生视差,静止时轻微晃动,点击可翻到背面并显示厚度。附 Prism、Rainbow、Pearl、Sparkle、Chrome、Etched 六种材质的推荐参数,以及手感、厚度、翻转和层次的几档预设。开始前逐项询问,每项给出推荐值,由你选择或调整,确认后再按现有技术栈改造(holographic card, foil, 3D tilt, parallax)。

kubai-liquid-glass

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

kubai-scroll-cards

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

相關技能