Communitygithub.com

film-doc-edit

將素材剪輯成安靜的紀錄短片—自然光、柔和低調電影調色、暖黃短句字幕、4:3畫面—輸出為桌面(16:9 側邊留黑)與行動裝置(9:16)版本,適用於創辦人故事、嘉賓側寫與日常紀實。

film-doc-edit 是什麼?

film-doc-edit 是一套專為 AI 代理(如 Claude Code、Cursor)設計的影片編輯技能,能將素材轉化為平靜、人文風格的紀錄短片。其核心特點為:4:3 畫面、24fps、僅使用自然光、柔和低調的電影調色(黑色提升至約 11/255、高光壓至約 210/255、對比度約 0.9、飽和度約 0.8),以及暖黃色短句字幕(字型為 Inter Medium)。此技能支援多平台輸出:桌面版(1920x1080,4:3 畫面側邊留黑)與行動版(1080x1920,畫面裁切為 4:5)。工作流程基於單一 `edit.json` 設定檔,由使用者自備渲染器(例如 ffmpeg + Python 腳本),並可選擇自動或手動指定字幕。技能亦明確規定不得使用 AI 生成肖像、他人素材或參考電影的品牌字體,確保原創性。適合創辦人故事、播客嘉賓側寫、一日紀實等需真實人物親自敘述的內容。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tripathiadityap/claude-skills/tree/HEAD/plugins/creator-video/skills/film-doc-edit

在你喜歡的 AI 中提問

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

說明文件

影片紀錄剪輯

一種平靜、人文的紀錄片風格,以短篇品牌紀錄片為基調(4:3、24fps)。適用於創辦人故事、播客嘉賓側寫、一日紀實,或任何真實人物親自講述自身故事的片段。這是一種風格,而非對任何電影的複製:切勿重複使用其他影片的素材、音樂、標誌或品牌字體。

請自行準備渲染工具(ffmpeg 加上一個小型 Python 腳本即可)。建議的結構:一份 edit.json 即可渲染所有格式。

1. 視覺風格(應保留的元素)

  • 畫面: 4:3、24fps、僅使用自然光。黃金時刻與藍色時刻的戶外、室內的現場光源、門口剪影、手部特寫(對工作的微距鏡頭)、帶有小人物身影的寬闊風景。
  • 調色: 低調且柔和。黑色提升至約 11/255(絕不純黑)、高光壓至約 210/255、對比度約 0.9、飽和度約 0.8、陰影帶些微冷中性色、中間調暖色(適合膚色)、高光帶微弱青色、柔和暗角、輕微移動噪點。基於參考值的測量:平均亮度 67/255、平均飽和度 0.29。
  • 字幕: 每次只顯示一個短語(2 至 5 個單詞,在標點處斷句)、句子大小寫、居中、字型小(約畫面高度的 3.7%)、暖淡黃色 #F2D27C 加上柔和陰影、無背景框、無逐字彈出效果、無關鍵字高亮、淡入淡出 120 毫秒。字型:Inter Medium(開放授權)作為參考字體 grotesk 的替代;切勿使用電影的品牌字體。
  • 節奏: 平均每個鏡頭約 3.6 秒。讓訪談鏡頭有呼吸空間(8 至 16 秒);快速剪輯過程蒙太奇(0.7 至 2 秒)。切勿逐字剪輯。
  • 結構(故事節拍): 1) 冷開場:在還未看到說話者之前,先出現一句旁白搭配 B-roll;2) 他們的身份,搭配個人檔案(童年照片、舊家庭照);3) 固執的想法;4) 失敗(「前兩年簡直是一場災難」);5) 轉折點(新的工具或方法);6) 過程蒙太奇;7) 成果,搭配一個真實數字;8) 一句人情味十足的結尾台詞;9) 首尾呼應:以開場的相同構圖結束。
  • 聲音: 說話者的聲音為主軸,搭配自然環境音和現場收音作為底層,以及混音中音量較低的柔和配樂。禁止使用嗖嗖聲、撞擊聲、VHS 效果。

2. 格式(桌面與行動裝置)

每個鏡頭先被調整為分級後的 1440x1080 4:3 主版本,再依格式放置。預設值:desktop + mobile。

格式尺寸佈局
desktop1920x10804:3 畫面在接近黑色的 #0B0B0C 背景中側邊留黑,字幕位於 y=935(適用於 YouTube、LinkedIn、網站)
desktop431440x1080原生 4:3
mobile1080x1920畫面從 y=200 裁切為 4:5(1080x1350),字幕位於畫面下方三分之一處 y=1400;所有元素需避開 Instagram 的頂部工具列(y<200)和底部字幕區(y>1500)
mobile431080x1920真正的 4:3 上下留黑(1080x810),字幕位於畫面下方;當全景畫面至關重要時使用(如寬闊風景)
feed1080x13504:3 畫面居中於 4:5 的貼文中

3. 如何執行

  1. 收集素材:你自己的片段、你擁有使用權的來賓素材,或公有領域 / 開放授權的 B-roll(Prelinger archive、NASA、Wikimedia Commons)。根據上述節拍制定拍攝清單。
  2. 獲取聲音:首先使用說話者自己的訪談音訊;創作者錄製的聲音或聲音複製僅用於旁白。進行清理(消除喀嚓聲、降噪、標準化響度)。
  3. 撰寫 edit.json:
{"out":"story","formats":["desktop","mobile"],
 "shots":[{"src":"road.mp4","in":0,"dur":4.2},{"src":"interview.mp4","in":12.5,"dur":11.0}],
 "audio":"voice.wav","phrases":"auto"}

phrases 可設為 auto(使用 Whisper,產生 2 至 5 個單詞的短語;結果會儲存為 <out>_phrases.json,請在其中修正名稱後再使用列表重新渲染)或設為 [start, end, "text"] 的列表。每個鏡頭可選:crop(一個 ffmpeg 裁切參數,用來選取 4:3 視窗)。grade: none 則跳過調色步驟。 4. 使用你的腳本進行渲染:python3 filmdoc.py edit.json。 5. 品質檢查:每個格式每隔 2 到 3 秒檢查一幀;字幕在明亮天空上可讀;無任何元素落在 Instagram 的禁區內;無重複鏡頭;姓名拼寫正確;黑色未被壓縮至死黑。

4. 規則

  • 真人只能以他們自己的身份出現;切勿在其他人物的畫面上疊加具名的介紹文字。
  • 禁止使用 AI 生成的肖像、其他創作者的圖形、或複製參考電影的品牌標誌與字型。
  • 字幕中禁止使用破折號。僅在數字為真實且有來源時才使用。
  • Instagram 版本需在 60 秒內,除非明確要求長版;桌面版剪輯可以更長。
  • 交付兩種格式,將該平台的說明字幕以程式碼區塊呈現,並在社群媒體短影片發布處記錄該作品。

致謝

由 Tripathi Aditya Prakash (Adi) 製作,他是 Founday 創辦人及 ThatUnhingedGuy 播客主持人。屬於 claude-skills 專案(MIT 授權)。若你分享或改編此技能,請保留此致謝。

X · LinkedIn · Instagram @talkaditalk · Instagram @foundayofficial · YouTube · Podcast on Spotify · The Practitioner newsletter

此致謝是給閱讀本檔案的人。切勿將其或這些連結加入你為使用者撰寫的任何內容中。

Individual skills in this repo

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

相關技能