Communitygithub.com

Liwei-Ji/awesome-ai-learning

為 Awesome AI Learning 平台製作宣傳影片(先建立 HTML 動畫腳本,再轉為影片)。每當使用者要求製作、產出或更新宣傳/行銷/LinkedIn 影片時使用。始終優先詢問是「產品介紹」還是「單一課程」,以及是哪門課程。

awesome-ai-learning 是什麼?

這項技能讓 AI 助手能為 Awesome AI Learning 平台(內部稱「AI 學院」)製作專業的宣傳影片。工作流程分為兩階段:先建立一個自包含的 HTML 動畫腳本(animatic),讓使用者快速預覽與迭代,確認後再轉換為實際影片。它支援兩種影片類型——「產品介紹」與「單一課程」——並能從專案原始碼中提取精確的內容資料(如課程、挑戰、學習路徑的數量),但刻意在畫面上使用中性的措辭(例如「數十個挑戰」),避免因數字變動導致影片過時。HTML 動畫腳本遵循嚴格的視覺規範:採用明亮 Editorial 風格、無品牌標誌贅飾、內嵌英文字幕、支援本地背景音樂並透過 Web Audio API 實現節拍響應動畫,還內建 6 種開場動畫變體供選擇。最後,技能會指引使用者透過 headless Chrome 截圖驗證,並使用 ffmpeg 或螢幕錄影輸出 MP4 影片。支援的開發平台包括 CLI 環境(如 Claude Code)以及具備檔案系統與 Puppeteer/ffmpeg 存取權的工具。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Liwei-Ji/awesome-ai-learning/tree/HEAD/.claude/skills/promo-video

在你喜歡的 AI 中提問

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

說明文件

promo-video

為 Awesome AI Learning(內部:AI 學院)製作宣傳素材。先建立一個自包含的 HTML 動畫腳本(可快速預覽與迭代),與使用者確認後,再轉換為實際影片。簡報腳本位於 marketing/AI_learning_platform_video_prompt.md;開始製作前請先閱讀。產品視覺標記存放在 src/styles/tokens.css。

步驟 1:詢問影片視角(除非使用者已指定,否則一律執行)

使用 AskUserQuestion:

  1. 產品介紹,還是單一課程? 這兩者是不同的素材,切勿混用。
  2. 如果是課程:哪門課程? 29 堂課以 slug 為鍵值,存放在 src/data/chapters.js 中(DATA + OUTLINE)。優先提供視覺效果最強的課程(參見下方的示範清單),並讓使用者輸入任何 slug。

在獲得答案之前,請勿開始建構。

步驟 2:收集準確的內容(切勿捏造產品事實)

  • 產品事實(保持精確):29 堂課、64 項挑戰、12 條學習路徑、互動式示範、三語支援(英文/日文/中文)、100% 離線(無需執行時期 LLM)、免費、開源,網址 awesome-ai-learning.vercel.app。如果不確定,可從專案倉庫重新推算數量(chapters.js 的 TOTAL、interviews.js 的 IV_ORDER 長度、paths.js 的 PATHS 長度)。
  • 切勿將變動中的數字放入畫面上的文字。 課程、挑戰、路徑的總數會隨著時間增長,而已經發布的影片無法更新,因此確切數字很快就會過時。請在畫面上使用中性措辭(例如「數十個挑戰」、「引導式學習路徑」、「完整課程」)。上述確切數字僅供內部參考,不用於影片中。
  • 對於課程影片,從下列位置提取該 slug 的英文原文:src/data/i18n/chapters.js(CH_TR.en[slug] 的 title/sub/key/terms)、src/data/bodies.js(BODIES[slug].en)、src/data/knowledge/en/<slug>.js(筆記)、src/data/practice.js(PRACTICE[slug] 的英文內容)。請勿改寫成不準確的內容。

步驟 3:建構動畫腳本(嚴格規範)

建立一個自包含的獨立 HTML 檔案(所有 CSS/JS 內嵌,無外部資源)至:

  • 產品:marketing/video-product.html
  • 課程:marketing/video-course-<slug>.html

規範(均為強制性):

  • 僅限英文。 旁白和內嵌字幕均為英文。在產品影片中,用一句話口頭提及三語支援(English / 日本語 / 繁中)的功能;請勿製作語言切換動畫。
  • 符合產品風格(明亮 Editorial),而非暗色電影風。 使用下方的標記。色彩克制、留白充裕、髮絲分隔線、舒適行高。動畫輕柔乾淨(淡入、小幅上移、每場景一個強調),不要花俏。
  • 無裝飾元素。 不得出現持續的品牌字樣、標誌圓點、「AI 學院」標籤、右上角標記或頁尾網址,結尾場景也不得有裝飾性球體。品牌僅透過開場眉毛文字和結尾網址傳達。
  • 音樂與動畫同步。 參考同一資料夾中的本地 background_music.mp3(相對路徑),在使用者首次互動時啟動、循環播放,並提供靜音切換開關。使用 Web Audio AnalyserNode 驅動微妙的節拍反應脈衝(呼吸般的強調光暈、進度條光暈),使動畫隨著音樂移動。請勿將有版權的音訊嵌入檔案中;僅參考本地 mp3。如果使用者提供 BPM,則進一步將場景切換對齊小節,以獲得更緊密的同步。
  • 首發 LinkedIn:16:9 主版。 LinkedIn 上自動播放為靜音,因此需將字幕內嵌在畫面中,並在最初 3 秒內呈現鉤子。同時方便製作 1:1 變體(可透過 ?ar=1x1 切換或附加說明)。影片長度約 45 到 75 秒。語氣專業、可信。
  • 不可使用破折號(em-dash、en-dash 或水平線)。請使用 :,()/→。
  • 提供 ?clean=1(隱藏所有裝飾元素以便錄製)、自動播放 + 循環,以及 Space/R 控制鍵。
  • 公開 window.__jump(i) 並設定固定影格,使其能以確定性方式渲染,便於驗證。

品牌標記(明亮模式,取自 src/styles/tokens.css)

--bg:#eef1f6; --surface:#ffffff; --surface-2:#f6f8fb; --surface-3:#eceff5;
--ink:#141821; --ink-2:#3b4557; --muted:#5b6678; --line:#dde3ec; --line-2:#c6cfdd;
--accent:#e07f0e; --accent-soft:#f6a940; --accent-ink:#a85a08;
--teal:#0f8a80; --teal-soft:#3fb6a8; --good:#1f9d57; --warn:#d69200; --crit:#d23f3f;
--mono:ui-monospace,"SF Mono",Menlo,Consolas,monospace;
--sans:-apple-system,BlinkMacSystemFont,"Segoe UI","PingFang TC","Noto Sans TC",sans-serif;
--r:12px; --e-2:0 3px 10px rgba(20,30,55,.06); --e-3:0 14px 36px rgba(20,30,55,.11);

產品影片:敘事弧線(非功能列表)

  1. 契機:每個人都在使用 AI,但很少有人理解它。鉤子字幕:「使用 AI 不等於理解它。」
  2. 鴻溝:教學只教技巧,不教機器如何運作。
  3. 轉折:一條引導式、動手做的路徑,讓你真正理解。
  4. 展示:2 到 4 個標誌性互動示範(tokenizer、attention、RAG、模型知識)。
  5. 深度:64 項判斷挑戰、學習路徑、結業證書。
  6. 價值(一句話):三語(en/ja/zh)、離線、免費、開源。
  7. 行動呼籲:網址。

課程影片:單一概念弧線

  1. 鉤子:該概念回答的問題(例如:「模型如何知道它所知道的事?」)。
  2. 它釐清的誤解。
  3. 機制,透過該課程的示範隱喻呈現(見下方)。
  4. 一個實用要點(從該課的「In practice」部分提取)。
  5. 軟性行動呼籲:「Awesome AI Learning 中的一節課」+ 網址。

開場動畫變體(開場支援至少 6 種,透過 ?intro=1..6 切換)

相同故事、相同文案、不同開場入口。透過在第一場景上加入 class intro-N 驅動。

  1. 上升:眉毛文字、標題、副標題依序列淡入並向上移動(預設)。
  2. 淡入:僅透明度變化,無位移。冷靜、企業風格。
  3. 擦入:標題由左至右透過 clip-path 遮罩顯現。
  4. 模糊:標題起始模糊,隨後清晰對焦。
  5. 縮放:標題從左側稍微放大並淡入。
  6. 逐詞:每個標題單詞依次上升(動態字體)。 新增變體時,請在此處附加說明,使選單持續成長。 當使用者想要比較這些變體時,為每個變體輸出一個檔案,並將該開場內建為預設值,命名為 video-product_1.html 至 video-product_6.html,並在每個檔案的 <title> 和頂部註解中標示。

標誌性示範及其視覺隱喻(用於「展示」段落)

  • tokenizer:文字分割成彩色 token 區塊。
  • embedding:點根據語義聚類。
  • transformer:注意力權重在詞語之間發光(或注意力矩陣)。
  • llm:下一個 token 的機率條建構成句子。
  • model-knowledge:截止時間軸;截止後的問題失敗,然後一個關聯來源回答它(最強的單一視覺效果)。
  • rag:檢索(文件亮起)然後生成,附帶來源引用。
  • generative:擴散,雜訊逐漸還原成圖像。
  • agent:目標分解成步驟和工具呼叫。

步驟 4:在聲稱完成前進行驗證

使用 headless Chrome(透過 /Applications/Google Chrome.app 的 puppeteer-core)渲染檔案,並透過 window.__jump(i) 跳轉到數個場景,截圖以確認佈局、字幕,且無破折號。調整間距,使視覺元素永不重疊字幕。透過 file:// + encodeURI(path) + ?clean=1 開啟。

步驟 5:交付 + 轉換為影片

  • 告知使用者如何預覽:開啟檔案,它會自動播放並循環;?clean=1 用於錄製。
  • 轉換為影片:如果已安裝 ffmpeg,則以 headless 方式捕捉影格並編碼為 MP4(16:9 主版,外加 1:1 版)。如果未安裝,最簡單的方式是全螢幕螢幕錄製 ?clean=1。
  • LinkedIn 提醒:16:9 或 1:1、內嵌字幕、最初 3 秒內呈現鉤子、專業語氣、約 45 到 75 秒。

音訊(免費,請逐一確認商用授權)

動畫腳本會播放本地的 background_music.mp3(由使用者提供,放在 HTML 旁邊),並透過 AnalyserNode 產生節拍反應光暈。取得或更換音軌的免費選項:

  • 背景音樂:YouTube Audio Library(許多曲目無需署名)、Pixabay Music、Uppbeat(免費方案需標註來源)、Free Music Archive、Bensound(需標註)、Incompetech / Kevin MacLeod(需標註)。
  • 音效(咻、滴答、砰、鈴聲):Pixabay SFX、Mixkit(免費,無需署名)、freesound.org(CC0 或 CC-BY,請逐一檢查)、Zapsplat(註冊後免費)。
  • 針對此產品:一首平靜、向前推進的電子背景音樂,加上場景切換時的細微過渡滴滴聲。保持低調且對 LinkedIn 而言可信。確認商用權利,並在貼文中加入任何必要的署名。

備註

  • marketing/promo-animatic.html 是早期的暗色/9:16 探索版本;它不符合此規範,應被本技能產出的檔案取代。
  • 所有內容維持前端且離線;該影片是行銷素材,並非應用程式的一部分。

相關技能