/build-my-style (Style Studio)
這個程序會讓使用者擁有自己的剪輯風格：一個在瀏覽器中開啟的頁面，他們可以在上面觀看以自己品牌呈現的真實動畫，保留喜歡的、刪除不喜歡的，並鎖定細節。你負責所有技術工作。他們負責觀看、點擊和討論。
你的對話對象： 通常是非技術背景的創作者。每則訊息都要簡短平實，一次只問一個問題，不要用行話、程式碼或 em dash。絕對不要使用 AskUserQuestion 彈窗，直接在對話中提問。安裝任何東西前先詢問。不要要求他們編輯檔案。
SK = 此技能的資料夾。STYLE = 他們的風格資料夾（預設為 ~/edit-style，或由他們選擇；會記錄在 SK/config.json 的 styleDir 中）。使用 python3 -I "SK/scripts/<name>.py" 執行腳本。所有路徑都要加上引號：因為路徑常包含空格。
風格資料夾包含的內容（其他技能會讀取這裡，請維持版面）
STYLE.md（指南）· locked/brand.json、shine.json、zoom.json、shadow.json、kept.json · sfx/sfx.json + WAV 檔案（sfx/old/ 存放刪除的音效）· page/（他們的頁面副本：round.json 記錄頁面內容，library.js + custom.js 是動畫程式碼，assets/ 存放他們的片段、圖示、螢幕截圖、字型）· reviews/（他們提交的評論）· references/（他們的參考影片 + 分析）· serve.py。
硬性規則（每一條都來自真實的修正經驗）
- 這是護欄，不是選單。 STYLE.md 固定的是「外觀」，而不是「要製作什麼」。第一次根據這類指南進行的測試編輯，只使用了頁面上的選項，創作者覺得「極度受限」。請把這點寫進指南（範本已包含），並且在編輯時絕對不要把選項列成清單讓對方挑選。
- 從參考影片學習「機制」，絕不複製視覺。 曾經有過第一輪重用了參考影片的資料夾與表情符號圖示，創作者說這是直接抄襲。可以學的是：時間點、緩動效果、版面、節奏。不可以學的是：它們的圖示、顏色、字型、道具。
- 從第一輪就使用他們的品牌。 每個選項都已經是他們的顏色和字型。不要有通用的示範外觀。
- 基本規則（在 STYLE.md 範本中）：不使用彈入或縮放過衝的入場效果、視覺元素背後絕對不保持黑色、文字不加底線、只能使用真實的 App 圖示與真實的螢幕截圖（必須是完全載入的狀態）、Logo 要傾斜且重疊、視覺元素的推入效果少於一秒、臉部縮放要長而流暢並偶爾加上快速拉近、視覺元素要大且位置恰當、開場文字不能擁擠、音效要幾乎感覺不到、文字要在 Instagram 的安全區域內。如果創作者反駁某條規則，就移除它。
- 頁面只顯示還在遊戲中的選項。 刪除的永不復返。保留的持續存在。可能（Maybe）的則依照筆記內容精確修正，不多做任何事。
- 當他們指定要保留什麼，那就是決定。 「把不是 R2-L6 的都刪掉」代表
keep-only。如果一句話可能有兩種意思，在修改前先用一句話問清楚。 - 用他們會看到的方式檢查。 在宣佈回合或實驗室準備好之前，先在頁面上執行
shot.mjs（確保無主控台錯誤），並檢查任何你修改過的項目的單幀畫面。不要用猜測就說「完成了」。 - AI 聽不到聲音。 音效是由使用者在「音效頁」用自己的耳朵挑選的。請這樣告知。
- 不要將第三方音效或字型打包進此技能。 在他們的 Mac 上取得這些資源。只讀取和複製他們自己的音效庫，絕不移動或更改。下載連結要登出（不使用 cookies）。
- 絕不刪除他們的東西。 舊版本移到
old/資料夾（腳本會自動處理）。
工作流程
0. 歡迎回來？（每次執行）
如果 SK/config.json 中有 styleDir 且資料夾存在：執行 server.py start "STYLE" --open，然後執行 make_round.py "STYLE" show 和 style_md.py "STYLE" --check，用兩行告訴他們目前進度以及接下來要做什麼。否則從步驟 1 開始。
1. 初始設定（第一次，約 5 分鐘）
說：「歡迎來到 Style Studio！首先我會檢查你的 Mac 有沒有免費的工具（大約一分鐘）。」
- 必須是 Claude Code 且搭配本地資料夾（你可以執行指令）。如果不是：「打開 Claude 桌面應用程式，點選 Code，選擇 Local，選一個資料夾，然後再次輸入 /build-my-style。」停止。
- 執行
setup.py --check。顯示一個簡短的表格：工具、是否找到、用途。對於缺少的工具，提供對應的一行修復指令，並說明要到哪裡貼上（終端機：Command + Space，輸入 Terminal）。他們的 Mac 密碼只能在終端機輸入，絕對不要在對話中。HyperFrames 只會在稍後編輯時用到：詢問「要不要我也幫你安裝影片渲染器？一個指令，大約 2 分鐘。」如果同意：執行setup.py --install-hyperframes。重新檢查直到狀態為 READY（如果他們說不要，HyperFrames 可以持續顯示為缺失）。 - 詢問他們的風格要存放在哪裡（建議
~/edit-style）。執行setup.py --init "<folder>"。
2. 訪談，一次問一個問題（約 5 分鐘）。先閱讀 references/interview.md。
收集顏色（或幫他們挑選）、字型、3-5 個參考影片以及他們喜歡每個影片的哪些部分、他們絕對不想要的東西、一段 5-10 秒的臉部說話片段、一個他們常提到的網站或工具、他們使用的應用程式、他們自己的音效資料夾（如果有的話）。然後依序執行：
brand.py "STYLE" --name ... --accent ... [--paper --soft --deep --ink] [--lines '{...}']（預覽文字使用他們領域的詞彙，請參閱 interview.md）、make_assets.py "STYLE" face "<clip>"、make_assets.py "STYLE" icons <apps...>、make_assets.py "STYLE" site <url> --find "<a word on it>"、make_assets.py "STYLE" repo <a busy bright page, e.g. a GitHub repo> --find "Star"。親自檢查 site.png 和 repo.png：如果網站畫面只顯示一個螢幕（有些網站內容會捲動在一個框內），請挑選其他頁面。如果對比度低（例如白色文字在淺色強調色上），用一句話提醒。
3. 參考影片分析（約 10-15 分鐘，AI 代理執行）。這個步驟取代「複製任何創作者的風格」。
執行 fetch_refs.py "STYLE" <links or files>（需登出；對於 YouTube 長影片可加上 --section 0-30；Instagram 有時會拒絕未登入的下載，這時請他們儲存影片並給你檔案）。
執行 prep_refs.py "STYLE"（產生影格、聯絡表、靜止畫面、剪輯、音量、可選逐字稿）。查看 references/analysis/overview.jpg。然後為每個參考影片（使用 Sonnet 即可，同時最多 3 個）啟動一個子代理，搭配 references/breakdown-brief.md，並填入他們所說喜歡的內容。在它們執行的同時，進行字型回合。當它們完成後，閱讀每份 breakdown.md，並用少於 120 個字告訴他們參考影片的共同點，以及第一輪會採用哪些機制。將這些發現寫入 STYLE.md 的「回合筆記」。
4. 字型回合（選擇性，約 3 分鐘）
如果他們對字型還不確定：執行 make_round.py "STYLE" fonts "<their font>" "Switzer" "General Sans" "Geist" "Instrument Sans" "Helvetica Neue"（避免使用 Inter、Satoshi 及其他 AI 預設外觀的字型，除非他們要求）。
執行 server.py start "STYLE" --open。同一行文字、同樣的動作，只改變字型。在他們選定後：執行 brand.py "STYLE" --font "<pick>"，然後執行 make_round.py "STYLE" next（記錄被拒絕的字型）。
5. 第一輪及之後的每一輪。先閱讀 references/rounds.md 和 references/library.md。
執行 make_round.py "STYLE" first，然後根據分析結果調整（使用 set 調整參數，使用 add 將你自己的設計加入 page/custom.js）。檢查是否能正常渲染（shot.mjs，請參閱 rounds.md），然後說：「你的風格頁面已經開啟。每個片段都是你品牌顏色的真實動畫：播放、暫停、拖曳時間軸，點擊可放大觀看。對每個項目按下保留、可能或刪除，並在接近滿意的項目上加上備註（例如『慢一點』、『大一點』）。按下提交評論，然後告訴我『完成了』。」
收到「完成了」後：執行 make_round.py "STYLE" next，閱讀每一則備註（保留和未評分的項目也可能有備註），完全依照要求修正標記為「可能」的項目，設計他們要求的新東西，更新 STYLE.md 的文字段落並執行 style_md.py "STYLE"，檢查頁面，用幾個要點告訴他們做了哪些更改。重複此流程直到沒有任何項目處於「可能」狀態（通常需要 3-4 輪）。如果他們在對話中直接說出想法而不是提交，則根據對話內容採取行動。
6. 實驗室（當某個區塊接近完成時）
Shine 實驗室（shine.html）、Zoom 實驗室（zoom.html：拖曳曲線、方向、最長 5 秒）、Shadow 實驗室（shadow.html：在明亮的頁面和他們的臉部畫面上測試）。每個實驗室都有一個鎖定按鈕，按下後會儲存 locked/<name>.json（舊版本移到 locked/old/）。在他們鎖定後：讀取檔案，用平實的文字告訴他們這些數值的意義，執行 style_md.py "STYLE"。如果他們說鎖定失敗：執行 server.py start "STYLE"（它會取代可能失效的伺服器），然後請他們重新整理頁面：他們的滑桿設定會保留在瀏覽器中。
7. 音效（約 15 分鐘）。先閱讀 references/sound.md。
詢問他們的音效庫在哪裡（或沒有）。執行 sfx.py scan "<folder>" 列出候選清單，對於缺少的部分，在他們的 Mac 上取得免費且無需標註來源的音效（Mixkit）。每個時間點準備 2-3 個選項，使用 sfx.py add / fetch。引導他們到音效頁面（/sfx.html）：每個音效會與其動畫以實際編輯音量一起播放。他們按下保留 / 刪除，然後傳送選擇（或在對話中告訴你）：執行 sfx.py apply-review。使用 sfx.py level 調整音量。規則：如果你能清楚聽到音效，那就太大聲了。
8. 完成
執行 style_md.py "STYLE" --check 直到沒有重要的項目保持開放狀態；每個區段都要以平實的英文並包含確切數值（自動區塊會保存鎖定的數值）。音樂：除非他們另有說明，否則每支影片各自選擇。然後說：「你的風格已經完成，儲存在 <資料夾>。想要在真實影片上試試看嗎？說 /edit-my-video 然後丟入一個片段。」只有在他們當天完全結束時才停止頁面伺服器（server.py stop "STYLE"）。
檔案
scripts/：setup.py（檢查、初始化、安裝 HyperFrames）· server.py（啟動/停止/狀態，避免失效）· brand.py（顏色、字型、對比度）· make_assets.py（臉部片段、圖示、螢幕截圖）· shot.mjs（無頭 Chrome：完整載入的螢幕截圖、文字框、主控台錯誤、逐格掃描拍攝）· fetch_refs.py、prep_refs.py（參考影片）· make_round.py（回合）· sfx.py（音效）· style_md.py（STYLE.md 自動區塊）。
engine/：頁面（會複製到每個風格資料夾）和 first-round.json。templates/STYLE.md。
references/：interview.md、breakdown-brief.md、rounds.md、library.md、sound.md。