video-workflow

name	video-workflow
description	在 ChatGPT App／Codex 依活動紀錄、教學影片或社群科普三類規格製作影片。使用者說「我要做影片」「做教學影片」「做活動紀錄」「做科普短片」時使用；採 codex-video-specs repo 模式，不打包絕對路徑。

ChatGPT App／Codex 影片工作流

正式來源：https://github.com/mathruffian-dot/codex-video-specs

啟動方式

• 有本機 Codex 專案：把 codex-video-specs 下載或 clone 到本機非同步資料夾，再用 ChatGPT App／Codex 開啟該資料夾。
• 有 GitHub App／Plugin：授權唯讀後，讓 ChatGPT 先讀 repo 的 README.md、AGENTS.md 與 specs/。
• 只有一般 Chat：請使用者上傳所需規格檔與素材，不假設能直接讀本機路徑。

不要把 node_modules、Playwright 或渲染快取放在 Google Drive／OneDrive 同步資料夾。

三類影片

類型	適合情境	建議現場完成線
活動紀錄	校慶、比賽、研習、畢業典禮	短片或瀏覽器預覽
教學影片	概念講解、翻轉教室	完整腳本＋重點畫面
社群科普	AI、科技、班級宣導	直式短片或完整腳本

研習現場時間不足時，活動紀錄或社群科普優先；教學影片可先完成腳本與設計。

必守順序

1. 盤點素材、對象、片長、比例與發布情境。
2. 產出 SCRIPT.md：旁白、字卡、分鏡與來源。
3. 停下來等使用者確認 SCRIPT.md。
4. 產出 DESIGN.md：字體、配色、節奏、版型與聲音。
5. 停下來等使用者確認 DESIGN.md。
6. 才能製作 HTML 畫面、語音、字幕與影片。
7. 打開瀏覽器預覽，再驗證 MP4、音訊與字幕。

不得跳過兩個確認點。

環境與備援

• 只做腳本與設計時，不要求先裝 ffmpeg 或 Playwright。
• 要渲染 MP4 才檢查 Node.js、ffmpeg、Playwright 與 Edge-TTS。
• 安裝卡超過合理時間時，退回 SCRIPT.md＋DESIGN.md＋可在瀏覽器播放的畫面。
• Edge-TTS 失敗時序列重試，不平行轟炸。
• 同一錯誤重試兩次仍失敗就停下來說明，不繼續耗課堂時間。

不要沿用的 OpenCode 步驟

• 不要求在 OpenCode 重開專案。
• 不依賴 opencode.json。
• 不執行 pack_skill.sh --target=opencode。
• 不把 repo 絕對路徑寫進全域 Skill。
• 不使用 OpenCode 專用 plugin 位置。

完成回報

回報：

• 使用的影片類型
• SCRIPT.md、DESIGN.md 與成品位置
• 是否完成 MP4；若沒有，已完成到哪個可續作節點
• 哪些內容仍需使用者確認