Communitygithub.com

ChuchoMonster/claude-code-skills - 動畫版網站管線

接收一個 URL,自動產出完整的品牌形象登陸頁面修訂版,包含生成的英雄背景影片,然後直接部署到 Netlify。整個過程串聯四個步驟,中間無需任何澄清問題。

claude-code-skills - 動畫版網站管線 是什麼?

此技能提供一個全自動的端到端管線,只需輸入一個 URL,就能產出一個可瀏覽的 HTML 登陸頁面修訂版並部署上線。它依次執行四個步驟:品牌手冊提取(可選配 GitHub 發布)、使用 Nano Banana 2 與 Seedance 2 生成英雄背景影片、前端頁面設計建置,以及最終部署至 Netlify。此技能專為設計比較或快速原型設計場景打造,讓使用者能輕鬆從現有網站獲得靈感,並產出設計品質更高、帶有動態影片的修訂版本。整個過程自動化,無需使用者介入,且所有產出檔案會依照網域名稱存放在 `sites/<slug>/` 目錄下,便於在同一個專案中同時管理多個網站。此技能支援 Claude Code 等支援技能工具的 AI 代理平台,並透過明確的觸發詞如「animated website for <url>」或「/animated-website <url>」來啟動。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ChuchoMonster/claude-code-skills/tree/HEAD/skills/animated-website

在你喜歡的 AI 中提問

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

說明文件

動畫版網站管線

端到端流程 - 輸入 URL,產出已部署的 Netlify URL。總共四個步驟,中間無須提示。所有輸出檔案會以 $PWD/sites/<slug>/ 為命名空間,因此多個網站可以在同一個上層專案中和平共存。

觸發時機

  1. 從使用者的訊息或 $1 參數中提取 URL。如果不知為何沒有提供 URL,則詢問一次並停止。否則繼續進行後續步驟。
  2. 根據 URL 的主機名稱衍生 slug 與 網站名稱:
    • 主機名稱 acmegrowthpartners.com → slug acme-growth,網站名稱 Acme Growth Partners(標題大小寫)
    • 移除 www.、去掉頂級域名,將點替換為連字號,並轉為小寫。對於人性化的網站名稱,應根據品牌辨識度使用合理的標題大小寫(例如 acmegrowthpartners.com → Acme Growth Partners,而非 Acmegrowthpartners)。slug 僅用於檔案名稱與 URL。
  3. 並行確認必要條件:
    • 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 小時內曾被修改。如果跳過,請記錄「→ 品牌書已從快取中重複使用」並繼續。

  1. 執行品牌手冊提取器:
    node ~/.claude/skills/brand-book/extract.js "<URL>" "$PWD/sites/<slug>/brand"
    
  2. 讀取 sites/<slug>/brand/type-styles.json、sites/<slug>/brand/css-variables.json,並檢視 sites/<slug>/brand/reference.png。
  3. 依照品牌手冊技能的格式撰寫 sites/<slug>/brand/typography.md、colors.md、tailwind.snippet.js、README.md - 以不一致性優先、字型尺寸對照表、色板分組、語意化命名的 Tailwind 權杖。應用合理化而非編纂規則。
  4. 自動發布至 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 存在。記錄「→ 英雄影片已從快取中重複使用」並繼續。

  1. 根據你剛寫入的品牌手冊產物推導出視覺概念:
    • 在 colors.md 中檢查合理化的色板 → 挑選主導的品牌情感(例如,成長型品牌為軌跡 + 解鎖;暖色調色板為溫暖 + 工藝;極簡單色為克制 + 精準)。
    • 快速瀏覽 reference.png 以尋找視覺元素(漸層方向、線條作品、粒子/顆粒處理、幾何形狀)。
    • 綜合出一句話的影片隱喻,將品牌的語言定位轉換為動態。
    • 這是創意工作——認真對待,不要退回到通用模板。查看螢幕截圖。
  2. 建立 Nano Banana 2 圖像提示詞,作為一個 1:1 的靜止畫面以捕捉循環的「之前」節拍。參考精確的品牌十六進位色碼。最後加上「無文字、無標誌、電影感、高級 B2B 美學。」
  3. 提交至 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" } }
    EOF
    
    記錄 taskId。輪詢 https://api.kie.ai/api/v1/playground/recordInfo?taskId=<ID> 直到 state == "success"。解析 data.resultJson(它是一個 JSON 字串)以取得 URL。不要下載 - 保留雲端 URL。
  4. 建立 Seedance 提示詞,作為 7 秒內按時間編碼的節拍。始終包含:
    • 0-2 秒:建立(鏡頭飄移、氛圍)
    • 2-4 秒:累積(動作加速 / 匯聚)
    • 4-5 秒:釋放(品牌的「解鎖」時刻 - 通常是強調色綻放)
    • 5-7 秒:解決(回到可循環的狀態)
    • 結尾:「緩慢控制的鏡頭,無抖動。真實的光暈物理效果。無文字、無標誌。」
  5. 提交至 Seedance 2,使用雲端圖像 URL 作為 image_url:
    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.json
    
    記錄 taskId。在背景執行輪詢迴圈(run_in_background: true) - 典型的生成時間為 3-5 分鐘。當通知完成時,直接點擊 recordInfo 端點以讀取 state(Python 嵌入 Bash 的輪詢解析器很脆弱 - 建議在收到背景通知後直接使用一次 curl)。
  6. 將最終影片下載至 $PWD/sites/<slug>/hero-loop-7s.mp4。

記錄:VIDEO_PATH。

步驟 3 — 前端設計建置(可跳過)

跳過條件: $PWD/sites/<slug>/index.html 存在。記錄「→ 網站已從快取中重複使用」並繼續。(如果使用者想要重新建置,他們會刪除該檔案或在其請求中傳遞 --force。)

這是使用者用來與 claude.ai 的 Artifacts 進行比較的工作產品。品質很重要。

  1. 載入前端設計子技能的上下文:
    • 讀取 sites/<slug>/brand/tailwind.snippet.js(完整內容)
    • 讀取 sites/<slug>/brand/typography.md 和 colors.md(僅限合理化摘要)
    • 記錄本地影片路徑:./hero-loop-7s.mp4(index.html 的同層檔案——重要:不要像舊結構一樣使用 ../references/...)
    • 記錄來源 URL(用於內容/文案參考 - 頁面應是修訂版,而非克隆版)
  2. 透過技能工具呼叫 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 以列舉真實的模組。不要發明不存在的產品。
  3. 子技能完成後,驗證 $PWD/sites/<slug>/index.html 存在且引用了 ./hero-loop-7s.mp4。

記錄:SITE_PATH。

步驟 4 — Netlify 部署

  1. 為此 slug 建立或重複使用 Netlify 網站。使用清晰且穩定的網站名稱模式:animated-<slug>(例如 animated-acme-growth)。
  2. 從 $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.app URL)。
  3. 快速冒煙測試: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.app URL。不要嘗試將五個網站掛載到一個 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 + 色板 + 你對品牌定位的知識來推導概念。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能