Communitygithub.com

超站點 (Ultra Site)

教導 AI 代理如何以藝術指導方式建造「超站點」,產出具體的 Logo 與小型品牌化妝表。此流程涵蓋超站點、不讓步原則、工作流程。在新任務需要此工藝時使用。

超站點 (Ultra Site) 是什麼?

這個技能「超站點 (Ultra Site)」旨在引導 AI 代理(如 Claude Code、Cursor 等)創建類似大型公司旗艦登陸頁面的高品質網站。其核心原則在於使用真實的資產與誠實的數據,拒絕虛構素材。技能詳細說明了六項不可協商的規則,包括僅使用真實的 3D 資產(如來自 Poly Haven 的 CC0 模型)、單一 Canvas 搭配多個場景的滾動觸發、每個區塊都作為全螢幕英雄區、語義化的動畫(每個動詞效果都需有原因說明)、以瀏覽器測量或 API 即時獲取的數據代替虛構聲明,以及最終部署到 GitHub Pages 的完整流程。工作流程則從概念發想、資產搜集、專案建置(使用 Vite + Three.js + GSAP 等技術棧)、語義文字處理,到 QA 與部署,步驟明確。此技能適用於任何需要產出令人驚豔、富有敘事性且技術紮實的展示型網站的任務,確保成果不僅美觀,更經得起檢驗。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ArfatArfart/ultra-site-skill/tree/HEAD/ultra-site

在你喜歡的 AI 中提問

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

說明文件

超站點 (Ultra Site) 是做什麼的?

此技能用於建立一個看起來像大型公司旗艦登陸頁面的網站,且僅使用真實資產與誠實數據。參考建置為 ARFORGE (https://github.com/ArfatArfart/arforge,線上版本:https://arfatarfart.github.io/arforge/)。若下方任何步驟需要可運作程式碼,請閱讀其原始碼。

不讓步原則

  1. 僅使用真實 3D 資產。 永遠不要用基本幾何體建模「假的」英雄物件。請使用攝影掃描的 CC0 模型 (Poly Haven)、真實 HDRIs、真實 NASA 紋理、真實標誌 (Simple Icons)、客戶自身即時作品的真實截圖。在頁尾註明每個來源。
  2. 一個舞台,多個鏡頭。 一個固定的 <canvas> 置於頁面後方。每個區段宣告 data-shot 與 data-theme。滾動位置轉換為浮點數 (例如 2.4 表示從鏡頭 2 到鏡頭 3 的 40%)。
  3. 每個區段都是英雄。 全視區、展示型、擁有自己的主題、自己的 3D 時刻。頁尾也包含在內。
  4. 語義動畫。 每個動態文字的移動方式都如字義所示。每個效果儲存一句原因說明。提供「為什麼」模式 (W 鍵),將這些原因釘選在螢幕上。
  5. 以證據取代主張。 永遠不要發明統計數據、客戶或推薦信。顯示瀏覽器測量的數字 (fps、幀時間、繪製點數、繪製呼叫次數、字節數、首幀時間) 以及即時獲取的數據 (GitHub 倉庫、API 延遲)。
  6. 部署它。 Vite 建置時 base 設為倉庫路徑、包含 GitHub Actions Pages 工作流程、建立倉庫並啟用 Pages,以及確認有效的線上 URL。

工作流程

  1. 概念 (5 分鐘,除非卡住否則不發問)。 選擇一個工作室名稱和一個可用於所有視覺決策的隱喻 (例如 ARFORGE:一座鍛造爐,因此溶解效果像熾熱金屬般發光,流程步驟是鎚擊,火星升起)。用小寫寫文案,無填充詞彙,句子內無連字號。
  2. 搜集資產。 遵循 references/real-assets.md。查詢 Poly Haven API,下載 1k (英雄物件用 2k) 的 glTF,使用 gltf-transform (meshopt + WebP) 壓縮,檢查邊界,渲染 Blender 縮圖以了解每個模型的方向。使用無頭 Edge 或 Chrome 截取客戶即時專案的螢幕截圖。
  3. 建立專案骨架。 Vite + three + gsap (所有外掛皆免費:SplitText, ScrambleText, ScrollTrigger) + lenis + @fontsource-variable/geist。一份樣式表定義 tokens,以 GSAP 緩動的 CSS 變數定義十一個主題。
  4. 建置舞台。 遵循 references/stage-architecture.md:從真實網格取樣的形態場、修補到真實 PBR 材質上的鍛造溶解效果、為沒有物件的區段建立程序化鏡頭、火星、火花、帶有真實子太陽點的地球。
  5. 建置區段。 英雄區 (英雄物件上的掃描著色器、顯示真實網格數據的 HUD)、標語揭示區、三個服務章節 (每個都有真實物件與互動證明:即時 Canvas 畫面、可拖曳手機示範、真實請求的終端機)、帶有衝擊效果的固定流程區、即時作品網格、可拖曳技術球體、即時指標區、常見問題區、頁尾英雄區 (包含地球與熱感文字)。
  6. 語義文字。 使用 references/semantic-motion.md 中的目錄。每個標題至少應用兩種效果;永遠不要在一個標題內重複使用同一種效果。
  7. 在瀏覽器窗格中進行 QA。 檢查桌面版與行動預設模式、閱讀主控台錯誤、確認在 375px 寬度下無水平溢出。隱藏的瀏覽器窗格會限制 requestAnimationFrame 的幀率,因此那裡出現緩慢的過場動畫不是錯誤。
  8. 部署。 見 references/deploy.md。建立倉庫、啟用 Pages 並設定 build_type=workflow、推送、等待執行完畢、開啟線上 URL 並再次檢查主控台。

品質標準

  • 英雄標題需可閱讀 (在 3D 物件上疊加時,使用文字陰影或佈局間距)。
  • 動畫使用 cubic-bezier(0.22, 1, 0.36, 1) 或 GSAP 的 expo/elastic,UI 部分永遠不要用 linear。
  • prefers-reduced-motion 應將所有效果轉為淡入淡出並停用平滑滾動。
  • 適應性像素比:當 fps 持續低於 40 時,降低 DPR。
  • 跳過連結、焦點環、分割文字上的 aria 標籤、截圖的替代文字、隱私與條款對話框、品牌化 404 頁面、從真實英雄物件渲染的 OG 圖片。
  • 行動版:3D 內容佔據視區頂部,文案則放在下方的毛玻璃卡片上。

相關技能