Communitygithub.com

doc-real

Doc Real 是一種紀錄片風格的影片編輯技能:包含信箱式寬螢幕、電影級調色、小型小寫字幕與地點標籤。適合用於微紀錄片、創業家故事、旅遊、訪談、品牌影片。可將原始片段轉變為完整的 9:16 編輯成品,並使用 video-studio-core 引擎(含轉錄、自動剪輯、動態圖形、音效、調色)。

doc-real 是什麼?

Doc Real 是一款針對 Claude AI 代理設計的影片編輯風格技能,專門用於打造紀錄片寫實風格的 9:16 垂直影片。它會將原始談話片段自動轉換為具備信箱式寬螢幕(letterbox)、電影級調色、顆粒感、緩慢鏡頭推進、小型小寫白色字幕以及左上角地點/章節標籤的成品。此技能高度依賴 video-studio-core 引擎,需先安裝該核心技能才能運作。工作流程包括:使用 `run.py` 生成初步剪輯計劃、透過 `render.py` 渲染關鍵影格預覽、最後以 `finish.py` 輸出最終影片。使用者可以透過修改 `plan.json` 中的 `--title` 引數(例如地點與時間)或自訂 `theme.json` 與 `theme.css` 來調整整體風格。Doc Real 特別適合微紀錄片、創業家故事、旅遊影片、訪談與品牌形象片等內容類型。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Viprasol-Tech/claude-video-editing-skills/tree/HEAD/plugins/video-studio/skills/doc-real

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Doc Real

紀錄片寫實風格:信箱式寬螢幕、電影級調色、小型小寫字幕與地點標籤。

  • 最佳用途: 微紀錄片、創業家故事、旅遊、訪談、品牌影片
  • 類別: 談話頭短片
  • 預設格式: 9:16(可使用 --format 9:16 | 1:1 | 4:5 | 16:9 變更)
  • 需要攝影機素材: 是,一段原始談話片段
  • 發言者背後文字: 否

開始之前

此風格需依賴 video-studio-core 技能執行,該技能必須安裝於相同的技能資料夾中。

  • CORE = 與此技能資料夾相鄰的 video-studio-core 資料夾(例如 ~/.claude/skills/video-studio-core)。
  • STYLE = 此技能本身的資料夾(內含 theme.json 與 theme.css)。
  • 首次在某台機器上執行時:python CORE/scripts/check_env.py,並修復其報告的任何問題。
  • 如果缺少 CORE,請告知使用者從同一套件安裝 video-studio-core。

進行編輯

python CORE/scripts/run.py clip.mp4 --style STYLE --work edit-doc-real --stop-after plan --title "地點, 時間"
# 接下來請 refine edit-*/plan.json(見下方說明),然後檢查預覽影格:
python CORE/scripts/render.py edit-doc-real/plan.json --frames 1,3,6,9
python CORE/scripts/render.py edit-doc-real/plan.json
python CORE/scripts/finish.py edit-doc-real/plan.json

在完整渲染前,請先開啟 contact_sheet.png 並仔細檢視。最終影片會以 final.mp4 名稱存放在工作資料夾中。 若要輸出額外尺寸,請在 finish.py 中使用 --formats 1:1,16:9。若要在計劃中加入音樂,請在 plan 中加入 "music": {"src": "track.mp3", "volume": 0.12}。

視覺風格

  • 信箱式黑色邊框、電影級調色、顆粒感、緩慢鏡頭推進。字幕為小寫、白色、置中偏低。
  • 影片前 3 秒左上角顯示小型地點或章節標籤。無縮放、無表情符號、無音效。

優化剪輯計劃

make_plan.py 產生的草稿是自動化的。請將其精鍊:

  • 閱讀 words.json,並將開頭(前 2-3 秒)的鉤子重寫為簡短、具體的承諾。
  • 將自動選取的弱關鍵字替換為承載核心意義的字詞(數字、成果、名稱、對比)。
  • 修正 words 陣列中任何誤聽的字詞(保留其時間戳記)。
  • 透過 --title 傳遞地點/情境(例如 'julana, haryana — 6:40 am')。
  • 對於較長的影片,請加入類別為 dr-chapter 的 titlecard 章節分隔。
  • 元素類型與欄位說明請參考:CORE/references/plan-schema.md。

交付前檢查

  • 聯絡表:文字可讀、無內容被裁切、無覆蓋臉部(除非有意為之)、安全區域正確(9:16 格式:文字維持在畫面高度的 10% 至 85% 之間)。
  • 注意時間點:疊加元素應與說話內容同步落地,而非之後。
  • 使用 ffprobe 檢查最終檔案:確認尺寸、時長與音訊皆正確。
  • 告知使用者你剪掉了多少(移除的秒數)、這個風格增添了什麼視覺效果,以及最終檔案的位置。

變更視覺風格

顏色與字型設定在 theme.json(vars、fontsUrl)與 theme.css 中。若要進行一次性變更,請直接在 plan.json 中修改(theme.vars、元素 style),而不修改技能檔案本身。

範例請求

  • "紀錄片風格的編輯。"
  • "讓我的故事看起來像 Netflix 紀錄片。"
  • "帶有地點標籤的電影級紀錄片風格。"

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能