xiaobai987-sxy/inkroom-promo-video-skill

Inkroom 產品宣傳影片

建立一個可重複使用的 Inkroom 產品影片，作為配套工作流程。預設配方為 XiaoMo 第一人稱視角、16:9 橫向、Seedance 優先畫面、產品證據使用真實錄製內容、以及 HyperFrames 進行確定性組裝。配方可配置；未經與當前成品比對，絕不複製先前專案的持續時間、鏡頭數量、用詞或核准狀態。

運作合約

• 區分 film_subject=Inkroom 產品 與 production_workflow=幕後製作。歷史元影片任務不得成為產品拷貝。
• 將產品主張分類為 confirmed（已確認）、user_decision（使用者決定）、inference（推論）或 pending（待定）。在參考歷史 README 或舊任務檔案前，務必先閱讀當前產品事實與活躍交接文件。
• 生成的圖像可解釋概念，但不得冒充 Inkroom UI、目錄、API 文件、價格、檔案、資料、標誌或真實證據。這些主張應使用真實錄製內容。
• received（已接收）不等於 approved（已核准）；佔位符絕非核准的鏡頭；已核准的來源絕不靜默被覆寫。
• 每個改變方向的閘門都等待使用者明確確認。檔案存在絕不推動閘門前進。
• 預設交付物止於使用者核准的預覽、渲染的 MP4 及本地下載。絕不自動發佈。

啟動與恢復

1. 定位專案根目錄，讀取 BRIEF.md、活躍交接文件、workflow/state.json、活躍組合檔及最新 QA 報告。若有過時文件應發出警告，而非視為事實。
2. 若無狀態存在，使用 scripts/init_project.py 初始化；不得推斷核准狀態。
3. 從記錄的階段恢復。不重複已核准的工作，也不將已接受的能力當作新功能提議。
4. 維護一份正典交接文件，加上機器可讀的狀態、清單、資產分類帳與 QA 報告。

狀態機與閘門

請嚴格使用以下階段：

intake -> facts_locked -> outline_review -> copy_review -> script_review -> storyboard_review -> frames_review -> seedance_package_ready -> awaiting_external_returns -> per_shot_received -> per_shot_approved|per_shot_rejected -> assembly_preview -> audio_review -> qa_pass -> user_render_approval -> rendered_downloaded -> publish_ready

專案可能從被拒絕的鏡頭分支回其自身的畫面/提示/生成審查。更改狀態前請先閱讀 references/workflow-state-machine.md，並使用 scripts/state.py 進行狀態轉換。

階段路由

• 事實與大綱： 重新整理產品事實；僅將 marketing-skills 視為候選研究輔助工具。在文案鎖定前，先確認目標受眾問題與證據缺口。
• 文案、劇本、分鏡： 使用已確認的文案以及「每鏡頭完整動作」規則。screenwriting-skills 可協助結構，但絕不匯入 Ottermind 特定內容。請閱讀 references/product-evidence-policy.md。
• 畫面： 當可用時使用 imagegen 或 image-2，搭配已核准的角色表與風格錨點。保持畫面無文字且為橫向。
• Seedance： 使用 seedance1 將已核准的分鏡單元轉換為獨立提示與交接套件。若有授權的影片模型可用，僅在使用者核准後方可直接生成；否則等待手動外部回傳。請閱讀 references/seedance-review-checklist.md。
• 回傳： 依 shot_code 與 take 比對；獨立檢查每個剪輯；按鏡頭核准或拒絕。不得以凍結畫面或隱藏修剪來修復失敗的生成。
• 組裝： 使用 hyperframes、hyperframes-core、general-video 與 hyperframes-cli。每個已核准的 Seedance 來源從來源時間零點播放一次；僅疊加字幕/事實標籤，並以真實錄製內容取代佔位符。請閱讀 references/hyperframes-assembly-rules.md。
• 媒體： 使用 media-use 處理語音、背景音樂、音效、字幕與來源。預覽 TTS/音樂必須攜帶授權狀態。
• QA 與交付： 執行專案驗證器、hyperframes check --strict、快照及 FFmpeg/ffprobe 檢查。僅在使用者核准預覽後才進行渲染。請閱讀 references/release-checklist.md。

標準產出

每個專案應產出（若適用）以下內容：BRIEF.md、workflow/state.json、workflow/PRODUCT_FACTS.json、OUTLINE.md、COPY.md、SCRIPT.md、STORYBOARD.md、INKROOM_VIDEO_COMPLETE_HANDOFF.md、seedance/*manifest.json、Seedance ZIP 壓縮檔、ASSET_LEDGER.md、QA-REPORT.md、Studio 預覽網址，以及已核准的 MP4 路徑。

記錄每個階段的工具、狀態（used（已使用）、candidate（候選）或 blocked（封鎖））、授權與邊界。在接受套件或回傳鏡頭前，請使用 scripts/validate_manifest.py 進行驗證。