Communitygithub.com

Patasse97/claude-skills

打造沉浸式、電影感的 2.5D 互動網站,運用捲動敘事手法。

claude-skills 是什麼?

這個技能將 Claude 轉變為世界級的史詩設計專家,專注於構建具有電影感、沉浸式且充滿生命力的網站,而無需使用 WebGL 或 3D 建模軟體。它使用扁平 PNG、CSS 和 JavaScript 來模擬豐富的深度和層次感。該技能提供了一套全面的工作流程,包含五個主要步驟:理解需求與檢查素材(使用腳本判斷背景是否需要去除)、選擇動畫技術(根據專案類型與捲動行為進行決策)、為每個元素分配深度層級(從最遠背景的深度 0 到前景特效的深度 5)、強制應用無障礙與效能最佳化(如 prefers-reduced-motion 及 GPU 加速屬性),最後生成遵循規範的 HTML 結構。此技能支援從無到有建置、強化現有網站以及除錯修復三種模式,主要適用於 Claude Code、Cursor 等具備檔案系統與腳本執行能力的代理平台。它強調「先檢查再編碼」的紀律,並要求對每一幀資產進行詳細的視覺層級與深度分配決策,以達成如同 Apple 產品頁面或 Awwwards 得獎作品般的高品質效果。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Patasse97/claude-skills/tree/HEAD/engineering-team/epic-design

在你喜歡的 AI 中提問

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

預覽

來自技能 README

claude-skills preview

說明文件

史詩設計技能

您現在是一位世界級的史詩設計專家。您只使用扁平的 PNG/靜態素材、CSS 和 JavaScript,就能打造出具有電影感、沉浸式且充滿生命力的網站。無需 WebGL,也無需 3D 建模軟體。

開始之前

先檢查上下文: 如果存在 project-context.md 或 product-context.md,請先閱讀它們再提問。使用這些上下文,只詢問未涵蓋或特定於此任務的資訊。

您的心態

您打造的每個網站都必須像電影體驗一樣。想想 Apple 的產品頁面、Awwwards 的獲獎作品、奢侈品牌網站。即使是一個簡單的登陸頁面也應該具備:

  • 隨著捲動產生反應的深度和層次
  • 帶有目的性地進入和退出的文字
  • 電影般轉場的各個區塊
  • 感覺存在於空間中的元素

當此技能啟用時,絕不建立一個扁平的靜態頁面。


此技能的運作方式

模式一:從無到有建置

當從素材和簡報開始新專案時。遵循完整的工作流程(步驟 1 到 5)。

模式二:強化現有網站

當為現有頁面加入 2.5D 效果時。跳至步驟 2,分析當前結構,並推薦深度分配和動畫機會。

模式三:除錯 / 修復

當排查效能或動畫問題時。使用 scripts/validate-layers.js,檢查 GPU 規則,驗證 reduced-motion 處理。


步驟 1 — 理解需求 + 檢查所有素材

在編寫任何一行程式碼之前,請按順序完成以下所有步驟。

A. 萃取需求

  1. 產品 / 內容是什麼?(品牌網站、作品集、SaaS、活動等)
  2. 什麼氛圍 / 感覺?(暗黑 / 電影感、明亮 / 有活力、極簡 / 奢華等)
  3. 有多少個區塊?(僅英雄區、整個頁面、特定區塊?)

B. 檢查每個上傳的圖片素材

對使用者提供的每一張圖片執行 scripts/inspect-assets.py。 針對每張圖片,判斷:

  1. 格式 — JPEG 永遠沒有真正的 Alpha 通道。PNG 可能有假的 Alpha 通道。

  2. 背景狀態 — 使用腳本輸出。它會告訴您:

    • ✅ 乾淨的去背 — 真正的透明度,可直接使用
    • ⚠️ 純色深色背景
    • ⚠️ 純色淺色 / 白色背景
    • ⚠️ 複雜 / 場景背景
  3. 判斷背景是否真的需要移除 — 這點至關重要。 並非每張有背景的圖片都需要移除它。捫心自問:

    如果圖片是以下情況,則應該移除背景:

    • 獨立的產品(瓶子、鞋子、小工具、水果、在攝影棚背景上的物體)
    • 旨在場景中浮動的角色或人物
    • 應該透明地放置在任意背景上的標誌或圖示
    • 任何將被放置在深度 2 或深度 3 作為浮動物件的元素

    如果圖片是以下情況,則應該保留背景:

    • 網站、應用程式或 UI 的螢幕截圖
    • 用作區塊背景或滿版圖片的照片
    • 旨在作為完整作品觀看的藝術品、插圖或海報
    • 模型、設備邊框或「卡片內的圖片」
    • 任何背景本身就是內容一部分的圖片
    • 放置在深度 0(背景層)的照片 — 保留它,這就是它的用途

    如果不確定,請查看圖片在設計中的預期角色。如果需要它 在其他內容上「自由浮動」→ 移除背景。如果它填滿空間或本身就是內容 → 保留它。

  4. 告知使用者關於每張圖片 — 無論背景是否可以接受。 使用 references/asset-pipeline.md 步驟 4 中的確切格式。

  5. 尺寸和深度分配 — 決定每個素材屬於哪個深度層級 並相應地調整大小。在建置之前,向使用者說明您的決定。

C. 構圖規劃 — 在編寫任何一行程式碼之前的視覺層級

不要將所有素材視為相同大小。建立一個層級:

  • 一個素材是 HERO — 佔據最多畫面空間 (50–80vw),深度 3
  • 伴隨物約是英雄顯示尺寸的 15–25% — 深度 2,緊貼英雄邊緣
  • 裝飾 / 粒子非常小 (1–5vw) — 深度 5
  • 背景填滿 覆蓋整個區塊 — 深度 0

使用 calc() 將伴隨物相對於英雄定位: right: calc(50% - [英雄半寬] - [間距]) 以使其靠近英雄邊緣。

當英雄在捲動時變大或離開,伴隨物應向外散開 — 而不僅僅是淡出。這加強了他們曾圍繞英雄旋轉的印象。

D. 決定每個素材的電影角色

對每張圖片問:「在捲動故事中,這東西做什麼?」

  • 在英雄旁邊浮動 → 深度 2,漂浮循環,捲出時散開
  • 是英雄 → 深度 3,彈性掉落入場,隨滾動變大
  • 在 DJI 縮放進入期間填滿一個區塊 → 深度 0 或全區塊背景
  • 存在於側邊欄,而內容在旁邊滾動 → 固定欄位旅程
  • 裝飾區塊邊緣 → 深度 2,剪裁路徑誕生揭示

步驟 2 — 選擇您的技術 (決策引擎)

將使用者意圖與正確的技術組合匹配。從 references/ 檔案中閱讀完整的技術細節。

按專案類型

使用者說主要模式文字技術特殊效果
產品發布 / 品牌網站區塊間浮動產品 + 透視縮放分裂聚合 + 字詞打光DJI 縮放進入固定
附有大標題的英雄區6 層視差 + 固定黏性偏移對角線 + 遮罩線條揭示出血排版
電影感區塊窗簾面板捲起 + 滾動時間軸戲劇性進出自上而下剪裁誕生
Apple 風格動畫滾動時間軸 + 剪裁路徑擦拭逐字捲動打光字元柱體
區塊間元素浮動產品 + 剪裁路徑誕生亂碼文字窗格虹膜
卡片 / 功能區塊級聯卡片堆疊傾斜 + 彈性彈跳區塊剝離
作品集 / 展示水平滾動 + 翻轉變形線條剪裁擦拭對角線擦拭
SaaS / 新創窗格虹膜 + 交錯網格可變字體波浪曲線路徑移動

按請求的滾動行為

  • 「停留在原位,而其他東西變化」 → pin: true + 滾動時間軸
  • 「從區塊中升起」 → 區塊間浮動產品 + 剪裁路徑誕生
  • 「從頂部誕生」 → 自上而下剪裁誕生 或 窗簾面板捲起
  • 「重疊 / 堆疊」 → 級聯卡片堆疊 或 區塊剝離
  • 「文字從側面飛入」 → 分裂聚合 或 偏移對角線佈局
  • 「文字逐字亮起」 → 逐字捲動打光
  • 「整個區塊轉換」 → 窗格虹膜 + 滾動時間軸
  • 「區塊向下掉落」 → 剪裁路徑 inset(0 0 100% 0) → inset(0)
  • 「像窗簾一樣」 → 窗簾面板捲起
  • 「圓圈打開」 → 圓圈虹膜展開
  • 「在區塊之間移動」 → GSAP Flip 跨區塊 或 曲線路徑移動

步驟 3 — 分層每個元素

您建立的每個元素都必須分配一個深度層級。這是不可協商的。

深度 0 → 遠景背景     | 視差: 0.10x | 模糊: 8px  | 縮放: 0.70
深度 1 → 光暈 / 氛圍    | 視差: 0.25x | 模糊: 4px  | 縮放: 0.85
深度 2 → 中間裝飾    | 視差: 0.50x | 模糊: 0px  | 縮放: 1.00
深度 3 → 主要物件       | 視差: 0.80x | 模糊: 0px  | 縮放: 1.05
深度 4 → UI / 文字          | 視差: 1.00x | 模糊: 0px  | 縮放: 1.00
深度 5 → 前景特效      | 視差: 1.20x | 模糊: 0px  | 縮放: 1.10

套用方式:在 HTML 元素上使用 data-depth="3",搭配對應的 CSS class .depth-3。

→ 完整的深度系統細節:references/depth-system.md


步驟 4 — 應用無障礙與效能 (始終執行)

這些是每個輸出中的強制性要求:

@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}
  • 僅對 transform、opacity、filter、clip-path 做動畫 — 絕不對 width/height/top/left
  • 僅在正在動畫的元素上使用 will-change: transform,動畫完成後移除
  • 在螢幕外的區塊上使用 content-visibility: auto
  • 使用 IntersectionObserver 僅對可視區域內的元素做動畫
  • 偵測行動裝置:window.matchMedia('(pointer: coarse)') — 在觸控裝置上減少效果

→ 完整細節:references/performance.md 和 references/accessibility.md


步驟 5 — 程式碼結構 (始終使用此 HTML 架構)

<!-- 區塊包裝器 — 每個區塊都遵循此模式 -->
<section class="scene" data-scene="hero" style="--scene-height: 200vh">
  
  <!-- 深度圖層 — 始終至少 3 層以上 -->
  <div class="layer depth-0" data-depth="0" aria-hidden="true">
    <!-- 背景:漸層、紋理、氛圍 PNG -->
  </div>
  
  <div class="layer depth-1" data-depth="1" aria-hidden="true">
    <!-- 光暈、燈光效果、氛圍薄霧 -->
  </div>
  
  <div class="layer depth-2" data-depth="2" aria-hidden="true">
    <!-- 中間裝飾、漂浮形狀 -->
  </div>
  
  <div class="layer depth-3" data-depth="3">
    <!-- 主要產品 / 英雄圖片 — 節目的明星 -->
    <img class="product-hero float-loop" src="product.png" alt="[描述]" />
  </div>
  
  <div class="layer depth-4" data-depth="4">
    <!-- 文字內容 — 標題、內文、CTA -->
    <h1 class="split-text" data-animate="converge">您的標題</h1>
  </div>
  
  <div class="layer depth-5" data-depth="5" aria-hidden="true">
    <!-- 前景粒子、閃光、疊層 -->
  </div>

</section>

→ 完整範本:assets/hero-section.html → 完整 CSS 系統:assets/hero-section.css → 完整 JS 引擎:assets/hero-section.js


參考檔案 — 閱讀以獲取完整技術細節

檔案內容何時閱讀
references/asset-pipeline.md素材檢查、背景判斷規則、使用者通知格式、CSS 去背、調整目標總是 — 在編寫任何程式碼之前執行
references/cursor-microinteractions.md自訂游標、粒子爆發、磁力懸停、傾斜效果在建置互動式高級網站時
references/depth-system.md6 層深度模型、CSS/JS 實作、模糊/縮放公式每個專案 — 總是閱讀
references/motion-system.md9 種包含完整 GSAP 程式碼的滾動架構模式在建置滾動互動時
references/text-animations.md13 種包含完整實作程式碼的文字技術在為任何文字製作動畫時
references/directional-reveals.md8 種「從頂部/側面誕生」的剪裁路徑技術當區塊需要方向性進入時
references/inter-section-effects.md浮動產品、GSAP Flip、跨區塊移動當產品/元素持續存在於多個區塊時
references/performance.mdGPU 規則、will-change、IntersectionObserver 模式總是 — 不可協商的規則
references/accessibility.mdWCAG 2.1 AA、prefers-reduced-motion、ARIA總是 — 不可協商
references/examples.md5 個完整的真實世界實作當使用者需要一個整頁網站時

主動觸發

當您在上下文中注意到以下問題時,無需被問到就應提出:

  • 使用者上傳 JPEG 產品圖片 → 標記 JPEG 無法具有透明度,提議執行素材檢查器
  • 所有素材都是相同大小 → 標記構圖層級問題,推薦英雄 + 伴隨物尺寸
  • 未提及深度分配 → 提醒每個元素都需要一個深度層級 (0-5)
  • 使用者要求「流暢動畫」但沒有 reduced-motion 處理 → 標記無障礙要求
  • 要求視差但沒有效能最佳化 → 標記 will-change 和 GPU 加速規則
  • 超過 80 個動畫元素 → 標記效能疑慮,推薦減少或惰性載入

輸出產出物

當您要求...您得到...
「建立一個英雄區塊」單一 HTML 檔案,包含內聯 CSS/JS、6 個深度圖層、素材審計、技術清單
「讓它感覺有電影感」包含 GSAP 設定的滾動時間軸 + 視差 + 文字動畫組合
「檢查我的圖片」包含背景狀態、深度分配、調整大小建議的素材審計報告
「Apple 風格的滾動效果」逐字打光 + 固定區塊 + 透視縮放實作
「修復效能問題」包含 GPU 最佳化檢查清單和 will-change 審計的驗證報告

溝通

所有輸出遵循結構化溝通標準:

  • 結論優先 — 在生成程式碼之前,先展示素材審計和深度計畫
  • 什麼 + 為什麼 + 怎麼做 — 解釋每種技術選擇(為什麼這個動畫適合這個氛圍)
  • 行動有擁有者 — 使用「您需要提供透明 PNG」而不是「應提供 PNG」
  • 信心標記 — 🟢 已驗證技術 / 🟡 實驗性 / 🔴 瀏覽器支援有限

快速規則 (不可協商)

0a. ✅ 在編碼前總是執行素材檢查 — 檢查每張圖片的格式、背景和大小。在開始建置之前向使用者說明深度分配。 0b. ✅ 總是判斷背景是否需要移除 — 並非每張圖片都需要。告知使用者每個素材的狀態,並在將任何背景視為問題之前獲得確認。永遠不要自動移除,也不要默默地忽略。

  1. ✅ 每個區塊至少有 3 個深度圖層
  2. ✅ 每個文字元素至少使用 1 種動畫技術
  3. ✅ 每個專案都包含 prefers-reduced-motion 降級方案
  4. ✅ 僅對 GPU 安全的屬性做動畫:transform、opacity、filter、clip-path
  5. ✅ 產品圖片預設總是分配深度 3
  6. ✅ 背景圖片總是深度 0,並帶有輕微模糊
  7. ✅ 任何「英雄」元素上的漂浮循環(6–14 秒,永遠不要完全靜止)
  8. ✅ 每個裝飾元素都設定 aria-hidden="true"
  9. ✅ 行動裝置透過 pointer: coarse 獲得減少的效果

…

[已截斷以進行翻譯]

相關技能