Communitygithub.com

剪映編輯器技能 (JianYing Editor Skill)

為剪映 (JianYing) AI 自動化剪輯提供 Python 封裝 API (JyWrapper),支援錄影、素材導入、字幕產生、Web 動態合成及專案匯出,適用於 MacOS 與 Windows。

剪映編輯器技能 (JianYing Editor Skill) 是什麼?

這項技能為開發人員與 AI 代理提供一個強大的 Python 介面,用以自動化剪映 Pro 的影片編輯。它提供開箱即用的 API 來建立、修改與匯出剪映草稿,無需手動操作。核心功能包括:初始化與自動修復的專案管理、安全導入媒體素材、使用 TTS 語音旁白與字幕產生、動畫文字與濾鏡效果、螢幕錄製與智慧變焦,以及基於 Web 的動畫合成。支援 MacOS(Apple Silicon 與 Intel)與 Windows 平台,基於剪映 v5.9+ 的 draft_info.json 架構。該技能強制執行腳本放置規範:使用者實作程式碼應置於其專案目錄中,以保持技能本身的純淨性與可移植性。它還包括配樂選擇指引,建議根據影片主題從社群雲端音樂庫中選取。提供完整範例與 CLI 工具,方便整合。

相容平台✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/jianying-editor-skill

在你喜歡的 AI 中提問

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

說明文件

剪映編輯器技能 (JianYing Editor Skill) 是做什麼的?

當用戶想要自動化影片編輯、產生草稿或操作剪映 Pro 中的媒體素材時,使用此技能。

Agent 執行手冊:docs/agent-playbook.md

最小指令 SOP:docs/minimal-command-sop.md 自然語言使用指南:usage.md 草稿檢查器 CLI: python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20 python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "DraftName" python <SKILL_ROOT>/scripts/draft_inspector.py show --name "DraftName" --kind content --json 對於一般編輯請求,請始終遵循該手冊中的「快速編輯執行範本」和「驗收檢查清單」。

🚨 重要開發原則 (CRITICAL DEVELOPER RULES)

  1. 腳本位置:禁止在 Skill 內部目錄建立剪輯腳本。所有的剪輯邏輯實作程式碼(.py 腳本)必須存放在使用者目前專案的根目錄(或子目錄,如 scripts/),以保持 Skill 庫的純淨和可移植性。
  2. 版本與架構:
    • 雙平台適配:已全面支援 MacOS (路徑探測/錄影) 與 Windows。
    • Auto-healing:支援 v5.9+ (draft_info.json)。若草稿損壞或版本衝突,使用 overwrite=True 初始化 JyProject 可觸發自動修復。
  3. 配樂選擇:
    • 簡單示範使用預設音樂。實際專案,應優先檢索並推薦 data/cloud_music_library.csv 中的相關曲目,或根據影片主題(如「科技」、「溫暖」)進行關鍵字過濾。
    • 詢問使用者:「我發現了幾首符合主題的雲端音樂,要不要試試看?(如:Illuminate - 科技感)」。

📜 規則指南 (Rules)

請閱讀各個規則檔案以了解特定任務和限制:

🎯 Agent 快速路由

  • 雲端影片 + 雲端音樂:rules/media.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py
  • 智慧配音與字幕 (Script-to-Video):rules/text.md + rules/audio-voice.md -> 核心 API add_narrated_subtitles
  • 旁白與字幕對齊:rules/text.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py
  • 錄影與智慧變焦:rules/recording.md -> tools/recording/recorder.py
  • 批次匯出/無頭匯出:rules/core.md + rules/cli.md -> examples/robust_auto_export.py
  • 影視解說生成:rules/generative.md -> scripts/movie_commentary_builder.py

📖 經典範例 (Examples)

參考以下範例以了解完整工作流程:

🧠 提示詞與整合工具 (Prompts & Integrated Tools)

對於複雜任務,請使用這些範本與腳本:

  • 素材搜尋:以中文/英文名稱尋找濾鏡、轉場與動畫:
    python <SKILL_ROOT>/scripts/asset_search.py "復古" -c filters
    
  • 電影解說生成器:從分鏡 JSON 產生 60 秒解說影片:
    python <SKILL_ROOT>/scripts/movie_commentary_builder.py --video "video.mp4" --json "storyboard.json"
    
  • 同步原生素材:從剪映 App 匯入您收藏/播放過的背景音樂/樣式到 Skill:
    python <SKILL_ROOT>/scripts/sync_jy_assets.py
    # 從現有草稿索引雲端素材
    python <SKILL_ROOT>/scripts/build_cloud_music_library.py
    python <SKILL_ROOT>/scripts/build_cloud_text_styles_library.py
    
  • README 轉教學影片:將專案的 README.md 轉換為完整的安裝教學影片腳本:
    • 閱讀提示:prompts/readme_to_tutorial.md
    • 將內容注入 {{README_CONTENT}} 變數
  • 螢幕錄製器與智慧變焦:錄製螢幕並自動套用變焦關鍵影格:
    python <SKILL_ROOT>/tools/recording/recorder.py
    # 網頁預覽擷取 (高效能)
    python <SKILL_ROOT>/scripts/web_recorder.py --url "http://localhost:3000" --duration 5
    # 或對現有影片套用變焦:
    python <SKILL_ROOT>/scripts/jy_wrapper.py apply-zoom --name "Project" --video "v.mp4" --json "e.json"
    
  • 草稿檢查器:檢查草稿結構與元資料(支援 v5.9+):
    python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20
    python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "DraftName"
    
  • 自動匯出器:無頭匯出草稿為 MP4/SRT:
    python <SKILL_ROOT>/scripts/auto_exporter.py "DraftName" "output.mp4" --res 1080 --fps 60
    # 僅匯出 SRT:
    python <SKILL_ROOT>/scripts/jy_wrapper.py export-srt --name "DraftName"
    
    注意:MP4 自動匯出使用 Windows UI Automation。在 macOS 上,請產生草稿並從剪映手動匯出。
  • 範本複製與取代器:安全複製範本並批次取代素材(防止損壞原範本):
    # 複製範本產生新專案
    python <SKILL_ROOT>/scripts/jy_wrapper.py clone --template "飯店範本" --name "客戶A_副本"
    
  • API 驗證器:執行環境的快速診斷:
    python <SKILL_ROOT>/scripts/api_validator.py
    

🚀 快速開始範例

import os
import sys

# 1. 環境初始化 (必須同步到腳本開頭,支援 Win/Mac)
current_dir = os.path.dirname(os.path.abspath(__file__))
env_root = os.getenv("JY_SKILL_ROOT", "").strip()
# 探測 Skill 路徑 (支援 Antigravity, Trae, Claude 等)
skill_root = next((p for p in [
    env_root,
    os.path.join(current_dir, ".agents", "skills", "jianying-editor"),
    os.path.join(current_dir, ".agent", "skills", "jianying-editor"),
    os.path.join(current_dir, ".trae", "skills", "jianying-editor"),
    os.path.join(current_dir, ".claude", "skills", "jianying-editor"),
    os.path.join(current_dir, "skills", "jianying-editor"),
    os.path.abspath(".agents/skills/jianying-editor"),
    os.path.abspath(".agent/skills/jianying-editor"),
    os.path.abspath(".trae/skills/jianying-editor"),
    os.path.abspath(".claude/skills/jianying-editor"),
    os.path.abspath("skills/jianying-editor"),
    os.path.dirname(current_dir)
] if p and os.path.exists(os.path.join(p, "scripts", "jy_wrapper.py"))), None)

if not skill_root: raise ImportError("Could not find jianying-editor skill root.")
sys.path.insert(0, os.path.join(skill_root, "scripts"))
from jy_wrapper import JyProject

if __name__ == "__main__":
    # 2. 初始化專案 (支援 v5.9+ 及自修復)
    project = JyProject("New AI Video", overwrite=True)
    assets_dir = os.path.join(skill_root, "assets")

    # 3. 智慧配音與字幕 (一鍵 Script-to-Video)
    project.add_narrated_subtitles(
        text="歡迎使用剪映自動化 Skill。這是一個全面適配 MacOS 的進階版本。",
        speaker="zh_female_xiaopengyou"
    )

    # 4. 導入額外素材
    project.add_media_safe(os.path.join(assets_dir, "video.mp4"), "0s")
    project.add_media_safe(os.path.join(assets_dir, "audio.mp3"), "0s", track_name="Audio")

    # 5. 添加帶動畫的標題
    project.add_text_simple("剪映自動化開啟", start_time="1s", duration="3s", anim_in="復古打字機")

    project.save()

🛠️ 初始化與專案規範 (Initialization & Project Rules)

在初始化 JyProject 時,請務必根據主影片素材的比例設定解析度。預設值為橫屏 (1920x1080)。

🚨 腳本存放位置規範

禁止在 Skill 安裝目錄下建立你的業務剪輯腳本。

  • 正確做法:將你的剪輯 Python 腳本放在專案的根目錄。
  • 原因:Skill 目錄應該只包含工具集原始碼,便於後續 git pull 升級。業務程式碼混入會導致版本管理混亂。

Individual skills in this repo

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

2789927464king-jpg/video-skill-ku

剪辑环境的唯一管理者:就绪检查(skills 是否最新 → Runtime 是否配套)、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用;业务 Skill(剪口播/字幕/画面/导出)第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。

2789927464king-jpg/video-skill-ku

剪辑中文口播原素材:逐词转录、词典修字出修字表、五轮扫描找口误与重复、汇总表与重复句子表、打开 Studio 让用户复核、复盘沉淀用户偏好与词典。只产出一份已复核的删词账本,不切媒体、不做字幕、不做分镜动画。用户说剪口播、处理口误、生成口播基础素材、继续剪口播,或确认卡回传 action=return_cut_review 时使用。不要用于执行物理剪切、导出剪后视频、单独安装、单独打开工作台或口播分镜成片。

2789927464king-jpg/video-skill-ku

把剪好的口播烧成一个成片文件:账本切片段、推近、字幕、HTML 画面层,一次全部烧进 mp4。用户说导出、出成片、烧字幕、渲染、导出视频、生成最终文件时使用。不要用于生成删词候选、写字幕、做画面动画。

2789927464king-jpg/video-skill-ku

整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub Issue、这个问题告诉开发者,或要求继续提交已预览的 Bug 草稿时使用。不要用于功能建议、普通排错、代码提交或未获用户确认的自动上报。

2789927464king-jpg/video-skill-ku

给剪好的口播做字幕:直接用已有的逐词稿加账本算出剪后时间(不必导出、不必重新转录)、用词典和作者文稿改写听错的专名、按句子分屏、在 Studio 里逐屏复核。用户说做字幕、加字幕、改字幕、重新分屏、字幕不对时使用。不要用于删词剪辑、物理剪切、分镜动画或成片渲染。

2789927464king-jpg/video-skill-ku

操作 chengfeng-videocut 剪辑工作台的已有工程,通过 Runtime CLI 查工程与词句位置、添加或替换画面覆盖层、移除画面、删除明确指定的词句或片段、拆分裁剪移动已有片段、调整画布比例并回读核验。用户说插入片段、删掉这句、移除动画、换个画面、调整顺序或管理时间线时使用;先区分画面覆盖与主轨顺延插入,不负责自动判断口误、创作动画、制作字幕、导出或排查安装故障。

2789927464king-jpg/video-skill-ku

Create Ian Xiaohei-style HTML/SVG motion illustrations for Chinese articles, scripts, storyboard scenes, workflow explanations, concept metaphors, and short video visual aids. Use when the user asks for 小黑 SVG、漫画感 HTML、分层 SVG 动效、把小黑生图做成 HTML/SVG、可编辑矢量动效、口播流程动画、手绘漫画动效、正文配图动画, or wants a Xiaohei illustration style adapted into controllable HTML/SVG/GSAP output instead of raster image generation.

2789927464king-jpg/video-skill-ku

给剪好的口播配画面:在录屏上盖 HTML 层(圈重点标注 / 小黑整屏动画 / 推近),层绑字幕屏、由播放器逐帧驱动、直接在预览里看。用户说做分镜、配画面、加动画、圈重点、B-roll、做 storyboard 时使用。不要用于删词剪辑、字幕、物理剪切或成片渲染。

相關技能