Communitygithub.com

Rohithdgrr/REEK-uninstaller

使用捲動敘事、視差深度、文字動畫與高階捲動效果,打造沉浸式電影級 2.5D 互動網站 — 無需 WebGL。

REEK-uninstaller 是什麼?

此技能專為打造具有電影級敘事感的 2.5D 互動網站而設計,無需使用 WebGL 或 3D 建模軟體。核心工作流程包含五個步驟:先透過腳本檢查資產(格式、背景透明度與深度層級),接著根據使用者意圖選擇適當的動畫技術組合(如 Apple 風格捲動、浮動產品、多層視差等),然後為每個元素強制指定 0 到 5 的深度層級。此技能整合了 45 種以上的技術,涵蓋 8 大類別,包括文字動畫、方向揭示、區塊間特效與 GSAP 時間軸等。除了生成程式碼外,它還會自動檢查無障礙(prefers-reduced-motion)、效能(GPU 屬性、will-change 最佳化)及行動裝置相容性。所有輸出均以單一自包含的 HTML 檔案形式呈現,內嵌 CSS 與 JS,並導入 GSAP CDN。支援 Claude Code、Cursor 與 Codex 等 AI 代理平台,適用於產品頁面、品牌網站、英雄區塊或任何需要高階捲動動畫的場景。

相容平台~Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/Rohithdgrr/REEK-uninstaller/tree/HEAD/.opencode/skills/epic-design

在你喜歡的 AI 中提問

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

預覽

來自技能 README

REEK-uninstaller preview

說明文件

史詩級設計技能

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

開始之前

先檢查上下文: 如果 project-context.md 或 product-context.md 存在,請先讀取,然後再提問。利用那些上下文,只針對尚未涵蓋或特定於此任務的資訊提問。

你的心態

你建立的每個網站都必須感覺像一場電影體驗。想像:Apple 產品頁面、Awwwards 獲獎作品、奢侈品牌網站。即使是一個簡單的登陸頁面,也應該具備:

  • 隨捲動而反應的深度與層次
  • 帶有目的地進出畫面的文字
  • 電影般轉場的區塊
  • 彷彿存在於空間中的元素

在此技能啟用時,切勿建立平面、靜態的頁面。


技能運作方式

模式 1:從頭開始建置

當開始新的專案並擁有素材與簡報時。請遵循以下完整工作流程(步驟 1-5)。

模式 2:強化現有網站

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

模式 3:除錯/修復

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


步驟 1 — 了解簡報 + 檢查所有素材

在撰寫任何一行程式碼之前,請按順序執行以下所有操作。

A. 提取簡報

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

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

對使用者提供的每張圖片執行 scripts/inspect-assets.py。

可選執行時期相依性: pip install Pillow — 圖片分析所需的套件,--help 則不需要。 對於每張圖片,確定:

  1. 格式 — JPEG 從未有真正的 Alpha 通道。PNG 可能有假的。

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

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

    背景該清除,如果圖片是:

    • 一個孤立的產品(瓶子、鞋子、小工具、水果、在攝影棚背景上的物體)
    • 一個角色或人物,預計要漂浮在場景中
    • 一個標誌或圖示,應透明地放在任何背景上
    • 任何預計被放置在 depth-2 或 depth-3 作為漂浮元素的元素

    背景該保留,如果圖片是:

    • 網站、應用程式或 UI 的螢幕截圖
    • 用作區塊背景或滿版出血的圖片
    • 一件藝術品、插圖或需要被視為完整作品的海報
    • 一個模型、設備框架或「卡片內的圖片」
    • 任何背景本身就是內容一部分的圖片
    • 一張被放在 depth-0(背景層)的照片 — 保留它,那是它的用途

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

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

  5. 尺寸與深度分配 — 決定每個素材屬於哪個深度層級, 並相應調整大小。在開始建置之前,將你的決定告訴使用者。

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

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

  • 一個素材是主角 — 佔據最多螢幕空間 (50–80vw),depth-3
  • 陪襯素材是主角顯示尺寸的 15–25% — depth-2,貼近主角邊緣
  • 裝飾/粒子元素非常小 (1–5vw) — depth-5
  • 背景填充 覆蓋整個區塊 — depth-0

使用 calc() 來定位陪襯素材相對於主角的位置: right: calc(50% - [主角半寬] - [間距]) 使其貼近邊緣。

當主角在捲動時變大或退出時,陪襯素材應向外散射 — 而不僅僅是淡出。這強化了它們原本環繞主角的意象。

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

對於每張圖片,問:「它在捲動故事中扮演什麼角色?」

  • 漂浮在主角旁 → depth-2, float-loop, 在捲出時散射
  • 是主角本身 → depth-3, 彈性掉落進場, 在時間軸上變大
  • 在 DJI 縮放進場期間填充一個區塊 → depth-0 或全區塊背景
  • 存在於側邊欄中,而內容在其旁邊捲動 → 固定的欄位旅程
  • 裝飾區塊邊緣 → depth-2, clip-path 出生揭示

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

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

依專案類型

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

依請求的捲動行為

  • 「停留在原位,而東西改變」 → pin: true + 時間軸
  • 「從區塊中升起」 → 區塊間漂浮產品 + clip-path 出生
  • 「從頂部生成」 → 自上而下剪輯出生 或 簾幕面板捲起
  • 「重疊/堆疊」 → 層疊卡片堆疊 或 區塊剝離
  • 「文字從側邊飛入」 → 分裂聚合 或 偏移對角線佈局
  • 「文字逐詞點亮」 → 逐詞捲動點亮
  • 「整個區塊轉換」 → 窗格虹膜 + 時間軸
  • 「區塊落下」 → Clip-path inset(0 0 100% 0) → inset(0)
  • 「像簾幕一樣」 → 簾幕面板捲起
  • 「圓圈打開」 → 圓形虹膜展開
  • 「在區塊間移動」 → GSAP Flip 跨區塊 或 曲線路徑移動

步驟 3 — 分層每個元素

你建立的每個元素都必須分配一個深度層級。這點沒得商量。

DEPTH 0 → 遠景背景     | parallax: 0.10x | blur: 8px  | scale: 0.70
DEPTH 1 → 發光/大氣     | parallax: 0.25x | blur: 4px  | scale: 0.85
DEPTH 2 → 中間裝飾     | parallax: 0.50x | blur: 0px  | scale: 1.00
DEPTH 3 → 主要物件       | parallax: 0.80x | blur: 0px  | scale: 1.05
DEPTH 4 → UI / 文字          | parallax: 1.00x | blur: 0px  | scale: 1.00
DEPTH 5 → 前景特效      | parallax: 1.20x | blur: 0px  | scale: 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">
    <!-- 文字內容 — 標題、內文、行動呼籲按鈕 -->
    <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/depth-system.md6 層深度模型、CSS/JS 實作、模糊/縮放公式每個專案 — 總是閱讀
references/motion-system.md9 種捲動架構模式及完整 GSAP 程式碼在建置捲動互動時
references/text-animations.md13 種文字技術及完整實作程式碼在動畫化任何文字時
references/directional-reveals.md8 種「從頂部/側邊生成」的 clip-path 技術當區塊需要定向進場時
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. ✅ 產品圖片預設分配 depth-3
  6. ✅ 背景圖片總是 depth-0 並加上輕微模糊
  7. ✅ 任何「主角」元素上都套用漂浮循環(6–14 秒,絕不靜止)
  8. ✅ 每個裝飾元素都加上 aria-hidden="true"
  9. ✅ 行動裝置透過 pointer: coarse 偵測獲得減少的效果
  10. ✅ 動畫完成後移除 will-change

輸出格式

總是提供:

  1. 單一自包含的 HTML 檔案(內嵌 CSS + JS),除非使用者要求分離的檔案
  2. 透過 jsDelivr 引入 GSAP CDN

…

[為翻譯而截斷]

相關技能