jianying-editor-skill 是一個開源的 Agent 技能,讓 Claude Code、Cursor、Trae、Antigravity 透過自然語言操作剪映專業版,自動完成腳本、配音、字幕、配樂、特效、錄屏與 MP4 匯出。所有剪輯動作由 Python 腳本驅動,最終仍透過剪映原生程式算圖輸出。
jianying-editor-skill 是一套放進 AI 編輯器的技能檔。安裝後,Claude Code、Cursor、Trae、Antigravity 這類 Agent 就能讀取它的規則,把你用自然語言描述的剪輯需求,翻成一連串對剪映專業版的實際操作。你說「把這個資料夾的影片剪成 Vlog,配輕快音樂、加旁白字幕」,它就從腳本、配音、字幕、配樂一路做到匯出 MP4。
它的核心不是新的剪輯軟體,而是一批 Python 腳本加上 Markdown 規則。腳本透過內建的 pyJianYingDraft 直接讀寫剪映的草稿檔,Markdown 規則(rules/ 目錄)則告訴 Agent 遇到哪種任務該走哪條流程。最終算圖仍由剪映原生程式完成——它不是剪映的替代品,而是替你操作剪映的那雙手。
v1.5 起加入了幾項自動化:自動修復會偵測並修復損壞或過期的草稿;雲端配樂庫挖掘會萃取你過去用過的剪映雲端音樂 ID 供 AI 重用;語意素材匹配讓 AI 分析旁白語意,自動挑出對應畫面。整條流程被切成五個固定階段,前一階段的產出由後一階段自動接手。
先備齊環境:剪映專業版 5.9 或更早、Python、Git。Windows 使用者可用一行 PowerShell 一鍵安裝;其他平台依你的 AI 編輯器選對應路徑手動 clone。
每種 AI 編輯器的技能目錄不同。把 repo clone 到對應位置即可——指令只差最後的路徑。
clone 完後安裝 Python 相依套件,並讓 Playwright 下載 Chromium(網頁轉影片與部分自動化會用到)。日後更新只要進目錄 git pull。
每項能力背後都是一支可獨立執行的 Python 腳本,Agent 依任務挑選並串接。下表把十一項能力依工作階段分組:素材負責匯入與特效,音訊負責配音、字幕、配樂,生成負責錄製與影視解說,輸出負責匯出、動畫與複合片段。你不必記腳本名稱——用自然語言描述需求即可,Agent 會自行路由。
Agent 依任務類型比對 rules/ 目錄裡的規則檔,再呼叫對應腳本。下表是 SKILL.md 中記載的主要路由。
| 任務 | 路由規則檔 | 核心腳本 |
|---|---|---|
| 雲端影片 + BGM + 配音 | media.md + audio-voice.md |
cloud_video_music_tts_demo.py |
| 腳本轉影片(旁白 + 字幕) | text.md + audio-voice.md |
add_narrated_subtitles() |
| 螢幕錄製 + 變焦 | recording.md |
recorder.py |
| 批次 / 無頭匯出 | core.md + cli.md |
robust_auto_export.py |
| 影視解說 | generative.md |
movie_commentary_builder.py |
多數時候你只需用自然語言下指令,但了解底層腳本能讓你更精準地除錯與微調。以下是 SKILL.md 與 README 記載、可直接在終端執行的工具與機制。指令中的 <SKILL_ROOT> 是你的安裝路徑。
draft_inspector.py 用來列出與檢視草稿。list --limit 20 列出最近草稿,summary --name "DraftName" 看摘要,show --kind content --json 匯出完整結構。
asset_search.py "關鍵字" -c filters 在內建素材庫依關鍵字搜尋濾鏡、轉場與特效;sync_jy_assets.py 則同步剪映本地素材索引。
初始化時 JyProject 以 overwrite=True 實例化,會偵測並修復損壞或過期的草稿檔,對應 5.9+ 的 draft_info.json 架構,避免半成品卡住流程。
build_cloud_music_library.py 萃取你過去在剪映用過的雲端音樂 ID,寫入 cloud_music_library.csv,讓 AI 重用你熟悉的 BGM。文字樣式也有對應的 build_cloud_text_styles_library.py。
AI 會分析旁白或腳本的語意,自動從你的素材庫挑出對應畫面,減少手動對軌的工夫。這是 v1.5 強調的「會看懂內容」的能力。
來源 · README · v1.5auto_exporter.py "DraftName" "output.mp4" --res 1080 --fps 60 可在不開介面的情況下匯出指定草稿,方便批次處理。匯出期間請勿操作滑鼠鍵盤。
web_recorder.py --url "http://localhost:3000" --duration 5 以 Playwright 錄製 HTML / Canvas 動畫,把任意網頁畫面變成可放進時間軸的影片素材。
遇到問題先跑 api_validator.py 驗證 API 與環境設定是否就緒,再用 jy_wrapper.py export-srt --name "DraftName" 之類的封裝指令做單點操作。
以下是一段示意流程:你給 Agent 一個資料夾與一句話,它會路由到對應規則、盤點草稿、搜尋濾鏡、生成旁白與字幕、配上雲端音樂,最後無頭匯出 1080P。指令均為 SKILL.md 記載的真實語法;素材搜尋結果僅示意,實際內容依你的剪映素材庫而定。
關鍵在於路由:Agent 不是憑感覺剪片,而是先把「Vlog + 配樂 + 旁白」比對到 rules/media.md 與 rules/audio-voice.md,再呼叫各自的腳本。每一步的產出(草稿、字幕、配樂)都寫進剪映草稿檔,由下一步接手。
也因此它不是黑箱:你能用 draft_inspector.py 查看任一階段的草稿結構,卡關時自己介入。最終算圖仍由剪映完成,品質與你手動操作一致。
pip install -r requirements.txt 與 playwright install chromium。
路由邏輯寫在 rules/ 目錄的 Markdown 規則檔裡,腳本則放在 scripts/。兩者都可閱讀、可修改——你能調整流程、建立自己的素材庫,讓 Agent 越用越貼合你的剪輯習慣。
1. 客製化路由規則。打開 rules/media.md、rules/audio-voice.md 等檔案,調整 Agent 對各類任務的處理流程與預設值,毋須改 Python。
2. 建立你自己的雲端素材庫。跑 build_cloud_music_library.py 與 build_cloud_text_styles_library.py,把你慣用的雲端音樂與文字樣式 ID 萃取成資料庫,供 AI 重用。
3. 用模板複製專案。jy_wrapper.py clone --template "TemplateName" --name "NewProject" 可從既有專案複製出新草稿,適合系列影片維持一致風格。
4. 把網頁動畫做成片頭。用 web_recorder.py 錄製你寫的 HTML / Canvas 動畫(例如星空粒子片頭),再匯入時間軸,做出自訂的開場。
5. 做影視解說。用 movie_commentary_builder.py --video "video.mp4" --json "storyboard.json" 讓 AI 分析影片、產出分鏡與配音,快速做出長片解說。
① README.md——安裝、平台支援、能力總覽與限制。
② SKILL.md——Agent 實際讀取的規格:腳本指令、執行迴圈與路由規則。
③ usage.md——更完整的使用情境與範例。