短劇創作路由
本技能負責項目初始化、跨階段路由、製作形態與 Dashboard。各階段正文由對應 owner 完成。
Quick Start
所有項目統一使用 creator-first 工作流：每集按需維護
劇本.md、視覺設定.md、分鏡.md、圖片提示詞.md、影片提示詞.md，不建立並行的結構化創作真相。
具體寫法見 五份創作文件。
路由
| 用戶要做什麼 | owner / 行為 |
|---|---|
| 開發點子、系列承諾、改編和分集地圖 | $short-drama-develop，僅在用戶需要時 |
| 已有多集完整劇本/散稿識別分集 | $short-drama-develop 按實際邊界建立臨時索引 |
| 分析長篇原著 | $short-drama-novel-analyze，僅在用戶需要時 |
| 寫或改單集劇本 | $short-drama-write → 劇本.md |
| 拆人物、造型、地點、道具 | $short-drama-assets → 視覺設定.md |
| 寫資產圖片提示詞 | $short-drama-image-prompts → 圖片提示詞.md |
| 做鏡頭和凍結關鍵幀 | $short-drama-storyboard → 分鏡.md |
| 寫影片/時間線音樂提示詞 | $short-drama-video-prompts → 影片提示詞.md |
| 實際生成媒體 | $short-drama-produce，先預覽，再顯式確認，最後執行 |
| 審稿或校驗 | $short-drama-review，僅在用點名時 |
| 初始化、Dashboard、歸檔點名文件 | 本技能 |
項目開發/ 中的長材料分析與分集索引是可選分析工作區，不參與單集佈局判定；寫任何一集仍只維護
該集的五份 creator-first Markdown。
現成劇本可直接拆資產；已有視覺事實可直接寫圖片提示詞或分鏡；已有分鏡可直接寫影片提示詞。 不要為補齊名義流水線偽造上游。
執行請求
- 找到用戶給出的項目或資料，唯讀當前任務的直接輸入。
- 把用戶點名的完整範圍交給對應 owner；批次只控制上下文，自動續跑。
- 只有真實創作分叉才詢問；不要拿 schema、目錄、事務或檢查器詢問創作者。
- 範圍完成後一次回報完成內容、關鍵決定、真實未決項和可選下一步。
- 不自動開始用戶沒點名的審查、歸檔或生產。
初始化與 Dashboard
需要項目配置時執行：
python3 {技能目錄}/scripts/project_tool.py init ./my-drama --title "示例短劇"
init 只建立配置和空目錄；第一次創作時再把文件寫入 劇集/<EP>/，不預建空文件。
項目定位與安全寫入見 執行預檢。用戶明確要求 Dashboard 時執行：
python3 {技能目錄}/scripts/dashboard_server.py --workspace <workspace> --port 0 --detach --open
--detach 讓服務進程脫離當前 shell 獨立執行，會話結束、終端關閉或智能體退出都不會帶走它；
連結因此在整個創作期間保持有效。執行中的位址、埠和 pid 記錄在
<workspace>/.short-drama/dashboard.json（僅本人可讀），日誌在同目錄 dashboard.log：
python3 {技能目錄}/scripts/dashboard_server.py --workspace <workspace> --status # 列印當前連結
python3 {技能目錄}/scripts/dashboard_server.py --workspace <workspace> --stop # 停止
同一 workspace 已有在跑的 Dashboard 時，再次啟動只會列印同一個連結，不再開第二個埠；確實要換
埠或換令牌時加 --restart。不加 --detach 時行為不變：前台執行，Ctrl-C 結束。
Dashboard 展示和編輯創作文件，不負責工作流編排或媒體生產。
項目級創作決定
製作形態、視覺方向、播放面和集長目標確實約束多個階段時，展示選擇及影響後由用戶決定。 Look Development 是可選分支，不是進入圖片提示詞或分鏡的固定門檻。
按問題只讀取一份相關知識：
- 規則分級與 owner 路由：規則與路由索引
- 輸出語言、穩定 ID、所有權與安全邊界：契約與所有權
- 實拍、二維、三維、水墨、Q 版、國漫的形態差異：製作形態
- 需要比較代表幀時：Look Development
- 參考圖能控制什麼：參考角色
- 遮擋、延遲揭示和觀眾知情時機：觀眾揭示
- 母版、補拍和替代版的職責：補拍與替代
生產與交付邊界
外部生產永遠保留 preview -> explicit confirm -> run。歸檔只複製用戶點名的當前文件和成品，排除
私有輸入、憑證、絕對路徑與隱藏執行狀態；不為歸檔補造審批、哈希或第二套內容。
用戶問「做完了怎麼導出/交付給我」時，用 export 打包當前狀態：
python3 {技能目錄}/scripts/project_tool.py export <project> --out <項目外目錄>
它把每集現有的五份創作文件和 劇集/<EP>/製作成果/ 複製到 --out，附 manifest.json 與
checksums.sha256，並排除 輸入/、交付/ 和 .short-drama/。只要一部分時加
--episode EP001（可重複）；只要文字時加 --no-media；覆蓋舊目錄加 --overwrite。
--out 必須在項目之外。
export 是當前狀態快照，manifest 裡 asserts_approval 恆為 false：它不聲稱任何審查或
創作者接受。需要帶審批證據的正式交付包仍然只有 package/verify 那條路徑。
安裝維護
只有安裝、升級或排障時執行 python3 scripts/selftest.py。