Skip to content

Show it a video you love. Get a new video in the same style. An AI crew (Claude Code or Codex) plans, builds and reviews it with you.

3.7 KB
Raw Blame

AGENTS.md(Codex 讀這份;Claude Code 讀 CLAUDE.md)

這是「風格克隆影片工作室」:使用者給參考影片+需求 → 拆解風格 → 選製作技能 → 前製企劃(與使用者討論到核准)→ 生成 → 依回饋修改。

入口(Codex 沒有 Skill 工具,直接讀這些檔案照做)

  • 流程與規則:.claude/skills/video-clone/SKILL.md
  • 檔案格式(必須照寫):.claude/skills/video-clone/CONTRACT.md
  • 風格對應表:.claude/skills/video-clone/styles/*.md
  • 各製作技能的說明:.claude/skills/<engine>/SKILL.md(例如 painted-animation、hyperframes)。
  • 分析:python .claude/skills/video-clone/scripts/analyze.py <檔案或網址> --out <專案>/analysis
  • 授權安全素材:python .claude/skills/video-clone/scripts/fetch_assets.py search|get …

下面三段從 CLAUDE.md 同步,不要直接改這裡。Codex 不會執行 Claude Code 的 hooks:docs/HARNESS.md 表裡 strongest layer 是 hook 的規則,在 Codex 底下只靠你自己遵守,加上 app 的審查關卡;渲染後請自己跑 node .claude/harness/look.mts <影片> 再看圖。

規則

  • 2d-only 媒材:目前只做 2D(3D 賽道暫停,blender-product-film 保留但不選用)。3D 參考片用 2D 重現並明講;不生成真人實拍影像或真實人物。
  • assets 角色:使用者自己擁有的角色(提供設計圖)可直接用;或是我們根據此使用者所述自行去抓取的腳色可以直接使用;素材可以自己上網找(記來源與授權,不明的要標示);歌詞只用使用者提供的文字或 LRC;參考片只學手法不抄素材;使用者自己的產品照片可以用來重建產品。
  • compare-gate 企劃逐鏡對照參考片(ref_shot + camera),完成後用 compare.py 並排比較、每鏡評分 ≥ 4 才交件。
  • look-after-render 每次渲染後抽影格用 Read 看,有問題修完再出片。
  • secrets API 金鑰只放 ~/.reelmimic/secrets.json,由使用者自己填;不要寫入它,也不要把內容印出來(要確認有沒有設定就用 test -f)。
  • projects-private projects/ 是使用者的參考片、素材與成片,不進版本控制(不要 git add -f)。
  • one-server 不要在真的 projects/ 上再開第二個 server(啟動時會把跑到一半的工作標成 interrupted);要套用 server 修改就跑 bash app/restart.sh,測試把 REELMIMIC_PROJECTS 指到別的資料夾。

工具

  • 需要的程式與安裝方式見 README(npm run doctor 會逐項檢查):Node 22.18+、Python 3.10+(requirements.txt)、FFmpeg、Chrome、Claude Code 或 Codex CLI。
  • 找不到 FFmpeg 時看環境變數 FFMPEG_DIR;Chrome 看 CHROME_PATH;Blender 看 BLENDER;API 金鑰在 ~/.reelmimic/secrets.json(伺服器啟動時載入)。
  • yt-dlp:python -m yt_dlp;截圖一律用 .claude/skills/video-clone/scripts/hf_frames.py(HyperFrames 專案)或引擎自己的 render 指令。
  • 背景渲染完的片:node .claude/harness/look.mts <影片> 產生縮圖總覽並掃黑畫面/定格。

資料夾

  • app/ — ReelMimic 網站(server + React 前端)
  • projects/<代號>/ — 每支影片一個專案(analysis/、plan.json、build/、out/video.mp4);不進版本控制
  • .claude/skills/ — skills:video-clone 是核心(流程、合約、風格表、工具),其他是製作引擎
  • .claude/harness/ — Claude Code hooks 與規則檢查(說明見 docs/HARNESS.md)
  • docs/ — 架構與擴充說明