Communitygithub.com

datassthou64-source/blue-motion-kit

兩個主導 HyperFrames 動態圖形的基本法則:(1) 視覺優先,文字其次;(2) 旁白中的每個命名實體都必須在畫面上呈現真實、有來源的素材。在建立或修改任何動態圖形、分鏡或節拍時使用,特別是當講者提及公司、產品、工具、網站或 GitHub 儲存庫時,用於決定畫面上該放什麼,以及當節拍趨向於純文字卡片或項目符號列表時。適用於所有 HyperFrames 工作流程。

blue-motion-kit 是什麼?

這是一個用於 HyperFrames 動態圖形創作的 AI 助手技能,強制執行兩個核心設計法則:視覺優先於文字,以及所有旁白中提到的命名實體(如公司、產品、工具、網站)都必須在畫面上呈現真實、有來源的素材。此技能的核心價值在於確保動態圖形不僅是帶有動畫效果的投影片,而是透過視覺機制本身傳達意義。它支援 Claude Code 平台,並提供具體的實作指南,包括如何獲取真實的標誌(使用 `fetch-logo.py` 腳本)和網站截圖(透過 `npx hyperframes capture`)。此技能也強調素材驗證的重要性,以及遵守在地化和法律規範,確保所有素材都經過檢查、有來源記錄,並僅用於敘述性的參考目的。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/datassthou64-source/blue-motion-kit/tree/HEAD/.claude/skills/motion-visual-sourcing

在你喜歡的 AI 中提問

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

說明文件

視覺優先,文字其次。每個名稱都必須呈現真實素材。

兩條法則。它們適用於每一個節拍和每一個工作流程。


法則 1 — 視覺優先,文字其次

人們不閱讀,他們掃視。 動態圖形是會動的圖片,而不是帶有動畫效果的投影片。機制本身承載意義;文字只是為其貼上標籤。

在建立每個節拍之前,對其進行的測試:

從畫面中刪除所有文字。點子是否仍然能傳達? 如果不行,代表視覺效果尚未發揮作用 — 改善視覺效果,不要添加文字。

文字是 輔助元素。它標示觀眾正在觀看的內容。它絕不承載圖片尚未說明的聲明。

應該做的事

  • 顯示機制在運作:路由、轉換、填充、計數、排序、收斂、分支。
  • 使用真實的標誌、真實的產品 UI、真實的螢幕截圖作為證據。
  • 每個主要物件一個簡短標籤 — 1–3 個字。
  • 一個重點數字,僅在旁白提到時使用。

不該做的事

  • 將旁白貼在畫面上。字幕最多兩行,絕非段落。
  • 建立項目符號列表、議程卡或文字卡片牆。列表應是星座或收斂中心,而不是堆疊的項目符號。
  • 因為難以視覺化而使用文字卡片。這時更應努力改善視覺效果,而不是放棄並打字。
  • 讓標籤陳述機制未顯示的內容。

注意力分配比例: 將大約 80% 的建構精力花在動態物件上,20% 在文字上。如果比例反過來,這個節拍就錯了。


法則 2 — 每個命名實體都必須呈現真實、有來源的素材

當旁白提到 任何存在於線上的事物 — 公司、產品、工具、網站、GitHub 儲存庫、模型、框架 — 去取得真實的東西並將其呈現在畫面上。

命名實體是 證據。聽到「Clay」並看到實際 Clay 標誌的觀眾會相信你。聽到「Clay」但只看到 Inter 字體寫的「Clay」這個詞的觀眾則不會。

當真實素材存在時,絕不繪製通用方框、憑空創造標誌、憑記憶近似標誌,或將名稱保留為純文字。

應取得的素材,按價值排序

被命名的實體應取得此素材
公司或工具其真實的全彩標誌
具有 UI 的產品該 UI 的真實螢幕截圖,加上標誌
網站實際網站的截圖 — npx hyperframes capture <url>
GitHub 儲存庫該儲存庫自己的頭像/標誌,以及 README 或儲存庫表面
模型 / 框架供應商的標誌(Anthropic、OpenAI 等)
人物僅使用提供的素材。不要抓取他人的照片。

如何取得素材

首先檢查凍結庫。 經過驗證的標誌存放在 library/assets/logos/(其出處記錄在對應的 SOURCES.md 中)。切勿重新獲取已凍結並檢查過的素材。

標誌 — 使用解析器,不要手動搜尋:

cat > logos.txt <<'EOF'
clay      clay.com
anthropic wikipedia:Anthropic
linkedin  commons:LinkedIn icon
acme      https://acme.com/press/logo.svg
EOF
python3 KIT/.claude/skills/blue-motion/scripts/fetch-logo.py --manifest logos.txt <project>/assets/logos

優先順序:明確 URL → 維基百科 → 維基共享資源 → 網站自己的應用程式圖示 → simple-icons → favicon。偏好前四個;simple-icons 是單色的,而大多數品牌風格指南要求全彩。

網站和產品表面 — 擷取真實頁面:

npx hyperframes capture https://<site> --json --max-screenshots 12

螢幕截圖會作為分層場景保存在本地,並下載相關素材。將非零退出碼、ok:false 或 BLOCKED.md 視為硬性停止 — 絕不要從部分擷取的內容推測品牌的設計。

在開始建構前務必驗證

  • 打開每個回傳的素材進行檢查。 錯誤的標誌比沒有標誌更糟。
  • 當素材大小低於 6 KB 時,獲取器會發出警告,而 Commons 搜尋可能回傳近似但錯誤的結果(錯誤的公司、舊標誌、粉絲創作)。請仔細檢查。
  • 偏好 當前 的標誌。公司會重新品牌;維基百科可能滯後。
  • 記錄出處。fetch-logo.py 會自動附加到 assets/logos/SOURCES.md — 請保持此文件。

保持在地化和合法性

  • 將每個素材複製到該片段自己的 assets/ 目錄中。渲染時絕不使用 CDN 或網路連線。
  • 第三方標誌僅用於敘述性目的 — 用於指稱正在討論的事物。不要重新設計標誌、暗示背書或將標誌用作自己的品牌。
  • 如果找不到或無法驗證真實素材,請說明情況,並改用物件類別的視覺表示。不要為了填補空缺而憑空創造標誌。

這在工作流程中的應用點

  1. 來源選擇 — 對於每個畫面,記錄 該行敘述提及了哪些實體。該列表即是獲取清單。一個命名了實體但未規劃素材的畫面,是未完成的選擇。
  2. 分鏡 — 每個畫面說明其視覺主旨以及所需的真實素材。如果一個畫面的主旨只能透過畫面上的句子來表達,請重新思考該畫面。
  3. 建構 — 素材放入 assets/,在本地引用,並透過肉眼驗證。
  4. 審查 — 瞇著眼看快照。如果你只能透過閱讀來判斷節拍的含義,則違反了法則 1。如果命名的品牌顯示為純文字,則違反了法則 2。

品牌風格仍為優先

這些法則管轄 什麼 出現在畫面上。如何 呈現則由 library/design.md 定義:取得真實素材,然後以品牌風格呈現(放置在托盤上、在深池漸層下、在玻璃卡片內)。

Individual skills in this repo

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

相關技能