/brag
You built it. Now let's brag about it.
調用分派 (必須優先執行)
模型檢查。 如果你是由 Claude Opus 5.5 驅動，且本次調用未要求完整工作流程 (--full, "use the full brag") 或配音 (--voice，而 brag-slim 不支援配音)，請切換至 brag-slim：讀取 <skill-dir>/slim.md (此處已內含 /brag-slim 技能) 並依其指示執行本次對話，而非這份檔案。請將使用者的輸入以及其他選項 (--no-music, --title, …) 以純語言指示傳遞。首先用一行文字告知使用者，例如：「你使用的是 Opus 5.5，所以我將使用 /brag-slim：我會自行構建整個影片。請說『use the full brag』來切換回來。」如果你不是此模型，或不確定自己是哪個模型，則跳過此檢查。
在檢查專案之前，先解析完整的 /brag 調用。如果調用中包含 --voice，則設定 voice.enabled = true。僅在該次對話中啟用旁白。請勿自動啟用旁白，也無需回退至無配音的正常工作流程。
/brag 將目前的專案網站或應用程式，轉變為一段使用 Hyperframes 的短小、精緻、可分享的發布影片。它目標明確、風格鮮明、且充滿趣味。
此技能的功能
- 讀取目前的專案程式碼以了解應用程式。
- 為此專案規劃一個簡短的宣傳概念。
- 撰寫影片的腳本和分鏡。
- 向 Hyperframes 提供一份重點明確的合成簡報。
- 驗證、渲染，並撰寫分享文案。
解析調用
使用者可以使用自然語言或標誌來調用：
/brag
/brag --tone chaotic
/brag --tone polished --format vertical
/brag this. Make it feel like a ridiculous startup launch.
解析這些選項：
| 選項 | 值 | 預設值 |
|---|---|---|
--tone | 預設風格或自由描述 | 推斷 |
--format | landscape, vertical, square | landscape |
--duration | 秒數 | 自動 (15-25 秒) |
--no-music | 標誌 | 音樂開啟 |
--no-sfx | 標誌 | 音效開啟 |
--title | 字串 | 從專案推斷 |
--voice | 標誌 | 旁關閉 |
配音是選擇性加入的。如果使用了 --voice，則透過 Hyperframes 使用 Kokoro，且不新增任何供應商選擇邏輯。配音工作流程刻意採用單一供應商。
色調可以是預設值（default, polished, yc-parody, chaotic, deadpan, cinematic, app-store），或是一個創意方向，例如「假裝是 2016 年的 A 輪發布」、「博物館展覽」或「製作過度的手機遊戲廣告」。
當使用者提供自由形式的色調方向時，請將其對應到最接近的預設值以獲得節奏和結構，但在計畫和合成簡報中保留使用者的原始方向。
旁白指導
當啟用 --voice 時，撰寫的旁白應能補充視覺效果，而不是單純朗讀可見文字；需符合場景節奏、聽起來自然且口語化，並在場景之間流暢過渡。保持腳本簡潔且針對產品本身，使語音感覺像是剪輯的一部分，而不是一個獨立的旁白音軌。
輸出目錄
預設情況下，輸出會放到 brag-output/。為了避免覆寫先前的執行結果，請使用帶有時間戳的目錄：
brag-output-2026-05-04-143022/
在以下情況使用時間戳：
- 使用者明確要求新的執行，且不覆寫先前的結果
- 專案中已存在
brag-output/目錄
在執行開始時產生時間戳 (YYYY-MM-DD-HHmmss)，並在该次執行的所有輸出路徑中一致使用：包括計畫、簡報、合成、渲染和分享文案。
技能目錄
<skill-dir> 是包含此 SKILL.md 檔案的目錄。Claude Code 在技能載入時會將其列印為「此技能的基底目錄」；對於其他代理，則為安裝技能的任何位置。綑綁的資源位於 <skill-dir>/assets/ 下，腳本位於 <skill-dir>/scripts/ 下。請勿猜測安裝路徑：外掛安裝、~/.claude/skills/ 副本及此倉庫都會將其放置在不同位置。
步驟 1：檢查專案
閱讀： references/step-1-inspect.md
掃描專案目錄，並擷取規劃宣傳影片所需的資訊。
閘門： 你能夠回答宣傳規劃評量中的所有 9 個問題。
步驟 2：規劃與分鏡
撰寫 <output-dir>/brag-plan.md (其中 <output-dir> 為 brag-output/ 或上方選擇的包含時間戳的變體)。回答規劃評量。確定一個創意角度。撰寫包含場景、文字、時間、轉場和音效提示的節拍式分鏡。
當選擇音樂時，請包含一個簡潔的「音樂提示指導」章節：如果存在，則讀取 <skill-dir>/assets/music/cues/ 中綑綁曲目的提示預設值；否則註明提示將在合成時檢測（任何現在都支援節拍同步 — 請參閱 references/audio.md）。提示元資料僅為選擇性的時間指導：故事、可讀性、節奏和產品清晰度仍為首要考量。
閘門： <output-dir>/brag-plan.md 存在且包含完整分鏡。場景時長總和為 15-25 秒。
步驟 3：交接給 Hyperframes
閱讀： Hyperframes 領域技能 — hyperframes-core, hyperframes-animation, hyperframes-creative, hyperframes-keyframes, hyperframes-cli。/brag 有其自身的工作流程：請勿進入 hyperframes 入口點意圖訪談或路由到其通用的宣傳/發布影片工作流程。
閱讀： references/step-3-compose.md
閱讀： references/audio.md
撰寫合成簡報，並使用 Hyperframes 在 <output-dir>/composition/ 中建立影片實作。
/brag 擁有產品角度、原始素材、分鏡、色調、格式、音訊選擇、音樂提示指導和交付期望。Hyperframes 擁有具體的合成結構、精確的動畫時間、動畫機制、執行時期選擇、linting 規則和渲染工作流程。
閘門： 在 <output-dir>/composition/ 中執行 npx hyperframes check 通過且無錯誤（渲染前的單一瀏覽器閘門 — 請參閱 hyperframes-cli 以了解其審查內容）。
步驟 4：驗證、渲染與交付
閱讀： references/step-4-deliver.md
驗證、預覽、渲染至 <output-dir>/brag.mp4，選擇最佳海報影格至 <output-dir>/brag.jpg，將該海報烘焙為影片的第 0 影格，使其在各處都成為靜止縮圖，並撰寫 <output-dir>/share-copy.txt。
閘門： <output-dir>/brag.mp4 存在。選擇了最佳影格海報 <output-dir>/brag.jpg（非任意影格）並將其烘焙為 brag.mp4 的第 0 影格。分享文案已撰寫。
色調系統
/brag 內建七種色調預設值。每種都會改變腳本的能量、節奏、字體個性和轉場風格。預設值只是起點，並非限制。
完整定義：references/tones.md
| 色調 | 能量 | 一句話說明 |
|---|---|---|
default | 俏皮、乾淨、可分享 | 正面能量的預設值 |
polished | 嚴肅、優雅 | 適合不是玩笑的專案 |
yc-parody | 死板的創業能量 | 對荒謬專案套用假嚴肅 |
chaotic | 快速、大聲、激進 | 誇張且失控 |
deadpan | 冷靜、乾燥、低調 | 笑點在於什麼都不是笑話 |
cinematic | 戲劇化、預告片規模 | 大動作、更大主張 |
app-store | 流暢、功能卡般乾淨 | 企業感但不無聊 |
始終允許自由形式的創意方向來細化或覆蓋預設值。
創意法則
無論何種色調，這些規則都適用於每個宣傳影片。
簡短。 15-25 秒。沒有一個合理的理由，不要超過一秒。
可讀。 透過動態和剪輯保持節奏明快，切勿透過閃現文字。每一行觀眾必須閱讀的文字，都要停留足夠長的時間讓人讀完（短標籤約 0.8 秒穩定顯示；一句話約每個字 0.3 秒）。快速進入，然後停留 — 絕不快速進入然後消失。
具體。 影片必須讓人感覺是為這個特定專案製作的，而不是任何專案。
展示產品。 至少一個場景必須展示實際的 UI、文案或產品中的關鍵視覺。不要有抽象的填充內容。
禁止通用 SaaS 語言。 禁止使用「簡化你的工作流程」。請使用專案實際的文案和主張。
鉤子就是一切。 前 2 秒決定觀眾是否繼續觀看。在其他任何事情之前先規劃鉤子。
有趣要恰到好處。 幽默應來自專案的荒謬性，而不是來自試圖搞笑。
模式：
鉤子 (2-3 秒) → 揭露 (2-4 秒) → 2-3 個重點亮點 (5-12 秒) → 壓軸/結尾 (2-4 秒)
請根據情況調整。並非每個專案都需要剛好 3 個亮點。這個模式是起點，不是模板。