/new-edit-style
輸入參考影片，輸出一個已鎖定的 /<style>-edit 技能，讓之後每次剪輯都能呈現參考影片的風格。
這是打造 /kallaway-edit 的流程，已被詳實記錄並優化。使用此技能的人通常不具備技術背景：請使用簡單明瞭的英文、每個步驟只傳送一則簡短訊息，絕對不要讓他們碰觸程式碼。
SK = ${CLAUDE_SKILL_DIR}，此技能所在的資料夾。ENGINE = ${CLAUDE_SKILL_DIR}/../kallaway-edit，
它是已驗證的剪輯引擎（包含設定精靈、轉錄、剪輯、去背、音效、建置、渲染與品質檢查）。
請勿寫入 SK 或 ENGINE：更新時兩者都會被取代。
DATA = $HOME/.claude-video-editor，剪輯器的專屬資料夾（可保留設定、Python、音效、字型快取等）。
ROOT = 專案資料夾（記錄在 DATA/config.json 中的 projectRoot）。
請務必透過下列其中一種方式執行所有腳本，以確保能讀取使用者的設定：
PY = VIDEO_EDITOR_DATA="$HOME/.claude-video-editor" "$HOME/.claude-video-editor/venv/bin/python" -I
SYS = VIDEO_EDITOR_DATA="$HOME/.claude-video-editor" python3 -I（在設定精靈執行前使用）
STYLE = 簡短的 kebab-case 名稱（例如 "kallaway"）。SDIR = ROOT/references/<STYLE>/。
WORK = ROOT/work/new-edit-style/<STYLE>/（進度 PNG 會存放在 WORK/progress/ 中，並以數字編號）。
嚴格規則
- 僅使用免費工具（ffmpeg、Python、faster-whisper、HyperFrames、OFL 字型）。不使用付費 API，也不需要登入。
下載參考連結時必須以未登入狀態進行（
yt-dlp --no-cookies）；絕對不能使用瀏覽器的 cookie。 - 絕對不能碰觸使用者的原始檔案；絕對不能刪除任何東西（將舊版本移至
ROOT/archive/）。 - 絕對不能執行
npx hyperframes init或npx hyperframes skills；不得新增任何東西到~/.claude/skills或~/.agents/skills。 - 絕對不能將猜測當作測量結果，或將聲音當作聽到的內容。代理人無法「聽到」，由使用者的聽覺驗證來決定。
- 可以複製剪輯風格，但絕對不能將創作者的影片素材、標誌、音樂或文字複製到剪輯中。
- 子代理人：每個參考影片一個（使用 Sonnet 即可），最多同時執行 3 個，並以
references/breakdown-brief.md作為簡報。 所有需要判斷或肉眼觀察的工作，都必須由你親自執行。
工作流程
0. 環境設定（僅首次）
如果 DATA/config.json 中缺少 "setupComplete": true，請先執行剪輯器的設定精靈：調用
kallaway-edit 技能並傳入參數 setup（或閱讀 ENGINE/SKILL.md 的步驟 0，其中
${CLAUDE_SKILL_DIR} 代表 ENGINE，$HOME/.claude-video-editor 代表 DATA）：檢查 Claude Code、
檢查工具、建立專案資料夾、安裝。如果 ENGINE 不存在，請顯示："本技能需要 kallaway-edit 技能安裝在旁邊（它提供剪輯引擎）。
請從 https://github.com/learnaiwithhugo/video-editor-skills 重新安裝兩者，然後再次執行 /new-edit-style。"
然後停止。此技能也需要 yt-dlp（用於下載參考影片），因此請務必在首次執行及後續執行時，使用
SYS "ENGINE/scripts/setup.py" --check --for new-edit-style 檢查。如果缺少 yt-dlp，
請提供修復指令給使用者（在終端機應用程式中貼上 brew install yt-dlp），等待使用者回報完成後再次檢查。
1. 輸入（約 2 分鐘）
一次發送一則訊息：「請傳送 2 或 3 個來自同一創作者的影片（連結或檔案），你想學習他們的剪輯風格，
最好是你最喜歡的幾部作品，並提供一個簡短的風格名稱。」3 部影片是最理想的：規則來自它們共有的特徵。然後：
SYS "SK/scripts/fetch.py" STYLE "ROOT" <link 或 file> ... -> SDIR/STYLE-1.mp4 ...
顯示：「已取得。現在開始逐幀測量（約需 2 分鐘）。」
2. 前置處理，全部自動化腳本執行（每部影片約 30 秒）
PY "SK/scripts/prep.py" "SDIR" SDIR/STYLE-*.mp4
在 SDIR/prep/<reel>/ 中，每部影片會產生：逐字時間戳記轉錄、每幀剪輯掃描、含時間戳記的 4fps 聯絡表、
全尺寸靜態畫面、頻譜圖、立體聲效擊點、音量，以及 fingerprint.json（測量到的風格數值）。
此外還有 SDIR/style-check.png 和 SDIR/style-spec.json。
現在請查看 style-check.png。 如果其中一部影片明顯與其他影片的風格不符（不同的版面配置、字幕、顏色），
請告知使用者並要求更換，然後再花費代理人資源。將此圖複製到 WORK/progress/01-style-check.png。
3. 分解，每部影片一個代理人，平行執行（約 15 分鐘）
為每部影片填寫一次 references/breakdown-brief.md，然後在單一則訊息中啟動所有代理人。
每個代理人會寫入 SDIR/prep/<reel>/edit-log.md。在他們執行時，請進行步驟 4 的字型比對。
4. 字型比對（約 20 秒）
PY "SK/scripts/font_match.py" SDIR/STYLE-1.mp4 SDIR/prep/STYLE-1/transcripts/STYLE-1.words.json "SDIR/font"
查看 font-match.png：獲勝字型必須在視覺上相符。如果前兩名差距在 0.01 以內，請對第二部影片再次執行。
（Kallaway：Archivo 800 在 -0.045 em 處得分 0.773，高於 Helvetica Neue Bold 的 0.759。）
5. 合併為風格指南（由你執行，約 10 分鐘）
遵循 references/merge-guide.md：共識規則、測量數值、一份由你親自查看的關鍵幀表，以及拍攝章節。
輸出 SDIR/STYLE-style-guide.md + SDIR/STYLE-key-frames.png。
為使用者開啟關鍵幀表，並提供一段摘要（約一段話）。
6. 製作風格技能（約 2 分鐘 + 你的改寫，約 30 分鐘）
SYS "SK/scripts/make_style_skill.py" STYLE "SDIR" --title "顯示名稱"
它會將已驗證的引擎（ENGINE，位於此技能旁邊）複製到 ROOT/.claude/skills/STYLE-edit/：
一個位於使用者影片資料夾內的專案技能，而非全域技能資料夾，如此更新時才不會影響它。
複製的版本會共用 DATA（不需要第二次安裝）。它會新增比對工具（scripts/match/）、根據測量規格寫入 style.json，
並印出需要根據風格指南改寫的風格檔案清單（SKILL.md 風格規則、style-rules.md、graphics-recipes.md、
sound-map.md、filming-guide.md、kit CSS/JS，以及僅在風格有不同版面配置時的 build.py 版面配置）。
改寫清單上的每一項。引擎腳本保持不變，除非版面配置需要修改。
7. 鎖定風格（約 45-60 分鐘）
遵循 references/lock.md：在使用者的影片素材上進行測試剪輯 -> 匹配分數 -> 修正 -> 黃金再現
參考視窗 -> 修正 -> 一輪評論 -> 聽覺驗證 -> 簽核。將每個數值記錄在 STYLE-edit/references/lock-log.md。
8. 交付
告知使用者：新的指令（/STYLE-edit，每當在 ROOT 中開啟 Claude Code 時即可使用；如果尚未出現，
請在該處重新啟動 Claude Code）、用一段話說明其功能、匹配分數與黃金數值、如何為此風格拍攝影片（從拍攝章節摘錄 3-4 個要點），
以及仍然無法匹配的部分。
計時（在 M4 Pro Mac 上，3 部約 1.5 分鐘的影片）
擷取 1 分鐘 · 前置處理 1.5 分鐘 · 分解 15-18 分鐘（平行） · 字型比對 20 秒 · 合併 10 分鐘 · 製作技能 2 分鐘 + 改寫 30 分鐘 · 鎖定 45-60 分鐘。總計約 2 小時，大部分時間花在代理人與渲染上。
檔案
scripts/：fetch.py、prep.py、fingerprint.py（測量/規格/分數）、font_match.py、golden.py、
make_style_skill.py、engine.py（尋找 ENGINE）。references/：breakdown-brief.md、merge-guide.md、
lock.md。templates/：style-rules.md、graphics-recipes.md、lock-log.md（會複製到新的風格技能中）。