git:20261023.5cfcda0 to git:20261023.284d8a8

27 added, 24 removed. Audit A to A.

---
name: shanshiba-drama
- description: AI 短劇編劇(源自「山獅霸的多重宇宙」頻道)。當使用者要「寫短劇劇本」「寫一支短片」「想個劇情」「設計橋段」「改台詞」「加個反轉」「審一下這個劇本」「把劇本切成鏡頭」,或提供故事前提要發展成 30 秒到 2 分鐘的 AI 短劇時,請一定要使用此技能。產出 16:9 橫式、單支獨立成篇、可直接用本機 MiniMax H3 生成的劇本與鏡表(每鏡 ≤12 秒)。
+ description: AI 短劇編劇(源自「山獅霸的多重宇宙」頻道)。當使用者要「寫短劇劇本」「寫一支短片」「寫下一集」「想個劇情」「設計橋段」「改台詞」「加個反轉」「審一下這個劇本」「排鏡表」,或提供故事前提要發展成 1–3 分鐘 AI 短劇時,請一定要使用此技能。產出可直接交給首幀生圖+本機 MiniMax H3 生成的劇本、鏡表與生成前試映(16 宮格分鏡草圖+讀本)。
---
# AI 短劇編劇
- > **本 repo 版本說明(2026-10-07 更新,優先於 references 裡的舊說法)**
- > - 影片模型是**本機 MiniMax H3**:每鏡 4–12 秒、對話與換場靠切鏡;references 裡「Seedance 2.5、每段 30 秒」的說法一律改讀成「H3、每鏡 ≤12 秒」,`segmentation.md` 的 30 秒片段表改成**鏡表**(每鏡:景別、誰在畫面、動作、台詞、秒數)。
- > - 角色是**你自己的角色**:references 提到的「山獅霸」與 `角色資產/山獅霸/角色設定.md` 是原頻道的例子,本 repo 沒附。請先照 `docs/07_本地角色與首幀.md` 做好角色定妝照,把每個角色的外觀描述(年齡、臉、髮型、眼鏡、上衣與下半身)寫進你專案的角色設定檔,劇本與提示詞都引用它。
- > - 配音:2026-10-23 起畫面內台詞預設**由 H3 拿角色參考音自己念**(一鏡一位說話者,兩人對話拆單人鏡);**BreezyVoice**(`C:\AI\tools\make_breezyvoice.cmd`)是備案,不是 voice-clone 技能。台詞避免單一個字(「考。」「接!」改成兩三個字)、避免數字日期和大陸/台灣用詞不同的字眼(H3 會改用詞)。
- > - 寫完劇本後的製作流程看 `docs/02_端到端流程.md`;技術限制看 `docs/03_規則與踩坑.md`。
+ > **本 repo 版本說明(2026-10-23 更新,優先於 references 裡的舊說法)**
+ > - 角色是**你自己的角色**:references 提到的「山獅霸」「阿福」「〈AI研習宇宙〉」是原頻道的例子,本 repo 沒附角色資產。請先照 `docs/07_本地角色與首幀.md` 做好角色定妝照與參考音,把每個角色的外觀描述(年齡、臉、髮型、眼鏡、上衣與下半身)寫進你專案的角色設定檔,劇本與提示詞都引用它。
+ > - 影片模型是**本機 MiniMax H3**(每鏡 ≤12 秒);製作流程看 `docs/02_端到端流程.md`,技術限制看 `docs/03_規則與踩坑.md`。
+ > - 首幀:原頻道用 OpenAI Image 2.5(`tools/img25.py`);全本地做法見 `docs/07_本地角色與首幀.md`。
## 開工前必讀(不可跳過)
- 1. 你專案的角色設定檔(每個角色的外觀、聲音、個性;原頻道的範例是 `角色資產/山獅霸/角色設定.md`,本 repo 未附)
- 2. 本 repo 的 `docs/03_規則與踩坑.md`(技術約束)與專案 `CLAUDE.md`
-
- 角色外型與提示詞一律**引用設定檔**,不要在劇本裡每次重寫不同版本的角色描述。
+ 1. 你專案的角色設定檔(外觀、聲音、表情)。角色外型一律**引用設定檔**,不在劇本裡自己重寫。
+ 2. 抓馬與節奏:`references/drama-hooks.md`(四種差、20 個模式、0–3 秒節奏)。
+ 3. **系列作**:該系列的 `系列設定.md`(=系列聖經)與 `製作規則_累積.md`。每集照做,交付後把新規則補進累積檔。
+ 4. 專案 `CLAUDE.md` 的通用規則與 `docs/03_規則與踩坑.md`。
## 固定規格
| 項目 | 值 |
|:---|:---|
- | 畫面比例 | **16:9 橫式**——不是豎屏,不要套直式構圖邏輯 |
- | 單支長度 | 30 秒–2 分鐘,**獨立成篇**,沒有連續劇集數 |
- | 鏡頭長度 | **每鏡 4–12 秒**(H3 超過 12 秒容易自己切鏡、鏡頭漂移) |
+ | 畫面比例 | **預設 9:16 直式(YouTube Shorts)**;使用者指定才做 16:9 橫式。兩種都要重新生成,**不裁切** |
+ | 長度 | 1–3 分鐘(Shorts 上限 3 分鐘;H3 每鏡多出的空白要修剪) |
+ | 鏡頭 | 首幀 → 本機 H3;**每鏡 ≤12 秒**(超過容易自己切鏡、漂移);沒台詞的過場鏡約 3 秒內 |
| 幀率 | 24 fps |
- | 配音 | H3 拿角色參考音自己念台詞(嘴型與聲音一起生成);念錯抽不出來時改用 BreezyVoice 配音當固定音軌對嘴 |
+ | 配音 | 畫面內角色台詞**預設 H3 自己念+角色參考音**(spec `audio.voice_ref`;一鏡一位說話者,兩人對話拆單人鏡);H3 念錯抽不出來、數字日期難字、精準聲畫同步時,改用 BreezyVoice(`tools/make_breezyvoice.cmd`)固定音軌。讀本試映也用 BreezyVoice。台詞避免單一個字(「考。」「接!」改成兩三個字) |
+ | 觀眾 | **一般人**(系列另有指定就照系列):每個轉折、隱喻都要有一句台詞/旁白或一個畫面講白 |
## 判斷任務
- - **完整一支短片**:讀 `references/workflow.md`,從創作簡報一路走到鏡表。
- - **單點創作**(只要題材/結構/某一場/台詞/反轉):讀 `references/workflow.md` 的對應階段,**只交付使用者指定的成果**,不重做整支。
+ - **完整一支/一集**:讀 `references/workflow.md`,九個階段+生成前試映,**每階段過關卡**(列 3–5 條自檢、等使用者「通過/修改」)才往下。使用者說「一次做完」才跳過關卡,但自檢照做。
+ - **單點創作**(只要題材/結構/某一場/台詞/反轉):讀 `references/workflow.md` 對應階段,**只交付指定成果**。
- **寫劇本或要格式**:讀 `references/format.md`。
- - **拆鏡頭**(劇本已存在):讀 `references/segmentation.md`,但用上面的「鏡表」取代 30 秒片段表。
- - **審閱或修改**(不含單點創作):讀 `references/checklists.md`;需要格式判斷時再讀 `references/format.md`。
+ - **排鏡表**(劇本已存在):讀 `references/segmentation.md`。
+ - **生成前試映**:讀 `references/table-read.md`(`tools/make_storyboard.py`+`tools/assemble_read.py`)。
+ - **審閱或修改**:讀 `references/checklists.md`。
## 共同規則
- 只詢問會實質改變結果的缺漏;其餘採合理假設並**清楚標示**。
- 保留使用者指定的長度、類型、觀眾、場景與交付形式。
- - 優先寫現在正在發生的**可見行動**,避免用說明性對白代替戲劇事件。
- - 每場至少改變資訊、關係、目標、風險或情緒之一。
- - 反轉必須能由前文線索回看成立,而且要**在畫面上交代原因**(觀眾看不懂的反轉等於沒有);結尾要留下餘味或一個問題,不是單純中斷。
- - **技術約束就是寫作約束**:避開快動作/打鬥/追逐;一鏡一個說話者優先;天馬行空放在**設定與情境**,不是動作場面;畫面裡不要靠可讀的文字傳達資訊(AI 會寫錯字,要的話後製疊字)。
- - 使用者只要劇本時,**不輸出**景別、運鏡或 H3 提示詞——那是製作階段(`tools/h3_shot.py`)的事。
+ - 寫**現在正在發生的可見行動**;動作要誇張一點、分鏡多一點(反應鏡、插入鏡、推近、汗珠特寫、全場同步轉頭)。
+ - 每場至少改變資訊、關係、目標、風險或情緒之一;場與場之間是「因為…所以」,不是「然後」。
+ - 反轉必須能由前文線索回看成立,而且**被哪一句台詞或哪一個畫面翻掉要寫得出來**。
+ - **台詞和前後畫面要對得上**:台詞提到的動作先演出來、數量一致、「他/她」指誰看得出來、反應緊接動作。
+ - 節奏明快但不能快到看不懂:轉折後留一拍讓觀眾消化(反應鏡或一句講白)。
+ - 教室戲(原頻道常用):老師不碰學生;黑板在前、學生面向黑板、窗在學生左手邊;上課期間背景要有同學。
+ - 使用者只要劇本時,**不輸出** H3 提示詞、seed、步數——那是製作階段(`tools/h3_shot.py`)的事。
## 輸出契約
- **創作任務**:必要假設 →指定創作成果 →(完整一支短片才附)鏡表。
+ **創作任務**:必要假設 → 主題錨點 → 指定創作成果 →(完整一支才附)鏡表與試映清單。
**審閱任務**:依影響程度排序的診斷、對應具體段落的證據、可執行的修改方向;只有能說明修正或使用者明確要求時才提供改寫。