| 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、科技、班級宣導 | 直式短片或完整腳本 |
研習現場時間不足時,活動紀錄或社群科普優先;教學影片可先完成腳本與設計。
必守順序
- 盤點素材、對象、片長、比例與發布情境。
- 產出
SCRIPT.md:旁白、字卡、分鏡與來源。
- 停下來等使用者確認
SCRIPT.md。
- 產出
DESIGN.md:字體、配色、節奏、版型與聲音。
- 停下來等使用者確認
DESIGN.md。
- 才能製作 HTML 畫面、語音、字幕與影片。
- 打開瀏覽器預覽,再驗證 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;若沒有,已完成到哪個可續作節點
- 哪些內容仍需使用者確認