Communitygithub.com

Moat → 3D 登陸頁面

構建一個滾動驅動的 3D 登陸頁面,基於公司網站或「護城河」:包括研究、敘事、色彩、可識別的 3D 主角、靜態圖、動畫、SEO 資料、轉換追蹤,以及桌面與手機截圖 QA。一份內容檔案驅動共用的引擎,讓每個客戶頁面保持獨特。

Moat → 3D 登陸頁面 是什麼?

此技能旨在將一家公司(其現有網站或一句「護城河」陳述)轉化為一個完整、正在運行、且經過截圖驗證的登陸頁面。引擎本身已封裝在 `template/` 目錄中;對於每個客戶,開發者只需編寫一個名為 `src/content.js` 的檔案,產生所需的圖像,並進行驗證。對引擎的任何改進都會被回饋到 `template/` 中,確保下一個客戶也能受益。 此技能適用於 Claude Code、Cursor 或 Codex 等 AI 代理平台,提供了一個結構化的流程,從客戶資料研究和敘事策略開始,經由美術指導(色彩、字型、燈光)和圖像生成(使用 Gemini API 產生照片或自製主角渲染圖),最後到基於 Three.js/WebGL 的實際頁面構建。工作流程的每個階段都包含嚴格的驗證步驟(如預算檢查、SEO 檢查、回應式設計檢查),並產生一份詳細的手動交接文件,其中說明客戶仍需提供的內容以及未來的升級方向。 其核心設計理念是「一秒可識別性」:首先建立真實的物件或場景,然後再將其「解剖」以進行說明。其他重要規則包括:不使用光暈效果(Bloom = 0)、卡牌文字不疊在複雜紋理上、以及絕不發送包含佔位符或虛假資料的成品。此技能也支援多頁面網站,允許為原始網站的每個頁面建立子頁面,並保留其原始 URL。

相容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/thisisshivamtiwari/3d-landing-pages-skill/tree/HEAD/moat-landing

在你喜歡的 AI 中提問

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

說明文件

Moat → 3D 登陸頁面 是做什麼的?

你將一家公司(其現有網站,或一句護城河陳述)轉化為一個完整、正在運行、且經過截圖驗證的登陸頁面。引擎已寫好(template/);每個客戶你需要編寫一個檔案,即 src/content.js,產生圖像,並進行驗證。對引擎的改進會被回饋到 template/ 中,這樣每個下一個客戶都能獲得這些改進。

視需要閱讀(全部位於 references/): intake.md 研究客戶 · narrative.md 護城河 → 故事 → 文案 · art-direction.md 色彩理論、字型、燈光、可讀性 · scenes.md 物件 vs 場景、章節切換 · engine.md 架構與模組 · qa.md 截圖腳本與評分表 · advanced.md 真實素材與趨勢路線圖 · lessons.md 到目前為止的所有錯誤 — 開始前先瀏覽一遍。 參考研究資料(與技能一同保存):references/research/oryzo-teardown.md、graphify-teardown.md、video-and-writeup-research.md。已服務客戶:pages/poolco/、pages/secureco/、pages/hotelsaas/。

參考資料摘要

Oryzo 將一個英雄物件置於舞台中央,並改變其周遭的世界(攝影機、渲染模式、色調、明暗)— 簡短的面無表情文案,每個節奏點包含一個聲明與一個證明;一個固定的 WebGL 畫布位於高聳的 DOM 之後,每個緩動值都是一個彈簧。Graphify 將 3D 作為調味料:一個黏性的「運作方式」,其圖表就是產品隱喻(投影的 SVG 線框),並以證據密度來銷售。我們融合了兩者 — 並且,對於實體企業,將抽象物件替換為一個真實、可識別的場景,並且可以將其切開並加上標籤。

工作流程(全部執行,依序進行)

1 · 資料收集與研究 → research/<slug>/brief.md

如果客戶有網站,先爬取每個頁面(intake.md):文字、服務、流程、地點、常見問題、條款/免責聲明、真實標誌檔案、取樣的品牌顏色和字型、公開聯繫方式。 提取:公司名稱、一句話的護城河(他們反覆宣稱的)、買家、真正的行動呼籲、實際存在的證據。對於無法找到或推斷的資訊,只向使用者詢問一次。如果輸入中包含憑證/帳號/個人資料 → 先停止並發出警告。

2 · 策略(在編寫程式碼前寫入 brief)

  1. 護城河類型 → 隱喻(narrative.md §2)。
  2. 物件還是場景? 應用 1 秒測試(scenes.md)。地點/裝置 → 場景(pool 模式); 關於存取/可見性的軟體 → repo;為按時運作的地點(飯店、場地、零售)設計的軟體 → city;產品 → 物件形狀。
  3. 論點主軸(類別習慣 vs 護城河所證實的)。
  4. 章節規劃:10–15 個章節(narrative.md §3,或對於服務業的 §3b 建構次序)。每個章節至少改變攝影機、舞台/模式、色調、數值、佈局形狀中的兩項。
  5. 所有文案(§4):標題 ≤ 7 字、正文 ≤ 35 字、一個聲明 + 一個證明,僅來自 brief。
  6. 變化格式 — 沒有兩個客戶會得到相同的頁面。 在 brief 中決定並寫下:滾動的意義(一段旅程、一個建構順序、一個時鐘…)、讀者做什麼(閱讀、點擊、拖曳、播放),以及 3D 回應什麼(僅滾動,或透過 send/receive 的元件)。對於有儲存庫的軟體,讓章節可互動(type: 'play'):使用示範資料,製作產品真實元件的誠實小型複製品,以驅動 3D 變化(engine.md → HotelSaaS)。

3 · 美術指導

art-direction.md:以燈光優先的 60·30·10 色板,來自品牌色 + 產品色 + 一個互補強調色(在交接文件中解釋理論)、客戶自己的字型、為求真實感將 Bloom 設為 0、在複雜 3D 背景上使用文字卡、為每個 3D 章節製作手機關鍵影格。

4 · 圖像(並行處理)

編寫 research/<slug>/images.json(每個服務一張照片 + og),並在背景執行 node .claude/skills/moat-landing/tools/gen-batch.mjs research/<slug>/images.json 當你進行建構時。檢閱聯絡表;重新生成被拒絕的圖片。原始檔案保留在 research/ 中,永遠不在 public/ 中。 關鍵:將 GEMINI_API_KEY 設定在你的 shell 環境中 — 永遠不要列印它或將它作為參數傳遞。 軟體/開發者品牌: 跳過攝影;一旦英雄物件獲得批准,從你自己的英雄渲染圖(1200×630 視口截圖)製作 public/og.jpg。

5 · 建構

SLUG=<slug>; ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
mkdir -p "$ROOT/pages/$SLUG" && rsync -a --exclude node_modules --exclude dist "$ROOT/.claude/skills/moat-landing/template/" "$ROOT/pages/$SLUG/"
cd "$ROOT/pages/$SLUG" && npm install

改寫 src/content.js(架構:模板 content.js 頂部 + engine.md),包括 meta.url/image、business、brand.copyCards、quickActions、章節的 notes/cover/mobile。頁面特定的 CSS 放在 brand.css 中。新功能 → 在 template/ 中建構,然後執行 rsync -a --exclude content.js template/src/ pages/<slug>/src/。

5b · 其他頁面(當客戶網站有這些頁面時)

以原始 URL 重建原始網站的每個頁面(src/pages/<slug>.js、engine.md → 多頁面): 每個子頁面保留相同的 3D 世界、卡片語言和一個可互動的組件(功能 → 探索器、定價 → 方案選擇器、關於 → 故事小工具);法律頁面使用 doc 類型並包含真實文字(標記日期和管轄權以供審查);聯絡頁面使用 WhatsApp/電子郵件表單(未經批准不使用後端)。

6 · 驗證(強制,每個反覆運算,兩種尺寸)

npm run check(預算檢查)→ 預覽 → 以 1440×900 和 390×844 捕捉所有章節 → 聯絡表 → 行為 + SEO 檢查 → qa.md 中的評分表。預期 2–3 輪。

7 · 交接

執行位置(npm run dev / 預覽 URL)、論點主軸、章節地圖、色彩理論依據、客戶仍需提供的內容(真實證據、表單端點、分析 ID、網域)、選擇的預設值,以及來自 advanced.md §9 的前 2–3 項升級建議。提醒客戶,在發布前必須驗證數據、法規和比較性聲明。將學到的經驗更新到 lessons.md 和記憶中。

設計規則(來自客戶回饋 — 預設套用)

  • 一秒可識別性。 先建立真實的東西;然後再將其切開說明。
  • 無光暈。 任何真實物體都將 Bloom 設為 0;光線來自太陽、天空和場景內的光源。
  • 明亮、陽光充足的色板 用於實體/服務業;僅在夜間/科技主題時使用暗色。
  • 絕不在紋理上放文字。 卡牌應位於水面、瓷磚和複雜 3D 背景之上。
  • 使用章節切面 + 錨定標籤來說明,而非使用透視光暈。
  • 絕不發送可見的佔位符。 缺少證據 → 省略該章節,並在交接文件中列出。

不可協商事項

  • 整個頁面只有一個英雄(物件或場景);流內容存在於 cover 章節中。
  • 切換舞台,觸發文案(文案在重新進入時會重播;絕不一次性播放)。
  • 文字是 HTML,永遠不嵌入紋理或圖片中;結構化資料僅說明頁面顯示的內容。
  • 誠實。 不得有虛構的指標、客戶、標誌、引言、認證或競爭對手事實;生成的圖片必須標註為示意圖;生成的真人不可表現為客戶。
  • 絕不冒充 使用者無權代表的品牌;虛構的示範必須明確說明。
  • 品牌。 始終使用客戶自己的品牌(字型、顏色、標誌)— 從其現有網站讀取。
  • 預算(npm run check):頁面 JS ≤ 55 KB gz、舞台 ≤ 205 KB gz、圖片 ≤ 500 KB、一個畫布、DPR ≤ 1.75;在關閉 WebGL、啟用減少動畫、寬度 390 px 時正常運作;0 個主控台錯誤;0 個溢出。
  • 未經使用者明確同意,不得進行部署、設定表單端點、分析 ID 或外部帳戶。

相關技能