Communitygithub.com

剪映 AI 自动化剪辑 Skill

剪映 (JianYing) AI 자동화 편집을 위한 고급封装 API (JyWrapper)로, 즉시 사용 가능한 Python 인터페이스를 제공합니다. 화면 녹화,素材 가져오기, 자막 생성, 웹 모션 합성 및 프로젝트 내보내기를 지원합니다. MacOS (Apple Silicon/Intel) 및 Windows를 완전히 지원하며, v5.9+ (draft_info.json) 아키텍처, 자동 복구, 지능형 더빙 자막 및 화면 녹화 줌에 대응합니다.

剪映 AI 自动化剪辑 Skill란 무엇인가요?

이 Skill은剪映(JianYing) Pro의 고급 AI 자동화 편집 기능을 제공합니다. JyWrapper라는 이름의封装 API를 통해, 사용자는 Python 스크립트로剪映 프로젝트를 생성, 수정, 내보낼 수 있습니다. 주요 기능으로는 화면 녹화,素材 가져오기, TTS 더빙 및 자동 자막 생성, Web-to-Video 모션 합성, 템플릿 복제 및批量素材 교체, 프로젝트 자동 복구 등이 포함됩니다. MacOS와 Windows를 모두 지원하며, v5.9+ 버전의剪映 프로젝트 파일(draft_info.json)과 호환됩니다. 이 Skill은 Claude Code, Cursor, Codex, Trae 등 다양한 AI Agent 플랫폼과 함께 사용되도록 설계되었으며, 자세한 실행 규칙(예: setup.md, core.md)과 예제 스크립트를 제공하여 개발자가 빠르게 적응할 수 있도록 돕습니다. 특히 'Quick Edit Runtime Template'과 'Acceptance Checklist'를 따르는 것이 중요합니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/jianying-editor-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

JianYing Editor Skill

사용자가剪映 Pro에서 비디오 편집을 자동화하고, 드래프트를 생성하거나 미디어 에셋을 조작하려 할 때 이 Skill을 사용하세요.

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 일반 편집 요청의 경우, 항상 해당 플레이북의 "Quick Edit Runtime Template" 및 "Acceptance Checklist"를 따르세요.

🚨 중요 개발 원칙 (CRITICAL DEVELOPER RULES)

  1. 스크립트 위치: Skill 내부 디렉토리에 편집 스크립트를 생성하지 마십시오. 모든 편집 로직 구현 코드(.py 스크립트)는 사용자 현재 프로젝트의 루트 디렉토리(또는 scripts/와 같은 하위 디렉토리)에 두어 Skill 라이브러리의 순수성과 이식성을 유지해야 합니다.
  2. 버전 및 아키텍처:
    • 이중 플랫폼 지원: MacOS (경로 탐지/화면 녹화) 및 Windows를 완벽히 지원합니다.
    • 자동 복구(Auto-healing): v5.9+ (draft_info.json)을 지원합니다. 드래프트가 손상되었거나 버전 충돌이 있는 경우, JyProject를 overwrite=True로 초기화하면 자동 복구가 트리거됩니다.
  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"
    
  • 네이티브 에셋 동기화: 좋아요 표시/재생한 BGM/스타일을剪映 앱에서 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 时使用。不要用于删词剪辑、字幕、物理剪切或成片渲染。

관련 스킬