AI
guizang-product-video-skill：從產品程式碼生成可重渲染的版本更新宣傳片
一套讓 Claude Code／Codex 從真實產品 repo 找更新、接原元件、用 React／Playwright／FFmpeg 做動畫，並以 Python 生成配樂與音效的 Agent Skill。實測 12 項測試通過；採用前要注意 AGPL-3.0、CodePilot fallback 的 BSL 1.1 與 repo／素材權限邊界。
2026年9月20日3 分鐘閱讀👁 6
Agent Skill / Product Video / Code-driven Motion
guizang-product-video-skill：讀產品程式碼，把 release notes 變成可重渲染的宣傳片
這不是文字轉影片模型，而是一套讓 Claude Code／Codex 從真實 repo 找更新、接原元件、寫分鏡、用程式生成配樂與音效，再以 React、Playwright、FFmpeg 逐幀輸出 MP4 的製作流程。優點是可重現、可修改、成本低；主要風險是 AGPL＋BSL 混合授權、依賴安裝與 AI 對原始碼的讀取範圍。
它實際做什麼
op7418/guizang-product-video-skill 把軟體更新宣傳片拆成六步：定範圍與風格、環境檢查、從 repo 找真實更新並接入元件、分鏡與文案、動效與聲音、最後驗收交付。正式影片至少要有一項可追溯的功能主張；元件鏡頭優先使用產品原始元件與樣式，而不是仿畫一個相似 UI。
Repo-native
從 commit、版本說明、元件與設計 token 提煉 3–5 組觀眾聽得懂的更新。
Code-driven video
React＋esbuild 建畫面，Playwright 逐幀渲染，FFmpeg／ffprobe 編碼與檢查；不是每一鏡都向生成式影片 API 抽卡。
Code-generated audio
內附 Python 配樂範例、11 個合成 WAV 與混音腳本；音效 cue 綁定時間軸 action，支援 BGM ducking。
Evidence-aware QA
plan 記錄來源、claim、元件、音效事件；delivery checker 驗證時間線、媒體流、尺寸、幀率、音軌與 hash，但不把自動檢查冒充視覺／聽感審片。
三種工作模式
| 模式 | 適合 | 注意 |
|---|---|---|
repo | 產品已有完整設計系統；直接沿用品牌、元件與字體 | 最適合正式商業專案，也最需要隔離讀取與依賴 |
default | 沒有成熟視覺，先用 CodePilot 暖白／炭黑包裝 | fallback assets 另受 BSL 1.1，不是 AGPL 或 MIT |
hybrid | 保留產品 UI，外層字幕與構圖採預設視覺 | 同時碰到產品素材與 fallback 授權 |
實測與成熟度
- 查核時 repo 約 144 stars、12 forks，建立於 2026-09-18，GitHub API 標示 AGPL-3.0。
- 本機以 fresh clone 執行
python3 -m unittest discover -s tests：。