Was macht AI 漫劇製作（純 Agent 版）?
開工規則（每次都照做，沒有例外）
- 先跑
python scripts/h3d.py next --root <專案>，照它印的「唯一一條指令」做，並先讀它指定的 reference。不要自己排流程或跳步。 - 使用者定案一律
h3d decide <id> <值> --quote "<使用者原話>"寫進decisions.json（畫風、比例、台詞政策、設定圖引擎、驗收政策、剪輯方式…）。不要只寫在筆記裡，也不要替使用者決定。 - 不准手改
review/project-state.json。 狀態只能由build_stage_review.py寫；手改會被h3d next判為阻斷。階段 6 技術 QA 為 PARTIAL、使用者看過仍核准時，用--approve-stage 6 --override --reason "<使用者理由>"。 - 階段 6 逐段結論一律
h3d verdict寫進review/verdicts.json（pass／warn／fail＋一句原因＋證據圖），依acceptance_policy分類。 3a. 生圖後端由使用者選，不自行預設：階段 2 設定圖、階段 4 構圖要出圖前，先h3d imagegen --detect --root <專案>列出偵測到可用的工具（不可用的附原因），請使用者選——只偵測到一個可用也要問；回覆後h3d imagegen --set <後端> [--stage 2|4] --quote "<使用者原話>"。h3d next遇到沒選、或選了但現在不可用時會改成請你詢問（references/tooling.md§2.4.1）。 4a. 要使用者決定的事用h3d inbox產生決策收件匣交給使用者（只列例外）；使用者授權過的階段照h3d next跑h3d approve --auto。階段 0、角色設定圖、每個角色的音色永遠要人決定（見references/tooling.md§2.6）。 - 不同時跑兩個影片 runner；ledger 有 waiting／running 的工作時只收件（
h3d collect），不送新件。 - 遇到
PARTIAL、duration_drift就停下，照references/tooling.md§4 處置並回報使用者，不要自行繞過。 - 成片形式預設＝長篇漫劇：把故事講清楚是第一優先，每個原著關鍵事件都要交代起因→經過→結果（含動機、時地轉換），
不以每集秒數壓縮事件；預設不分集，整部一支連續長片。短劇／竪屏爆款短集（1–2 分鐘、強鉤子）只有使用者明確要求才用
（
h3d decide series_format short）。被壓縮、跳過或交代不全的事件由 Agent 依原著補回（event_coverage.py），不自己砍、也不問使用者。 - 劇本改寫不詢問使用者：一律走
references/adapt/dialogue-first-adaptation.md（原著對白全保留、只轉述的對話可補寫並標invented、旁白＝主角內心聲 VO ≤30%、集長不設限、斷點停在自然故事點並記原著錨點＋理由、交稿前adapt_gate.py全過）。 - 開工前先對一次技能版本：
h3d --version與專案review/project-state.json記的建立版本不一致時，先同步技能再動工。同一個提示詞在不同版本有不同門檻（單句 15→18 字、說話佔比 60%→90%、鏡長下限 2.0→1.2 秒、新增 D2 密度與 D4 開口），拿舊版規則改稿會白做一輪。安裝目錄的 skills 副本不一定是 git repo，來源 repo 在本機時先 pull 再整份覆蓋，覆蓋前先備份。 - 修一輪要批次，不要逐句重簽：同類問題（同一種句型、同一個包的問題）一次改完所有段，再 rebuild →
h3d bind→h3d compile→ 重簽階段 4／5（批次＝先逐鏡對回shot_intent確認是同一個根因，不是按警告類型批量改；階段 5 改過的段照段級核准走--segments，不得--auto）。每改一句就重簽一次會把整輪審核時間吃掉，而且 layer2 與 segments 指紋不同步時階段 5 會擋。rebuild 會清掉sketch_*欄位，重建前用 shot_id 快照、重建後寫回。 段數或段代號改了就同步 REMIX 的分鏡表（PUT /projects/{id}/storyboard）：介面／審片室的「預計 N 鏡」與章節分組讀的是那份 doc，不是segments-*.json，不換就永遠顯示舊規劃（例如 133 鏡 vs 實際 18 段）。換之前先用GET /jobs?project=<id>逐鏡確認舊代號沒有工作掛著——沒有就直接整份覆寫。 使用者說「抽卡」「自己安排審片／修訂／循環」時＝自主跑完整輪（送件→收件→抽格審片→修→再抽），只在人為關卡（階段 6 核准、要使用者寫覆寫理由）停下；回報以「輪次＋四格證據圖＋修了什麼」為單位，不要每抽一段就回報一次。 - 參考包壓過提示詞：REMIX 的包母片有什麼，每一鏡都會出現（母片裡的發光建築、背包、夜空都算）。要改就換包或重出母片，不要用否定句在提示詞裡硬拗——提到道具＝道具出現。細節見
references/remix-draft-loop.md。 - 核准版與定稿版分開放，換版就要重驗：
videos/<段>.mp4永遠放「已跑過 QA 並簽核」的那一版；pika768定稿、超分、重抽候選放videos/final-768/等子目錄。要把定稿升為核准版＝重跑h3d qa／motion／--continuity→ 重建階段 6 快照 → 使用者重簽一次；不要直接把檔案覆蓋掉換版本，那會讓已簽核的快照與證據對不上。
Overview
依使用者指定的交付範圍，完成小說改編、劇本、導演分鏡、提示詞，或使用實際可用的圖片／影片工具生成媒體。
文字規劃可獨立交付；媒體生成需要相應工具或已連線的後端（FreeVideo 是可選 adapter，不代表每個 Agent 都內建影片生成）。
沒有實際呼叫生成工具，就不得聲稱已產出圖片或影片。 小說不得直接當劇本用，一律先走階段 1 改編。
接手既有專案（不是自己從 0 起的）先稽核再推進：先讀 references/audit-inherited-project.md，不要沿著前一個 agent 的分鏡往下寫——壞掉的上游會讓每一鏡都重做一次；判定「重複資產」「內容錯誤」前，一律回查 bible 與原著行號，不要只看圖或檔名。
這一頁是操作首頁：每階段做什麼、不准做什麼、跑哪個指令。原理、模板、實戰定案與完整工具清單在
references/skill-guide.md（原 SKILL.md 全文，章節不變），由 h3d next 指到該讀的那一份。
何時使用
- 「把這篇小說／故事做成漫劇、動態漫、短劇」「把小說改編成漫劇劇本」
- 「寫分鏡／鏡頭表／影片提示詞」「設計角色設定／角色聖經」「把商品素材做成帶貨短片」
每階段操作首頁
| 階段 | 做什麼 | 不准做什麼 | 跑哪個指令 | 先讀 |
|---|---|---|---|---|
| 0 定調 | 一次問完定調題（題材、載體、畫風、比例），每題附推薦值；台詞政策固定「原著對白優先」不詢問；成片形式預設長篇漫劇（不問集數秒數；使用者主動要短劇才 h3d decide series_format short）；畫風預設推 14 號「古風寫實厚塗・電影感」（附樣圖，可改選） | 不替使用者決定；不跳過體量反推；不預設切短集 | init_project.py、h3d decide style/aspect_ratio | references/pipeline.md、references/styles.md |
| 1 改編 | 保留分級、事件交代完整性（每個事件起因→經過→結果，缺漏由 Agent 補回）、台詞優先改寫與依台詞預算分集、段落架構、因果債務；交稿前 adapt_gate.py 全過 | 小說直接當劇本；為秒數壓縮事件；自行砍事件交代 | event_coverage.py、dialogue_budget.py、adapt_gate.py、h3d next | references/adapt/dialogue-first-adaptation.md、references/adapt/novel-to-manju.md、references/adapt/structure-and-pacing.md §零 |
| 2 設定圖 | 生圖工具偵測後由使用者選（只有一個可用也要問）；主角優先出圖、自檢後重生；工具定案後全集鎖定；每個劇本特效都要有自己的 B- 特效卡與已審核參考圖（沒有圖不得進階段 5，E56） | 自己預設生圖工具；換生圖工具不並排比對；自動核准（永遠要人看臉和服裝） | h3d imagegen --detect／--set（寫 design_engine）、審核頁 | references/consistency.md、references/styles.md |
| 3 劇本 | 場景化改寫、台詞預算（角色語速 4.0／4.5／VO 5.5 字/秒、說話佔 75–90%）、改編差異、定稿前盲審（fresh subagent 只給劇本材料包：build_blind_review.py --stage 3，規則見 references/blind-review.md） | 超預算照送 | estimate_duration.py --h3、sync_script.py | references/adapt/screenplay-format.md |
| 4 分鏡 | 每鏡先寫 shot_intent（觀眾要看懂什麼）再定技術值，每項選擇在 choice_why 寫理由；運鏡依 beat 情緒查 references/camera-moves-guide.md 選 move_preset（選用理由寫進分鏡表，編譯器展開、move_lint 警告）；每段附人物賬、台詞鏡寫視線、段縫寫末態並換機位（continuity-ledger.md）；Ref2VA 預設一鏡一張可辨識臉（單人裁切，走角色卡 remix 時不受此限）、遠景不放人、焦距物距成對寫 | 沒有對應構圖 PNG 就進編譯；按警告類型批量改、為過關改核准內容（人群換空座、補 empty background）；分鏡圖換人或漏關鍵道具 | 缺構圖時 h3d imagegen --detect／--set --stage 4（使用者選 Codex 分鏡／Qwen 鉛筆九宮格／手繪，寫 storyboard_engine）→ h3d next 給該工具的指令（Codex 要 --model <使用者指定模型>）、validate_storyboard.py | references/storyboard/shot-intent.md、references/storyboard/cinematic-director.md、references/storyboard/continuity-ledger.md；有打鬥／招式／特效另載 h3-combat-impact（見下節） |
| 5 提示詞 | 逐鏡親手寫 Layer 2 five_part_en（Camera／Motion／Performance／Light／Sound，Motion 與 Performance 必須詳寫；每句要對應看得到或聽得到的結果，不重寫參考圖已有的外貌，寫站位、視線、起訖姿勢、關鍵道具），讀分鏡、構圖與前一鏡狀態後再寫；編譯器只負責組成六段式；送件前跑 prompt_sketch_audit.py 逐句核對提示詞↔構圖圖（fl2v 段先 frame_pair_qa.py 疊圖） | 寫程式產生五小節；編譯後覆寫 segments；用後設詞（authored／approved）或禁止句堆疊交差；沒 ack 就放過警告 | h3d bind（先產參考圖綁定）、h3d author、h3d compile --check、h3d catalog --check | references/prompt-authoring.md、references/h3/prompt-formats.md、references/tooling.md；打鬥／大招段同時照 h3-combat-impact 寫 |
| 6 影片 | 送件 → 收件 → QA → 動態 QA（光流量凍結／定住，自動提案變速清單）→ 交界連續性 QA（實際切點＋交界拼貼＋一側靜止候選，只警告）→ --continuity-pairs 逐對回答六列連戲清單（location／prop／screen side／costume／light／effect） → 逐段結論 → 收件匣 | 兩個 runner 同時跑；碰別人的 job；漂移片拿去 QA；用規劃秒數抽格判交界（先看 --continuity 找到的實際切點） | h3d probe、h3d run --plan、h3d qa、h3d motion、h3d qa --continuity、h3d verdict、h3d inbox | references/tooling.md §2.5–2.8（交界 QA 見 §2.8.1）、references/remix-draft-loop.md（remix 抽卡→審片→修訂）、references/speed-ramp.md、references/skill-guide.md「階段 6 生成」 |
| 7 字幕剪輯 | 已核准的動作段後製變速（原片不動、台詞原速）、響度、每角色音色一次定案、全集單一剪輯專案、交付前盲審（build_blind_review.py --stage 7 抽幀拼貼，規則見 references/blind-review.md） | 所有台詞、旁白、畫外音都由 H3 原生生成（沒有外部 TTS）；替使用者定音色；覆寫原片；變速台詞區 | h3d ramp、h3d concat plan/build、h3d assemble；剪輯 lens（只給建議）scripts/craft/edit_review.py | references/tooling.md §2.7、references/skill-guide.md「階段 7」、references/edit/manju-editing-playbook.md（剪點／轉場／特效／字幕／登場卡／配樂 ducking／響度）、references/craft/murch-cut、references/craft/hamilton-action |
正式階段核准以 review/project-state.json 為準，只能走 build_stage_review.py --approve-stage（使用者原話）或 h3d approve --auto（使用者授權過的階段）。
影片生成路線：預設 Ref2VA（FreeVideo，單人裁切）；使用者改用家機 REMIX 角色包時定案 h3d decide video_backend remix，h3d bind 改綁角色包、h3d compile 帶 remix 綁定產 REMIX 三欄（風格錨開頭、<Picture N>／<Video N> 依包各自編號）、audit 依 backend 分支（送件 adapter 尚未接上，FreeVideo 送件端會拒送 remix 段；見 references/tooling.md §2.3.1c）。
階段 5 審核頁會自動對 ref2va 段補跑 refcheck／staging 並列成提醒（remix 段在 audit 內跑）；手動時跑 h3d refcheck（提示詞寫到的角色／生物／道具／群眾都要有包；remix 擋、ref2va 只提示）與 h3d staging（站位左到右、視線、不面向鏡頭；預設警告，staging_gate strict 才擋），見 references/tooling.md §2.3.1d。
階段 5 段級核准：階段 5 核准會記每段指紋。核准後只改了部分段 → 只有改過的段（含新增／刪除的段）待重審，沒改的段保持核准、照樣可送件（h3d submit／h3d run 自動跳過或拒送待重審段）；改過的段一律人工重審：build_stage_review.py --project-dir . --stage 5 --segments X,Y 產重審頁 → 使用者通過後 h3d approve --stage 5 --segments X,Y --user-note "<使用者原話>"，不得用 --auto。已有影片的段被改會出現在 h3d deps --status 的 stale（prompt_stale）。舊快照或共用部分（分段檔外殼、未綁段的 ack、前置階段）變了仍要整份重審。詳見 references/tooling.md §2.6。
純文字草稿可按指定範圍交付，不必推進到媒體生成：用 h3d decide delivery_scope script-only|storyboard-only|prompts-only|full --quote "<使用者原話>" 定案交付終點（沒定案＝全流程），h3d next 到終點就回報 done；no_image 時階段 2 只要求文字設定卡。注意：no_image 只解除階段 2，階段 4 以後仍要求構圖圖，終點要在階段 3 以前或另行決定。八階段的產出與 HTML 審核頁對照見 references/skill-guide.md「八階段流程與 HTML 斷點」，
詳細模板見 references/pipeline.md。各階段的 HTML 審核頁現在是除錯頁（綁審核快照用）；交給使用者的是 h3d inbox 收件匣，規格見 references/review-page-spec.md。
打鬥／招式／特效段：同時載入 h3-combat-impact
分鏡或提示詞涉及打鬥、對打、招式、必殺技／大招、一招秒殺、變身、法術爆炸、特效、衝擊幀、震屏（或任何 L3 以上命中）時，
同時載入 h3-combat-impact（ayase0307/h3-combat-impact），兩者並用：
- 階段 4：照它的必經流程設計角色招式、交手編排（交換／後果）、特效分層與運鏡，並列衝擊點清單、每點選衝擊幀路徑（P0–P3）。導演層 lint（
director_lint.py，warning）會提醒：換新地點先給建立鏡、對白不越 180 度軸、反轉／壞消息後補反應鏡、視線匹配要交代被看物、段間接縫用動作剪輯或遮擋轉場（參考 24frames.art 鏡頭語言，改寫）。 - 階段 5：打鬥段的
five_part_en照它的決策卡寫——大招預設寫「衝擊幀串」段（模板 F），不寫near-freeze／hangs poised／like a meteor／for two frames這類 H3 慢詞與幀數控制； 衝擊幀計畫表（時間碼、打擊點、力度、路徑、組裝倍率）寫進該段的分鏡備註／交付說明（segments 目前沒有專屬欄位）。 - 階段 7：已核准的打鬥段依衝擊幀計畫做變速（
h3d ramp，或該技能的impact_frame.py ramp）或合成（impact_frame.py composite）；台詞區仍原速。 - 鏡長：衝擊幀串段、打擊短鏡可以短於 h3-video-prompting 的「每鏡 ≥2 s」，以 h3-combat-impact 為準。
本 repo 的配套寫法：references/storyboard/xuanhuan-combat-contract.md（戰鬥分支、動作成立條件、場地、衝擊三層、鏡頭速度用語、大招過程鏈）與 references/storyboard/vfx-design-and-review.md（特效設計卡、保臉防線、看圖驗收與返修、局部修正寫法）；兩份都是外部技能蒸餾、未經 H3 實測。
這是轉介，不改本技能的門禁：validate_storyboard.py、h3d compile --check、h3d catalog --check 照常要過。
四道確定性檢查（交付的一部分）
時長量子（17n+5，用 metadata.frames 送件）、證據分級（階段 6 要 VERIFIED）、segment 級依賴帳本（h3d deps）、
失敗目錄（h3d catalog --check／h3d ack）。duration_drift、PARTIAL、已有 waiting 的 job 都代表「現在不能繼續」，
處置見 references/tooling.md §4。
監督（要求帳本，送審前與盲審並列）
h3d decide 只記形式化定案；使用者隨口說過的偏好沒進定案就會被忘記，也沒有任何檢查在問「使用者說過的話有沒有被忘記」。監督者補這層：
python scripts/build_requirements_ledger.py --root <專案> 組要求帳本（decisions.json 每條定案的原話＋inbox 待決卡＋--quotes 手動摘錄），
--stage N／--all／--inputs 另組「只含材料、不含結論」的查核包，fresh subagent 逐條查產出覆蓋（模板與禁令見 references/supervision.md）。
與盲審同定位：流程要求不是門禁，不改 h3d 狀態機；不通過 先處置再送審。接手既有專案第一步用 --all 累積查核（配合 references/audit-inherited-project.md）。
資源（索引）
references/tooling.md— h3d 全部指令與檢查（跑任何指令前先讀）；§2.5 定案／逐段結論、§2.6 收件匣與自動核准、§2.7 runner／probe／配音／剪輯。references/skill-guide.md— 原 SKILL.md 全文：核心原則 0–14、專案結構、階段 6 實戰定案、階段 7 配音分層、完整腳本清單。references/pipeline.md— 八階段詳細流程、提問清單、模板；聲音三層決策與響度標準。references/review-page-spec.md— 審查頁規格：交給使用者的是決策收件匣（版面順序、卡片必備欄位、禁止事項、八階段閱讀視圖六區塊），舊階段頁只作除錯。references/blind-review.md— 盲審（fresh-eyes）：只給材料不給結論的材料包與流程（階段 3／7 必跑；scripts/build_blind_review.py）。references/supervision.md— 監督（要求帳本）：使用者說過的話逐條查覆蓋（每階段送審前必跑；scripts/build_requirements_ledger.py）。references/document-standard.md— 階段文件標準格式：狀態卡＋本體＋修訂紀錄，用h3d doc寫，不要手改；「要你決定」會自動進收件匣。references/audit-inherited-project.md— 接手他人專案（「你接手」「前一個 agent 做的很爛」「看看有甚麼建議」）：先稽核再推進、機械生成指紋門檻、台詞管線三種壞法、REMIX 稽核、重建順序與地雷（重 bind、官方運鏡動詞、sketch 快照還原、非支援後端出構圖圖）。references/remix-draft-loop.md— remix 抽卡循環（階段 6）：pika4804／6 步的選擇、參考包壓過提示詞的五種症狀、審片三件事、三個常見假警報（低彩度／框線／色調跳躍）、批次修＋重簽、收件與定稿順序。docs/skill-roadmap.html— 給人看的動態路線圖（八階段動作、產出、誰決定、停車訊號）；流程改了要同步它內嵌的roadmap-data（tests/test_skill_roadmap.py對帳）。references/adapt/（改編）、references/storyboard/（導演分鏡）、references/consistency.md（資產一致性）、references/styles.md（風格鎖定錨）、references/freevideo.md、references/model-profiles.md、references/minimax-h3.md與references/h3/（H3 細部參考，同步自上游 h3-video-prompting）、references/prompt-playbook.md、references/h3/camera-moves-handbook.md（上游運鏡手冊：17 式＋Loop Forge 6 式＋仙俠子彈時間，Colab 實測標註）、references/craft/（創作 lens，只給建議不改門禁）、references/edit/（階段 7 漫劇剪輯手冊、Concat／剪映草稿調查）。- 打鬥／招式／特效／衝擊幀：外部技能
h3-combat-impact（ayase0307/h3-combat-impact），見上方「打鬥／招式／特效段」。 references/revision-and-retry.md— 改稿必附改動清單＋聯動結論、同鏡重抽最多 2 次後回層診斷、驗收比較原則。references/storyboard/continuity-ledger.md— 人物賬、分鏡審查清單、三種方位、站位附表、正反打、段縫末態、參考圖用途。references/storyboard/spatial-consistency.md— 空間一致性：場景母片照平面圖畫、牆面分配層（可選scripts/storyboard/wall_map.py）、構圖板以母片為底、只拍生物的鏡頭綁店內參考（老易實驗 2026-10，方向性證據）；§6 白模分工與精度三檔（Foyege，H3 未實測）。- 格式：
references/schemas/（decisions、verdicts）。給 agent 的硬規則另見AGENTS.md。