Reel 樣式
ENGINE = node "${CLAUDE_PLUGIN_ROOT}/engine/bin/reels.js"
HOME = 若設定了 $REELS_HOME 則為其值,否則在 Mac 上為 ~/Movies/Reels,在 Windows 上為 ~/Videos/Reels。執行 ENGINE init-home 會顯示 HOME 路徑。
在指令中,請務必將 HOME 和 PROJECT 路徑用雙引號括起來,並使用引擎輸出的完整路徑(在雙引號內使用 ~ 無法正常運作)。在 Windows 上,路徑包含反斜線且常有空格,若無括號將會出錯。
樣式僅代表外觀:字型、字幕、顏色、縮放。它永遠不會改變剪輯方式。如果成員想要更緊湊或更寬鬆的停頓時間,那是編輯規則的問題,而非樣式:請在 HOME/edit-config.json 中調整 gap_between_ms(100-250)或 gap_within_target_ms,然後重新執行 finish。
成員的樣式是 HOME/styles/*.json 檔案,每個內容系列(「技巧」、「故事」)一個檔案。他們的預設樣式是 HOME/brand-kit.json 中的 default_style。引擎內建一個名為 starter 的樣式,僅在成員擁有自己的樣式前使用。切勿提供 clean、punchy 或 editorial,這些樣式已移除。(舊的 HOME 資料夾可能仍留有這三個檔案。它們仍可運作,除非成員要求,否則請勿動它們。)
檔案結構以及所有可調整的設定:請參閱 references/style-file.md。
操作說明
-
列出: 讀取
HOME/styles/,並以一行簡潔文字描述每個樣式(字型、文字模式(單詞/詞組)、文字邊框效果(軟陰影/輪廓/無)、字幕位置、縮放程度),並標記預設樣式。若尚無樣式:告知使用者目前使用的是 starter 樣式,並提議為他們建立自己的樣式。 -
新樣式: 執行
references/style-interview.md。 -
好康報你知: 成員也可以在 /reels-engine:reel 中「傳送給 Claude」後的畫面上,調整樣式的字型、字幕、文字樣式與顏色(「變更外觀」)。此操作會寫入同一個樣式檔案,因此在編輯前請重新讀取檔案,以確保取得最新內容。
-
從他們提供的範例建立:(「讓這個 Reel 看起來像這個樣子」,並附上已儲存的影片或螢幕截圖):請遵循
references/from-example.md。切勿要求他們提供範例。 -
以一般文字編輯: 修改檔案後,務必向他們顯示:
ENGINE sample <名稱>,並詢問是否滿意。持續調整直到他們說「好」為止。他們說 修改方式 字幕變大 / 變小 captions.size+12 / -12(預設值:詞組模式為 64,單詞模式為 88)一次一個字 captions.mode: "word"一次幾個字 captions.mode: "group",captions.words_per_line: 3每行多一點 / 少一點字 調整 captions.words_per_line,範圍 2 到 4全部大寫 / 正常大小寫 captions.case: "upper"/"sentence"切換字型,「使用 Montserrat」 將 font.family設為五種字型之一,font.file: null。若不確定:開啟選擇器(references/style-interview.md的第 1 步)使用自己的字型 請參閱 references/style-file.md中的「自訂字型」一節變更顏色,「換一個不同的焦點顏色」 captions.highlight_color(焦點顏色:正在說的字)、captions.color(其他字)。若使用者提供十六進位色碼或顏色名稱:直接設定。若使用者想看到選項:開啟選擇器(references/style-interview.md的第 1 步)讓單字彈出 / 無高亮 captions.highlight: "pop"/"none"("color"為預設值)為文字加上輪廓 / 回到軟陰影 / 純文字無陰影 captions.treatment: "outline"/"shadow"/"none"放大 / 縮小更多 上下一個層級: off→minimal→medium移動字幕(頭部上方、頭部下方、更低、頭部旁邊) captions.position:above/below/low/beside-left。這會變更此樣式中所有 Reel 的預設值。若只想調整單一 Reel,請使用 /reels-engine:reel(「移動這個 Reel 的字幕」) -
設定預設樣式: 將
HOME/brand-kit.json中的default_style設為該樣式的名稱。保留其他所有鍵值不變。 -
刪除: 先確認(「刪除故事樣式?此操作無法復原。」)。絕對不要刪除使用者唯一的一個樣式。如果該樣式是預設樣式,請詢問使用者要將哪個樣式設為新的預設樣式,並進行設定。
-
以另一種樣式重新渲染最後一個 Reel: 在最新專案的
cut-list.json中設定style,然後執行ENGINE finish "PROJECT"。
規則
- 範例會播放使用者最新 Reel 的幾秒鐘內容。若尚無 Reel:
ENGINE sample會顯示相關提示。請告知使用者樣式已儲存,他們將在他們的第一個 Reel 上看到效果,並使用選擇器來調整字型、字幕外觀與顏色。 - 產生範例大約需要 30 秒。請在執行前先告知使用者。
- 此版本沒有全螢幕單字瞬間效果。如果使用者問起,請直接告知。
- 鉤卡(Hook card)的外觀,以及 Reel 是否以鉤卡開頭,都會記錄在樣式中,儲存為
hook: { preset, on }(請參閱references/style-file.md)。成員通常會在 /reels-engine:reel 中傳送至 Claude 後的畫面上進行選擇,因此僅在使用者要求變更預設鉤卡外觀時,才在此處進行設定。 - 樣式名稱應保持簡短、小寫、使用連字符(kebab-case),並與檔案名稱一致。