video-shotcraft：電影感產品影片製作
一個自包含的製作能力庫：106 張鏡頭配方卡（附 demo 實作原始碼與動態樣片畫廊）、一支已驗收的完整宣傳片模板、可重複使用元件與音訊資產、六階段工作流程。當前 focus 是 web/桌面產品宣傳片，但鏡頭卡本身是通用動效詞彙——也可以單獨抽卡做任意影片裡的單個鏡頭。
何時使用此技能
在以下情況使用：
- 製作電影感產品宣傳片、產品發表會或桌面/網頁應用程式示範影片。
- 指名或要求使用
Ink Press（墨壓）模板，或重現該模板的宣傳效果。 - 實作特定的動態設計鏡頭卡（例如
deck-deal-flyin、row-embed、spotlight-hero-card）。 - 需要 2.5D 相機運鏡（PageCam）、使用 Remotion 進行節奏同步剪輯，以及聲音設計。
操作說明
步驟 1：介紹模板並確認路線
每次呼叫此技能，在開始任何素材採集、分鏡或實作前，先向使用者說明：
- 當前可直接使用
template/中一支已驗收的 36.2 秒產品宣傳片模板 Ink Press（墨壓）：1920×1080、30fps、紙墨琥珀風格，含 10 個完整鏡頭、2.5D 真實頁面運鏡、字卡、轉場和已配好的電影感 SFX；替換目標產品的截圖、文案和品牌資訊即可適用。 - 採用模板是最快、品質最有保障的路徑；若使用者要全新視覺語言，則走自由創作流程。
明確詢問：「要使用這支現成模板來製作這支影片嗎？」 告知使用者可前往 https://vincentwei1021.github.io/video-shotcraft/ 瀏覽動態樣片。
- 使用者確認使用：先完整閱讀
template/TEMPLATE.md，再按模板路線執行。 - 使用者明確不使用：按
references/pipeline.md的階段 0 繼續，走自由創作或單鏡頭路線。 - 使用者尚未決定：停在這裡等待選擇；不要預設套用模板，也不要開始製作。
例外情況：
- 若使用者點名 Ink Press 模板（如「用 Ink Press 模板給我的產品做宣傳片」），視為模板路線已選定，直接閱讀
template/TEMPLATE.md執行。 - 若使用者明確指定某些鏡頭卡（如「用
deck-deal-flyin和row-embed做這支影片」），視為路線已選定，直接閱讀相應鏡頭卡及demos/<卡名>/實作原始碼。
步驟 2：選擇三種用法之一
- 完整宣傳片（模板路線）：讀
template/TEMPLATE.md，按「換產品復現指南」替換素材逐鏡頭適用。 - 完整宣傳片（自由創作）：按
references/pipeline.md六階段走（階段 0 開工三問起步）。 - 單鏡頭/單動效：從
references/shots/選卡，讀卡全文 +demos/<卡名>/實作原始碼，適配到目標素材。
步驟 3：何時讀哪個檔案
| 時機 | 讀取檔案 |
|---|---|
| 專案啟動 | pipeline.md（階段 0 三問） |
| 使用者已選 BGM | music-beat-sync.md（先分析再分鏡） |
| 走模板路線 | template/TEMPLATE.md 全文 |
| 分鏡設計 | sequences/ 橋段模板；shots/ 全部 frontmatter；選中的卡讀全文 |
| 逐鏡頭實作 | 該鏡頭卡全文 + demos/<卡名>/ 實作原始碼全文 + assets/lib/ 對應元件 |
| 聲音設計 | sound-design.md + assets/audio/ |
| 驗收 | aesthetic-rules.md 全文過 checklist（獨立 subagent 執行） |
範例
範例 1：模板路線 (Ink Press)
"用 Ink Press 模板給我的 Desktop Product 做一支 30 秒宣傳片"
-> 自動選擇模板路線，閱讀 template/TEMPLATE.md，進行截圖採集與素材替換。
範例 2：指定鏡頭卡
"參考 deck-deal-flyin 和 row-embed 鏡頭卡製作我的 Product Demo 動效"
-> 自動選擇單鏡頭/組合鏡頭路線，閱讀 references/shots/ 與 demos/ 原始碼進行客製化實作。
最佳實踐
- 真實截圖：復刻既有頁面必須用真實截圖，第一步起 dev server 用無頭瀏覽器截 2x 紋理 + layout.json。
- 產品原生視覺語言：從產品/網站的設計系統提取 tokens（字型、字級、配色、圓角），不要捏造無關皮膚。
- 單鏡頭單動效與呼吸感：每鏡頭只講一個動效，字標/重要畫面卡點落定 hold ≥1s。
- 強節奏 BGM 嚴格卡拍：用
librosa分析真實 BPM/拍號，beatF(n)確定幀數，切點誤差 ≤3f。 - 參考 demo 原始碼：使用鏡頭卡前先讀
demos/<卡名>/調校過的參數真相與已知坑規避寫法。 - 確定性渲染：禁用
Date.now()/Math.random()，使用固定種子偽隨機。
參考資料
template/TEMPLATE.md— Ink Press 模板結構與換產品復現指南references/pipeline.md— 六階段製作流程規範references/aesthetic-rules.md— 視覺審查與驗收 Checklistreferences/music-beat-sync.md— 音樂節奏分析與卡點時線計算references/sound-design.md— SFX 聲音句式與音效資產搭配指南- https://vincentwei1021.github.io/video-shotcraft/ — 動態樣片與 106 張鏡頭卡線上畫廊