shuohao-skills 是供 Claude Code 與 Codex 使用的 AI 短劇製作 skill 集合。五個自包含模組分別處理改編大綱、角色設定、美術設定、劇本與分鏡，並以 Node.js 腳本執行資料驗證、品質門、報告渲染與投產匯出。
shuohao-skills 將小說改編工作拆成五種 Agent Skill。每個 skill 都有自己的 SKILL.md、零依賴 Node.js 工具、參考資料、範例與不呼叫模型的 selftest.mjs。
模型負責理解原作與生成內容；腳本負責 schema、統計、品質門、渲染與匯出。大綱的角色、場景與道具編號會傳給下游，劇本再把場次與節拍交給分鏡，降低不同階段的資料漂移。
每一階段都能獨立執行或單獨複製。完成的 JSON 可重新送入 validate、checkup 與 render，五份 HTML 報告也能由根目錄組裝器合成單頁。
安裝前確認 Node.js 版本為 18 以上。工具只使用 Node.js 標準函式庫，不需要執行 npm install；模型任務使用目前 Claude Code 或 Codex 工作階段的額度，不需要另外提供 API key。
安裝腳本會偵測 Claude Code 與 Codex，並以軟連結安裝所有 skill。使用下列參數只安裝單一 skill、限制 Codex 目標或移除連結。
~/.claude/skills/novel-characters 或 ~/.codex/skills/novel-characters。執行 git pull 後，軟連結會直接讀取更新內容。
五個 skill 共用結構化 JSON 作為階段交接格式。先選擇目前要解決的製作層，再把已完成的上游 JSON 傳入 seed、validate 或 Agent 工作流程。
| 目前素材 | 使用入口 | 主要產物 |
|---|---|---|
| 小說或短故事 | /novel-outline、/novel-characters |
outline.json、cast.json |
| 已完成 outline.json | novel-art seed、novel-script seed |
art.json、script.json 骨架 |
| 已完成 script.json | novel-storyboard seed |
storyboard.json 骨架 |
| 五段 JSON 或部分 JSON | node scripts/report.mjs |
可切換面板的 report.html |
Repository 將生成式工作與確定性工作分開。Agent 撰寫內容；Node.js 腳本處理資料格式、品質門、統計、渲染與匯出。
每個目錄包含 SKILL.md、人類可讀 README、腳本、參考資料、範例與資產，可單獨複製使用。
大綱、美術、劇本與分鏡分別提供 14、11、10 與 17 道品質門。每個 skill 的 selftest.mjs 不呼叫模型。
上游資料可用 seed 產生下游骨架；完成後可反覆執行 validate、checkup 與 render。
五個 skill 的報告預設中文；render --lang en 會切換英文介面，原始資料內容保持原文。
角色、美術與分鏡可使用 Codex 內建 $imagegen。未安裝 Codex 時仍可交付提示詞與其餘資料。
scripts/report.mjs 會處理 CSS 選擇器、報告腳本與圖片相對路徑，並依現有 JSON 產生對應面板。
以下流程以 Claude Code 的 skill 指令完成內容生成，再以 repository 內的 Node.js 工具組裝報告。檔名僅作為工作目錄示例；實際名稱依專案設定。
保留每一階段的 JSON，內容修改後直接重跑對應的 validate 與 render。合併報告不複製各 skill 的實作；任一 skill 更新渲染器後，組裝器會在下次執行時採用新版輸出。
node -v。各 skill 腳本只使用標準函式庫，不需要 npm 依賴。
for f in skills/*/scripts/selftest.mjs; do node "$f"; done。
storyboard-report.html、manifest.json 與 E01-01/ 等段目錄需維持既定相對位置，否則報告會找不到圖片。
scripts/report.mjs 只組裝目前存在的 JSON 與各 skill 渲染結果，不取代上游生成與驗證流程。
先用單一 skill 驗證資料格式與品質門，再逐段接入上游 JSON。完整管線需要一致的角色、場景、道具、場次與節拍編號。
1. 單獨安裝一個 skill。執行 ./scripts/install.sh novel-characters，先驗證角色拆解、報告與可選出圖流程。
2. 執行全部自測。修改任何腳本前後都執行各目錄的 scripts/selftest.mjs，確認確定性邏輯沒有退化。
3. 固定 JSON 交接契約。將 outline、cast、art、script 與 storyboard 分別存入對應目錄，使用 seed 建立下游骨架。
4. 分離報告與生成參數。使用 --lang 控制報告介面；角色以 --style 選擇出圖風格，分鏡以 promptLang 控制 H3 提示詞語言。
5. 組裝專案評審頁。將現有 JSON 放入五個約定目錄，執行 node scripts/report.mjs --from <demo目錄> --out report.html。
① README.md：安裝、五階段管線、工作目錄與報告組裝器。
② novel-outline/SKILL.md：改編參數、輸出 schema 與 14 道品質門。
③ novel-storyboard/SKILL.md：節拍認領、H3 提示詞與投產匯出。