概覽
此技能將發行變更日誌轉換為使用 HyperFrames HTML 渲染的拋光影片作品。當產品更新需要視覺化公告時使用 — 包含英雄框架、關鍵要點標註和背景圖案。它會根據您提供的變更日誌項目產出 MP4 檔案。
HyperFrames — 變更日誌影片
輸入:變更日誌 .md(主題 + 項目)。輸出:經過 lint 清理、符合 seam-gate-green 標準的 HyperFrames 專案。僅在被要求時才進行渲染。
使用時機
- 使用者提供變更日誌/摘要 Markdown 並希望產出每週影片
- 使用者說出 "changelog video" 或 "weekly digest video"
- 使用者想要一個品牌化影片,包含動畫模擬 UI 和旁白
不應使用的情境
- 使用者想要產品發布影片(使用
hyperframes-product-launch-video) - 使用者想要動態圖形(使用
hyperframes-motion-graphics) - 使用者想要講話人頭影片(使用
hyperframes-embedded-captions)
首要原則:可視化,不要列出
每個主題都應以實際 UI 的動畫模擬或忠實類比來說明體驗的變化 — 絕不使用文字要點。在撰寫腳本之前,先將每個主題/項目路由至視覺化註冊表中的對應項目。
工作流程
0 · 從技能資產引導(非協商)
mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
-vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
-an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html
然後完整閱讀 references/build-spec.md — 它定義了品牌標記。
1 · 解析 + 編輯剪裁
- 提取:週範圍、標題統計、主題、項目
- 時間預算:總共 45-60 秒。 標題 ≤2 秒,片尾 ≤3.5 秒,4 個主題各約 9-12 秒
- 每個主題保留一個英雄視覺化 + 最多 3 個口頭項目
- 按故事順序排列主題:旗艦功能 → 產品表面 → 效能 → 可靠性
2 · 視覺化路由
對於每個主題,從視覺化註冊表中選擇表面,並撰寫一行:theme → surface → mock 執行的 2-4 個序列動作,每個動作都與腳本短語相關聯。
3 · 雙層腳本(口頭 vs 顯示)
將腳本撰寫為 token 行:對話式的語氣,每個技術術語攜帶一個 spoken 語音形式,而 display 保持標準拼寫。字幕顯示 display;旁白朗讀 spoken。
4 · 旁白 + 單字時間戳記
node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json
單字時間是硬性關卡。 在繼續之前,確認 vo-words.json 非空,並包含一個帶有每個單字 start/end 的 words: [...] 陣列。
5 · 構建
嚴格遵循 references/build-spec.md:品牌標記 + 字型 + 動畫背景編碼 + 場景骨架 + chrome + 字幕軌。然後按照順序:向量帳本 → seam-stamp → 依據旁白單字的內部節拍 → seam-gate 驗證。
字幕不是可選項。 在繼續之前,先從 captions.json 填入 LINES 陣列。
6 · 關卡(全部綠燈方可呈現)
hyperframes check— 0 錯誤seam-gate.mjs verify— 0 失敗- 重新啟動預覽伺服器,抽查 3-4 個節拍
- 除非使用者要求,否則不要渲染
- 字幕存在關卡 — 抽樣 3-4 幀,確認字幕軌可見
反合理化表格
| 合理化 | 現實 |
|---|---|
| "UI 變更使用要點投影片" | 以模擬表面展現變更的運作方式 |
| "對於無法呈現的項目使用假 UI" | 誠實的檢查清單場景 |
| "TTS 文字中使用純 'JSON'" | 詞彙表口頭形式;顯示保持標準 |
| "猜測發音" | 詢問,然後擴充詞彙表 |
| "念出所有變更日誌項目" | 每個主題 ≤3 項;摘要連結承載其餘內容 |
| "到處使用綠色點綴" | 每個場景只有一個綠色時刻 |
| "從先前影片的 index.html 開始" | 始終複製 master-skeleton.html |
| "空的 LINES 陣列沒問題" | 空的 LINES = 沒有字幕的成品 = 重新執行 |
驗證
-
hyperframes check通過,0 錯誤 -
seam-gate.mjs verify通過,0 失敗 - 在 3 個以上抽樣幀中字幕軌可見
- 單字時間戳記與音訊對齊
- 品牌標記與 build-spec.md 相符
- 僅在使用者明確要求時才渲染