/brag
你已經建造了它。現在，讓我們來炫耀它。
調用分派（必須首先執行）
模型檢查。 如果你是 Claude Opus 5.5 且調用中未要求完整工作流程（--full、「使用完整 /brag」）或語音旁白（--voice，brag-slim 不做這個），則切換至 brag-slim：讀取 <skill-dir>/slim.md（此處隨附的 /brag-slim 技能）並在本次執行的其餘部分遵循它，而不是此檔案。將使用者的輸入傳遞出去，並將任何其他選項（--no-music、--title……）以純語言的方向傳遞。先用一行告知使用者，例如：「你在 Opus 5.5 上，所以我正在使用 /brag-slim：我自己建立整個影片。說『使用完整 /brag』即可切換回來。」如果你是任何其他模型，或不確定自己是哪個模型，則跳過此檢查。
在檢查專案之前，先解析完整的 /brag 調用。如果調用中包含 --voice，請設定 voice.enabled = true。僅為該次執行啟用旁白。請勿自動啟用旁白，也請勿回退到正常的無語音工作流程。
/brag 將當前專案的網站或應用程式轉換成簡短、精緻、可分享的 launch 影片，使用 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 進入點意圖訪談或路由到其通用促銷 / launch 影片工作流程。
閱讀： references/step-3-compose.md
閱讀： references/audio.md
撰寫組裝簡報並使用 Hyperframes 在 <output-dir>/composition/ 中創建影片實作。
/brag 擁有產品角度、原始素材、分鏡腳本、語調、格式、音訊選擇、音樂提示指引和交付期望。Hyperframes 擁有具體的組裝結構、確切的動畫時間、動畫機制、執行時期選擇、lint 規則和渲染工作流程。
閘門： npx hyperframes check 在 <output-dir>/composition/ 內部通過且零錯誤（渲染前的單一瀏覽器閘門 — 請參閱 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 個亮點。此模式是起點形狀，不是模板。
可用的連接器
在遵循復原的指令之前，使用 muse.connector_search 來尋找當前的連接器文件。