解說技巧短片 是做什麼的？
這是紀錄片風格的姊妹版：節奏更快、以卡片驅動，專為在45-65秒內教導「每個工具的用途」而設計。它共享 vertical-reels-video-studio-pro 的品牌設定、語音規則、匯出與品質檢查流程。
首次執行
如果 brand.config.json 不存在、包含 "configured": false 或仍顯示 @yourhandle，請先執行 vertical-reels-video-studio-pro 的第0步：詢問使用者他們的社交帳號（IG/Threads/TikTok/X）、浮水印文字與位置、CTA文字與帳號，以及語音，並將這些資訊儲存至 brand.config.json。切勿預設為他人的帳號。
優質技巧短片的要素
- 螢幕上顯示確切名稱。 顯示真實的
owner/repo（例如remotion-dev/skills、FFmpeg/FFmpeg），字體要大且拼寫完全正確。在字幕中也需雙重檢查拼寫（例如字幕中出現「ffmpag」就是一個錯誤）。 - 每個工具只介紹一個功能。 對每個項目用一句簡單的話說明其用途，並展示一個相符的、準確的範例（例如其README首頁圖、真實輸出、簡短的實際程式碼片段）。避免模糊的工具列表。
- 不虛假證明。 絕不捏造星星數、下載量、價格、結果或「使用...製作」的聲明。如果參考影片並非使用列表中的所有儲存庫製作，就不要這樣說。
- 使用主要來源。 閱讀儲存庫的README、授權條款與官方文件。在對原始貼文做出回應時，需註明原始作者，並將原始作者與工具的作者區分開來（發布列表的人並未編寫列表中的儲存庫）。
- 免費與付費區分。 將官方公開技能與付費/私有技能包清楚區分。絕不承諾贈送他人的付費產品。
腳本結構（隨意、直接、第一人稱）
| 節拍 | 時間 | 畫面 | 旁白 |
|---|---|---|---|
| 鉤子 | 0-3秒 | 巨大的鉤子 + 參考片段或結果 | 大膽的聲明或提問 |
| 這是什麼 | 3-10秒 | 儲存庫卡片 owner/repo、許可證標籤 | 一句話說明 |
| 項目1-N | 每個約8秒 | 每個節拍2-3張可讀卡片，不要一次全顯示 | 每個項目的功能 + 範例 |
| 如何使用 | 約8秒 | 在等寬字型卡片中顯示真實的命令/提示 | 最重要的那一步 |
| 檢查 | 約5秒 | 手機尺寸裁切，「可讀嗎？被切掉了嗎？」 | 品質提示 |
| CTA | 最後4-6秒 | 大型CTA卡片 + 儲存庫名稱行、講解角色手勢 | 使用者的 {{CTA}}（在首次執行時詢問），例如「想要所有技能嗎？私訊我。」 |
CTA 邀請觀眾採取行動。你絕對不能自動發送私訊或自動發布內容。
版面
- 使用色票與字型（請參閱
docs/STYLE_GUIDE.md）。卡片：#14202B填充、#384A582px 邊框、24px 圓角、硬式陰影0 12px 0 #05090E。 - 動態強調詞、漂浮的可讀卡片、每個場景的小型麵包屑導航（
鉤子 · 這是什麼 · 如何使用 · 檢查 · CTA）、收斂的轉場效果。 - 完整平衡的9:16畫面，沒有無用的底部區域，同時遵守Reels安全區（內容y軸200-1500；字幕約y1310-1353；使用者的浮水印如果在底部約y1427-1446；所有內容左側約x960以內）。
- 橫向參考素材：以全寬度呈現並故意留出負空間，或交替使用全景與一個可讀的特寫。切勿拉伸素材，也切勿盲目中央裁切而切掉UI或版權資訊。來自參考的片段僅為範例，而非整支影片的主題。
- 每個展示他人作品的場景都需加上來源標註行（
工具 · 作者 · owner/repo · 許可證）。
講解角色
- 詢問使用者是否有自己的講解角色；切勿重複使用他人的角色。
- 每支影片使用一致的身份（相同的臉孔、服裝、配件）。
- 身體與手臂以肩膀為支點（獨立袖子與手部，固定軀幹與頭部）做出上下「教學」手勢；僅靠整個影像晃動會顯得不真實。檢查極端角度下是否有關節脫位或裁切。
- 嘴巴由旁白驅動的聲音軌道生成（
scripts/build-mouth-track.py）。 - 指向/「展示」的姿勢必須朝向被解釋的內容。
語音
- 每支影片使用相同的語音；發音規則來自
docs/VOICEOVER.md（例如「A.I.」、股市代號需拼讀、儲存庫名稱要可辨識——如果儲存庫名稱難以辨識，則重新錄製該行）。困難的命令名稱留在畫面中，不在旁白中念出。 - 審查實際發音、字幕、時間點與重複內容；僅重新錄製失敗的行。
工作流程
- 先撰寫草稿並進行事實查核（使用
templates/draft-template.md）。遵守「不要渲染」的原則。 - 批准後：TTS → 時間調整 → 建置 → 渲染（如果可用，使用GPU；回報裝置資訊）。
- 匯出（
scripts/reels-export.sh），預覽小於40 MB，結尾短暫停留（約0.5秒）。 - 強制進行音訊與視覺審查，然後交付封面A-D、字幕、
.srt檔案與來源版權資訊。