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)
- 護城河類型 → 隱喻(
narrative.md §2)。 - 物件還是場景? 應用 1 秒測試(
scenes.md)。地點/裝置 → 場景(pool模式); 關於存取/可見性的軟體 →repo;為按時運作的地點(飯店、場地、零售)設計的軟體 →city;產品 → 物件形狀。 - 論點主軸(類別習慣 vs 護城河所證實的)。
- 章節規劃:10–15 個章節(
narrative.md §3,或對於服務業的 §3b 建構次序)。每個章節至少改變攝影機、舞台/模式、色調、數值、佈局形狀中的兩項。 - 所有文案(
§4):標題 ≤ 7 字、正文 ≤ 35 字、一個聲明 + 一個證明,僅來自 brief。 - 變化格式 — 沒有兩個客戶會得到相同的頁面。 在 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 或外部帳戶。