Akira-TL/akira-video-skills

Akira Video

akira-video 是 Akira Video Skills 的主要路由器。它負責影片製作入口、VIDEO.md、當前製作任務判斷、專業 Skill 路由與停止邊界；具體的影片腳本、複用素材、鏡頭、生成包、審片和整片後期方法則由對應的專業 Skill 負責。完整專案的依賴與人機交接請參考 references/workflow/PRODUCTION-FLOW.md；已有專案直接從當前實際工作繼續，不機械地重跑上游步驟。

整個製作始終優先保護：使用者與來源事實 → 劇情 / 鏡頭意圖（適用時）→ 人物 / 物體身份與結構 → 產品事實（廣告時）→ 空間與時間連續性 → 畫面美感 → 炫技。具體層級、衝突回查和「採用結果實際出口」例外情況請參考 references/workflow/AUTHORITY.md；後面的目標不能以破壞前面的約束為代價。

1. 進入或接管專案

先讀取專案根目錄的 VIDEO.md。若不存在，則依 references/project/PROJECT-LAYOUT.md 建立最小影片專案；專案定義與當前狀態請參考 references/project/VIDEO-HOME.md，命名規則請參考 references/project/NAMING.md。僅建立當前真正需要的目錄和檔案，不預先生成空分類；第一次需要一次性生成包時，再確保目標專案的 .gitignore 忽略 .tmp/。

使用者已提供現成圖片、影片、音訊、粗剪或參考成片時，先依 references/project/IMPORT-MEDIA.md 判斷其在當前專案中的真實用途；可直接複用的成果不強制重新設計或生成流程。

然後根據當前任務讀取最小必要內容：

• 影片腳本與鏡頭總覽：video/script/；
• 跨鏡頭複用內容：video/materials/；
• 當前鏡頭：video/shots/<shot-id>/；
• 已進入整片後期時：video/edit/；
• 上游小說、章節、品牌資料或其他來源：沿當前專案的真實 pointer 讀取，不複製成第二份上游事實來源。

完成標準：能夠說明當前影片目標、交付要求、正在推進的製作內容、已有可複用素材、當前鏡頭/後期狀態和真實阻塞項目。

進入下一項昂貴製作前，依 references/workflow/PRODUCTION-GATES.md 僅運行當前專案適用的輕量門禁；門禁不產生額外專案狀態檔案。當前專案已大到平鋪影響閱讀，或確實需要同時比較創意版本時，再讀取 references/project/SCALING-VERSIONS.md，不要預設長片目錄。需要清理失敗結果、一次性包、快取或舊媒體時，依 references/project/MEDIA-LIFECYCLE.md 先確認檔案不是唯一輸入、當前採用結果或後期工程的唯一依賴。

重要製作決定如何落盤、VIDEO.md 何時更新、鏡頭採用結果為何只寫 SHOT.md，請參考 references/project/RECORDING.md；聊天歷史和一次性生成包都不是長期專案記錄。

2. 維護 VIDEO.md

VIDEO.md 是供人和下一位 Agent 直接閱讀的影片製作首頁，僅保存當前仍有用的資訊。固定關注：

• 專案與影片目標；
• 交付要求；
• 當前製作進度；
• 當前正在推進的工作；
• 阻塞項目；
• 仍影響後續的關鍵決定；
• 到影片腳本、複用素材、鏡頭和整片後期的導航。

普通提示詞歷史、所有生成結果、生成日誌和已被 Git 歷史取代的舊決定不進入 VIDEO.md。

詳細寫法請參考 references/project/VIDEO-HOME.md。

3. 路由專業工作

根據使用者的當前目標和已有專案內容選擇下一項實際製作工作。完整專案不要求機械地經過所有能力；已有腳本時可直接進入鏡頭，已有鏡頭與素材時可直接準備生成包，返回生成結果後直接進入審片。

根據當前任務載入正式 Skill：

• 從小說、章節、brief 或其他上游內容形成/修訂影片腳本、人物表演、場景或鏡頭總覽 → video-script；
• 角色或場景僅有功能描述、尚未形成具體外型 / 服裝 / 材質 / 空間 / 光線設計 → video-design；
• 角色需要跨鏡頭穩定音色、聲音參考，或專案需要規劃對白聲音、環境聲、音效與整片聲音邊界 → video-audio；
• 規劃或維護跨鏡頭複用的人物、場景、道具、產品提示詞與參考素材 → video-materials；
• 把鏡頭總覽展開成 SHOT.md，處理動作、攝影、聲音與相鄰鏡頭連續性 → video-shot；
• 編寫當前生成提示詞、選擇最小參考集、整理一次性生成包、導回使用者生成結果 → video-generation；
• 使用者帶回圖片或生成結果後判斷採用、調整後續、後期修復、重新生成或重寫 → video-review；
• 多個採用鏡頭進入 Premiere Pro、After Effects、DaVinci Resolve 等整片後期 → video-editing；
• 同一影片需要多語言字幕、旁白、配音或正式成片版本 → 先讀取 references/workflow/LOCALIZATION.md，翻譯內容交給 video-script，聲音交給 video-audio，字幕 / 圖文 / 最終匯出交給 video-editing，不複製整套專案；
• 品牌、產品植入或廣告需要核驗產品功能、結構、官方素材與廣告表達邊界 → 按需載入可選 video-advertising；當前 Target 未安裝時使用明確 coordinate akira-tl/akira-video-skills/video-advertising，交給 akira Router / Skiloom 生成候選計劃（Candidate plan）並在授權後安裝。

Router 僅保存上述職責摘要；進入任一分支後，以實際載入的權威 Skill 為該專業方法的唯一權威來源。

若目標需要影片模型專用適配，先讀取 references/workflow/MODEL-ADAPTERS.md 選擇當前倉庫已有的最小適配 Package；尚未安裝時把明確 coordinate 交給 akira Router / Skiloom 正常生成候選計劃（Candidate plan）並安裝。不要把模型參數或供應商細節硬編碼進 akira-video。圖片生圖目前使用 video-design + video-materials 的通用規則，不單獨維護圖片模型適配器。

外部生成已交給使用者、需要跨會話等待時，依 references/workflow/WAITING-RESUME.md 在 VIDEO.md 僅記錄生成包路徑、預期返回、下一步和真實阻塞項目；下一輪優先恢復現有包 / 返回結果，不因為換會話而重複打包。

4. 外部生成的人機邊界

預設允許使用者在外部的圖片/影片模型中完成實際生成。需要外部生成時，專業生成 Skill 從正式專案內容整理一次性生成包：

正式專案內容 → .tmp/ 一次性生成包 → 使用者外部生成 → 結果返回 → 歸檔至正式目錄 → 刪除臨時包。

一次性生成包是衍生產品，不成為長期專案的事實來源；長期提示詞留在對應的歸屬素材或鏡頭目錄，臨時包僅複製當前生成真正需要的內容。

5. 重新路由與停止邊界

每次專業 Skill 完成一個有邊界的動作後：

1. 將返回的正式素材、生成結果、鏡頭決定或整片工程歸檔到對應的歸屬目錄；
2. 更新仍影響當前製作的 VIDEO.md；
3. 根據使用者目標與當前產物決定下一項製作工作。

僅在使用者限定範圍完成、下一步必須等待使用者外部生成或提供素材、存在真實阻塞項目，或當前交付已完成時停止。等待使用者外部生成時明確給出一次性生成包和返回命名要求，不繼續假裝已產生素材。