Codex Video Specs — Communication skill for Claude Code

codex-video-specs

給 Codex agents 使用的三類影片製作規範、模板與品質檢查流程。

本 repo 的目標不是只把 HTML 錄成 MP4，而是讓使用者能穩定做出可發布的三類影片：

類型	用途	預設片長	核心產出
Type 01 活動紀錄	活動、旅行、比賽、校園紀錄	50-180 秒	情緒弧線、照片節奏、口白與 BGM
Type 02 教學影片	國中數學與學科概念講解	3-8 分鐘	SOIL 架構、逐頁動畫、數學正確性
Type 03 社群科普	AI、科技、知識短影音	2-3 分鐘	強 Hook、多版面、可靜音閱讀

給 Codex 的第一句話

在 Codex 工作區打開本 repo 後，請先讀：

1. AGENTS.md
2. GOTCHAS.md
3. 對應的 specs/type-0X-*.md
4. QUALITY_GATE.md

任何影片實作前，都必須先產出並展示：

• SCRIPT.md
• DESIGN.md
• ASSETS.md

等使用者明確確認後，才可以開始寫播放器、合成旁白或渲染。

Codex 專用原則

• 預設使用繁體中文。
• 預設 Windows + PowerShell。
• 不在 Google Drive / OneDrive 內安裝 node_modules。
• Playwright、暫存音訊、FFmpeg concat 清單放在 %TEMP% 下。
• 使用 ?render=true 模式避免錄影開場遮罩殘留。
• 渲染後必須抽關鍵幀截圖做 QA，再交付 final.mp4。

建議專案結構

my-video/
├── SCRIPT.md
├── DESIGN.md
├── ASSETS.md
├── QA.md
├── index.html
├── generate_narration.py
├── render.py
├── record.cjs
├── assets/
│   ├── fonts/
│   ├── images/
│   └── narration/
├── renders/
│   ├── master_audio.mp3
│   ├── video.webm
│   └── frames/
└── final.mp4

快速開始

python install\check_env.py

選定類型後，照對應規範執行：

• specs/type-01-event.md
• specs/type-02-teaching.md
• specs/type-03-social.md

與 claude-video-specs 的差異

`claude-video-specs` 是較通用的多 agent 規範。這份 repo 是 Codex 專用版，補上：

• Codex Desktop / CLI 工作方式
• PowerShell 指令
• Windows 中文路徑與 CP950 避坑
• 強制腳本、視覺、素材前置確認
• 強制截圖 QA 與重渲染流程
• 三類影片的最低品質門檻