Communitygithub.com

IsmaelZamora4/cinematic-shorts-pipeline

規劃並驗證 3D 電影短片:敘事、分鏡、藝術指導、技術計劃、配音、字幕與品質控管。用於準備可審查的製作套件;本身不授權產生任何視聽內容。

cinematic-shorts-pipeline 是什麼?

這是一項專門用於規劃和驗證 3D 電影短片製作流程的技能,從原始構想或腳本開始,逐步產出可審查的製作套件。它明確區分規劃階段與實際內容生成(如渲染、音訊、3D 模型),本身不授權產生任何最終媒體。技能涵蓋從任務簡報、敘事建構、視覺風格與資源選定、分鏡設計(含可選的攝影機與動畫區塊)、技術計劃,到最終品質控管的完整流程,每個階段都設有明確的「審查關卡」,必須通過才能進入下一階段。它支援透過本機 Python 指令碼進行結構與時間驗證(如 `validate-storyboard.py`、`validate-skill.py`),以及基於 DAG 的管線協調(`pipeline.py`),並詳述了語音與字幕的時間同步規範、資源的授權與格式要求。技能適用於 Claude Code、Cursor 等 AI 助理環境,特別適合需要嚴謹規劃與版本控制的短片專案,並強烈建議在執行任何依賴安裝、媒體生成或外部服務呼叫前取得明確授權。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/IsmaelZamora4/cinematic-shorts-pipeline/tree/HEAD/.agents/skills/cinematic-shorts-pipeline

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

電影短片流程

從一個點子或腳本建立可審查的製作套件。此技能負責規劃與驗證;不授權產生影像、音訊、3D 模型、渲染或影片。僅在無法推斷重大創意或技術決策時提問。尊重明確的製作授權與目標專案指示。

流程與審查關卡

階段輸入可審查輸出前進的批准條件
任務點子、腳本或請求簡報,包含觀眾、格式、時長、語言、語氣、限制與交付項目;標記未知事項基本需求完整;事實與限制已理解
故事已批准的簡報主軸、目標、障礙、風險、節拍、轉折與結局因果關係清晰;事實與虛構已區分;無阻礙性敘事決策
美學與資源已批准的故事風格指導、角色/環境標準與候選資源清單風格一致;每個使用的資源皆已驗證來源/授權/格式/骨架,或標記為待辦且不在已批准計劃內
分鏡已批准的故事與方向每個鏡頭的 JSON;可選區塊 cinematography 與 animation 描述按節拍的攝影機/光線與表演驗證器通過;焦點/剪輯意圖與節拍/連續性已審閱。9:16 靜態圖與序列有各自關卡;未驗證的骨架不會被批准用於製作
技術計劃已批准的分鏡引擎與版本、資源/授權、動畫、配音/字幕、檔案與預計成本/限制本機路線可行;明確列出依賴項與資源用量;無隱藏重大不確定性
品質控管前述完整套件含證據的評分表、自動結果、視覺審查與獨立的人員評估所有錯誤已修正或明確接受;列出阻塞點;未執行檢查不得聲稱通過

不得跳過失敗的關卡。計劃、預覽、畫面、旁白或渲染不授權進入下一製作階段。

對於每個分鏡,執行 python scripts/validate-storyboard.py ruta/al/storyboard.json。validate-skill.py 也會驗證所有 examples/**/storyboard.json 與 templates/storyboard.json 的結構與時間線,重複使用分鏡驗證器。若要審查完整技能,執行 python scripts/validate-skill.py . 與 python -m unittest discover -s tests -v。

專案可以版本化一個 pipeline.json,內含 pipeline_version: 1,與分鏡獨立。使用 python scripts/pipeline.py validate ruta/al/pipeline.json 驗證;使用 plan 或 dry-run 檢視 DAG 而不執行或寫入;使用 validate-manifest pipeline.json run-manifest.json 驗證現有清單。在編輯該合約前,請查閱 references/pipeline-orchestration.md。

字幕使用間隔 [start_ms, end_ms):預設拒絕重疊。有意的重疊需要在較晚開始的字幕中包含非空的 overlap_exception;請說明其理由。

若要連結語音與鏡頭,narrative_timing 在 schema_version: 1 中為可選:將時鐘標記為估計或已錄製,並使用參考場景的錨點標註節拍、暫停與剪輯。對於實際錄音,將其時長用作時鐘並重新審查字幕。錨點不證明同步;未經對齊工具或人工審查的證據,不得聲稱逐字對齊。

將新套件儲存在 deliverables/<slug>/ 中,包含簡報/計劃與 storyboard.json。使用穩定的 slug 並保留現有交付項目;建立新套件時不得移動或覆蓋先前的套件。

能力狀態

已實作:規劃指南、可選的攝影機與動畫合約、質性評分表、本機 DAG 規劃器以及管線/清單合約驗證。pipeline.py plan 與 dry-run 顯示圖形而不執行階段或建立檔案。分鏡驗證檢查結構與宣告的時間;不驗證攝影機、表演、骨架的存在性/相容性或視覺品質。清單驗證器檢查狀態、指紋與輸出,但不建立或恢復執行。

視聽階段及其適配器仍待完成。沒有媒體產生、渲染引擎、TTS 適配器、合成、時間性視聽 QA 或法律掃描器。基準測試結果、資產可用性、授權、工具與相容性按任務驗證。

本機環境

在 VideoIA 工作時,先閱讀 AGENTS.md 與相關的本機指示。已知參考環境為 Windows 11、GTX 1650 4GB、16GB RAM、本機 Blender、Remotion/React/Three.js/R3F、FFmpeg、Kokoro TTS 與可選的 CC0 資源套件。這是環境背景,不保證二進位檔、模型、套件、授權或版本仍然安裝。優先採用本機/免費流程與適度的預覽;在套用框架模式前,請驗證現行版本。

重複使用已安裝的 Remotion 技能,而非複製其手冊。僅在任務需要時查閱最佳實踐、標記、3D、字幕、Studio 或渲染指南。渲染需要明確請求。未經授權,不得安裝依賴項、下載資源、使用付費服務、發佈或修改他人專案。

使用電影評分表來區分自動驗證、靜止畫面檢查與人工判斷。靜態影像不能證明動畫的時間品質。

資源

相關技能