動畫版網站管線
端到端流程 - 輸入 URL,產出已部署的 Netlify URL。總共四個步驟,中間無須提示。所有輸出檔案會以 $PWD/sites/<slug>/ 為命名空間,因此多個網站可以在同一個上層專案中和平共存。
觸發時機
- 從使用者的訊息或
$1參數中提取 URL。如果不知為何沒有提供 URL,則詢問一次並停止。否則繼續進行後續步驟。 - 根據 URL 的主機名稱衍生 slug 與 網站名稱:
- 主機名稱
acmegrowthpartners.com→ slugacme-growth,網站名稱Acme Growth Partners(標題大小寫) - 移除
www.、去掉頂級域名,將點替換為連字號,並轉為小寫。對於人性化的網站名稱,應根據品牌辨識度使用合理的標題大小寫(例如acmegrowthpartners.com→Acme Growth Partners,而非Acmegrowthpartners)。slug 僅用於檔案名稱與 URL。
- 主機名稱
- 並行確認必要條件:
npx playwright --version(品牌手冊提取的依賴項)grep -l KIE_AI_API_KEY "$PWD/.env" || grep -l KIE_AI_API_KEY "$HOME/<你的專案目錄>/.env"(KIE.ai API 金鑰)command -v netlify(用於部署步驟的 Netlify CLI)mkdir -p "$PWD/sites/<slug>"
如果任一個必要條件失敗,則準確顯示問題並停止。不要嘗試安裝 Playwright、Netlify 或猜測 API 金鑰。
步驟 1 — 品牌手冊(可跳過)
跳過條件: 所有檔案 $PWD/sites/<slug>/brand/typography.md、colors.md、tailwind.snippet.js、reference.png 都存在且 reference.png 在過去 24 小時內曾被修改。如果跳過,請記錄「→ 品牌書已從快取中重複使用」並繼續。
- 執行品牌手冊提取器:
node ~/.claude/skills/brand-book/extract.js "<URL>" "$PWD/sites/<slug>/brand" - 讀取
sites/<slug>/brand/type-styles.json、sites/<slug>/brand/css-variables.json,並檢視sites/<slug>/brand/reference.png。 - 依照品牌手冊技能的格式撰寫
sites/<slug>/brand/typography.md、colors.md、tailwind.snippet.js、README.md- 以不一致性優先、字型尺寸對照表、色板分組、語意化命名的 Tailwind 權杖。應用合理化而非編纂規則。 - 自動發布至 GitHub,無須詢問(這將在你的 GitHub 帳號下建立一個公開儲存庫——請在下方設定
<你的 GitHub 使用者名稱>,如果你不希望發布品牌手冊,請移除此步驟):- 儲存庫名稱:
Brand-Book-<TitleCaseSlug>(例如Brand-Book-Acme-Growth-Partners)。單詞之間使用連字號。 - 使用
mcp__github__create_repository(擁有者:<你的 GitHub 使用者名稱>,public,autoInit: true),然後使用mcp__github__push_files推送全部 6 個檔案(跳過reference.png- 對工具參數限制來說太大)。 - 如果儲存庫已存在(從 create 收到 HTTP 422),繼續 - 直接呼叫
mcp__github__push_files來更新。
- 儲存庫名稱:
記錄:BRAND_REPO_URL,以及來自 colors.md 的合理化 primary、accent、neutral、surface-dark 十六進位顏色值(你將在步驟 3 中重新讀取這些值)。
步驟 2 — 英雄循環影片(可跳過)
跳過條件: $PWD/sites/<slug>/hero-loop-7s.mp4 存在。記錄「→ 英雄影片已從快取中重複使用」並繼續。
- 根據你剛寫入的品牌手冊產物推導出視覺概念:
- 在
colors.md中檢查合理化的色板 → 挑選主導的品牌情感(例如,成長型品牌為軌跡 + 解鎖;暖色調色板為溫暖 + 工藝;極簡單色為克制 + 精準)。 - 快速瀏覽
reference.png以尋找視覺元素(漸層方向、線條作品、粒子/顆粒處理、幾何形狀)。 - 綜合出一句話的影片隱喻,將品牌的語言定位轉換為動態。
- 這是創意工作——認真對待,不要退回到通用模板。查看螢幕截圖。
- 在
- 建立 Nano Banana 2 圖像提示詞,作為一個 1:1 的靜止畫面以捕捉循環的「之前」節拍。參考精確的品牌十六進位色碼。最後加上「無文字、無標誌、電影感、高級 B2B 美學。」
- 提交至 Nano Banana 2:
記錄source "$PWD/.env" 2>/dev/null || source "$HOME/<你的專案目錄>/.env" curl -s -X POST "https://api.kie.ai/api/v1/playground/createTask" \ -H "Authorization: Bearer $KIE_AI_API_KEY" \ -H "Content-Type: application/json" \ --data-binary @- <<EOF { "model": "nano-banana-2", "input": { "prompt": "<圖像提示詞>", "output_format": "png", "image_size": "1:1" } } EOFtaskId。輪詢https://api.kie.ai/api/v1/playground/recordInfo?taskId=<ID>直到state == "success"。解析data.resultJson(它是一個 JSON 字串)以取得 URL。不要下載 - 保留雲端 URL。 - 建立 Seedance 提示詞,作為 7 秒內按時間編碼的節拍。始終包含:
- 0-2 秒:建立(鏡頭飄移、氛圍)
- 2-4 秒:累積(動作加速 / 匯聚)
- 4-5 秒:釋放(品牌的「解鎖」時刻 - 通常是強調色綻放)
- 5-7 秒:解決(回到可循環的狀態)
- 結尾:「緩慢控制的鏡頭,無抖動。真實的光暈物理效果。無文字、無標誌。」
- 提交至 Seedance 2,使用雲端圖像 URL 作為
image_url:記錄 taskId。在背景執行輪詢迴圈(cat > /tmp/seedance-payload.json <<'EOF' { "model": "bytedance/seedance-2", "input": { "prompt": "<影片提示詞>", "image_url": "<雲端圖像 URL>", "duration": 7, "resolution": "480p", "aspect_ratio": "16:9" } } EOF curl -s -X POST "https://api.kie.ai/api/v1/playground/createTask" \ -H "Authorization: Bearer $KIE_AI_API_KEY" \ -H "Content-Type: application/json" \ --data-binary @/tmp/seedance-payload.jsonrun_in_background: true) - 典型的生成時間為 3-5 分鐘。當通知完成時,直接點擊recordInfo端點以讀取state(Python 嵌入 Bash 的輪詢解析器很脆弱 - 建議在收到背景通知後直接使用一次 curl)。 - 將最終影片下載至
$PWD/sites/<slug>/hero-loop-7s.mp4。
記錄:VIDEO_PATH。
步驟 3 — 前端設計建置(可跳過)
跳過條件: $PWD/sites/<slug>/index.html 存在。記錄「→ 網站已從快取中重複使用」並繼續。(如果使用者想要重新建置,他們會刪除該檔案或在其請求中傳遞 --force。)
這是使用者用來與 claude.ai 的 Artifacts 進行比較的工作產品。品質很重要。
- 載入前端設計子技能的上下文:
- 讀取
sites/<slug>/brand/tailwind.snippet.js(完整內容) - 讀取
sites/<slug>/brand/typography.md和colors.md(僅限合理化摘要) - 記錄本地影片路徑:
./hero-loop-7s.mp4(index.html 的同層檔案——重要:不要像舊結構一樣使用../references/...) - 記錄來源 URL(用於內容/文案參考 - 頁面應是修訂版,而非克隆版)
- 讀取
- 透過技能工具呼叫
frontend-design:frontend-design技能。傳遞一個自包含的提示詞,其中包含所有以下內容:- 輸出路徑 -
$PWD/sites/<slug>/index.html(單一檔案,自包含)。影片位於其旁邊的./hero-loop-7s.mp4。 - 品牌權杖 - 貼上來自
sites/<slug>/brand/tailwind.snippet.js的完整 Tailwind theme.extend 區塊。 - 英雄影片 - 使用 src
./hero-loop-7s.mp4作為<video autoplay loop muted playsinline>背景,置於英雄區塊中,並加上暗色漸層遮罩以確保文字可讀性。 - 內容的來源 URL - 告知設計子技能草擬
<URL>登陸頁面的修訂版:保留價值主張和主要區段(英雄區塊、社會證明、服務/解決方案、CTA、頁尾),但提升設計品質、字型層級和動畫精緻度。 - 品質標準 - 「生產等級、與眾不同,避免通用的 AI 美學。使用者正在將其與 claude.ai 的 Artifacts 輸出進行比較 - 目標要更高。」
- 技術棧 - 純 HTML + 經由 CDN 的 Tailwind(
https://cdn.tailwindcss.com)+ lucide 圖示 + Google Fonts。內嵌 Tailwind 配置以使用品牌權杖。 - 內容真實性 - 如果線上網站有已命名的產品/模組/服務,請逐字使用。如果不確定,請在撰寫文案之前對該 URL 執行 WebFetch 以列舉真實的模組。不要發明不存在的產品。
- 輸出路徑 -
- 子技能完成後,驗證
$PWD/sites/<slug>/index.html存在且引用了./hero-loop-7s.mp4。
記錄:SITE_PATH。
步驟 4 — Netlify 部署
- 為此 slug 建立或重複使用 Netlify 網站。使用清晰且穩定的網站名稱模式:
animated-<slug>(例如animated-acme-growth)。 - 從
$PWD/sites/<slug>/部署至生產環境:cd "$PWD/sites/<slug>" && netlify deploy --prod --dir=. --site=animated-<slug> 2>&1- 對於 slug 的首次執行,Netlify 會回報網站不存在。在這種情況下,請明確建立它:
netlify sites:create --name=animated-<slug>然後重新執行部署。 - 從部署輸出中記錄
Website URL:(即上線的*.netlify.appURL)。
- 對於 slug 的首次執行,Netlify 會回報網站不存在。在這種情況下,請明確建立它:
- 快速冒煙測試:
curl -sI <LIVE_URL> | head -1應回傳HTTP/2 200。如果沒有,請顯示失敗訊息,但仍回報本機路徑。
記錄:LIVE_URL。
最終輸出
一旦所有四個步驟都成功,向使用者發送一條簡短訊息 - 四個連結,僅此而已:
線上 - <LIVE_URL>
品牌手冊 - <BRAND_REPO_URL>
英雄影片 - <VIDEO_PATH>
本機網站 - <SITE_PATH>
不要總結建立了什麼。不要回顧。不要自動開啟本機檔案 - 線上 URL 現在才是最終成果。
陷阱
- 不要在執行中途詢問使用者。 重點在於零交接。如果確實缺少某些東西(沒有 URL、沒有 API 金鑰、沒有 Netlify CLI),請顯示阻礙因素並停止 - 不要要求創意輸入。
- 跳過已執行的步驟。 所有三個產出步驟都透過檔案存在性實現冪等性。重做會浪費額度。
- 影片路徑必須相對於其同層的 HTML。 使用
./hero-loop-7s.mp4,而非../references/...。每個網站都完全自包含在sites/<slug>/中。 - 每個網站都是獨立的 Netlify 網站,而非子路徑。 使用
--site=animated-<slug>進行部署,這樣會得到自己的*.netlify.appURL。不要嘗試將五個網站掛載到一個 Netlify 專案中。 - KIE 託管的圖像 URL 是臨時的 - 請在同一個工作階段中提交 Seedance 任務。
data.resultJson是一個 JSON 字串,而非物件。 請解析它。- GitHub 儲存庫已存在? 不要失敗 - 只需推送新檔案進行更新。
- 不要自動安裝 netlify-cli。 如果
command -v netlify失敗,告訴使用者執行npm install -g netlify-cli && netlify login並停止。 - 對於產品名稱,品牌忠誠度 > 創意自由。 始終使用來自線上網站的實際產品/模組名稱。在撰寫頁面文案之前,執行 WebFetch 進行驗證。
- 用於概念推導的品牌手冊螢幕截圖品質很重要。 如果螢幕截圖大部分為空白(Cookie 橫幅遮蓋、懶加載區段未渲染),仍然繼續進行 - 使用 type-styles JSON + 色板 + 你對品牌定位的知識來推導概念。