--- id: gh-jianying-editor-skill name: "jianying-editor-skill" url: https://skills.yangsir.net/skill/gh-jianying-editor-skill author: isYangs domain: multimedia tags: ["video-editing", "ai-automation", "jianying", "multimedia", "content-creation"] install_count: 9 rating: 4.00 (20 reviews) github: https://github.com/isYangs/jianying-editor-skill --- # jianying-editor-skill > 为剪映提供AI自动化剪辑能力，完成文案、配音、字幕、音乐与特效全流程，实现视频制作自动化。 **Stats**: 9 installs · 4.0/5 (20 reviews) ## Before / After 对比 ### 视频制作效率 **Before**: 传统视频剪辑耗时费力，需手动完成文案、配音、字幕、音乐、特效等多个环节，流程复杂，效率低下，尤其对非专业人士门槛较高。 **After**: AI Skill自动化剪辑，通过自然语言指令即可快速生成完整视频。AI智能处理文案、配音、字幕、音乐和特效，大幅简化流程，显著提升视频制作效率和质量。 | Metric | Before | After | Change | |---|---|---|---| | 效率 | 0 | 0 | 0% | ## Readme # JianYing Editor Skill Use this skill when the user wants to automate video editing, generate drafts, or manipulate media assets in JianYing Pro. Agent execution playbook: [docs/agent-playbook.md](docs/agent-playbook.md) Minimal command SOP: [docs/minimal-command-sop.md](docs/minimal-command-sop.md) Draft inspector CLI: `python /scripts/draft_inspector.py list --limit 20` `python /scripts/draft_inspector.py summary --name "DraftName"` `python /scripts/draft_inspector.py show --name "DraftName" --kind content --json` For generic editing requests, always follow the "Quick Edit Runtime Template" and "Acceptance Checklist" in that playbook. ## 🚨 重要开发原则 (CRITICAL DEVELOPER RULES) 1. **脚本位置**：**禁止在 Skill 内部目录创建剪辑脚本**。所有的剪辑逻辑实现代码（`.py` 脚本）必须存放在用户当前项目的**根目录**（或子目录，如 `scripts/`），以保持 Skill 库的纯净和可移植性。 2. **配乐选择**： - **简单演示使用默认音乐**。实际项目，应优先检索并推荐 `data/cloud_music_library.csv` 中的相关曲目，或根据视频主题（如“科技”、“温暖”）进行关键词过滤。 - 询问用户：“我发现了几首符合主题的云端音乐，要不要试试？（如：`Illuminate` - 科技感）”。 ## 规则指南 (Rules) Read the individual rule files for specific tasks and constraints: - [rules/setup.md](rules/setup.md) - **Mandatory** initialization code for all scripts. - [rules/core.md](rules/core.md) - Core operations: Saving, Exporting, and Draft management. - [rules/cli.md](rules/cli.md) - CLI contracts and machine-readable output conventions. - [rules/media.md](rules/media.md) - Importing assets & **AI Video Analysis Optimization (30m/360p)**. - [rules/text.md](rules/text.md) - Adding Subtitles, Text, and Captions. - [rules/keyframes.md](rules/keyframes.md) - **Advanced**: Adding Keyframe animations. - [rules/effects.md](rules/effects.md) - Searching for and applying Filters, Effects, and Transitions. - [rules/recording.md](rules/recording.md) - **New**: Screen Recording & Smart Zoom automation. - [rules/web-vfx.md](rules/web-vfx.md) - Advanced: Web-to-Video generation. - [rules/generative.md](rules/generative.md) - Chain of Thought for generative editing. - [rules/audio-voice.md](rules/audio-voice.md) - **New**: TTS Voiceover & BGM sourcing. ## 🎯 Agent Quick Routing - 云端视频 + 云端音乐：`rules/media.md` + `rules/audio-voice.md` -> `examples/cloud_video_music_tts_demo.py` - 旁白与字幕对齐：`rules/text.md` + `rules/audio-voice.md` -> `examples/cloud_video_music_tts_demo.py` - 录屏与智能变焦：`rules/recording.md` -> `tools/recording/recorder.py` (Windows) / `tools/recording/macos_recorder.py` (macOS) - 批量导出/无头导出：`rules/core.md` + `rules/cli.md` -> `examples/robust_auto_export.py` - 影视解说生成：`rules/generative.md` -> `scripts/movie_commentary_builder.py` ## 📖 经典示例 (Examples) Refer to these for complete workflows: - [examples/my_first_vlog.py](examples/my_first_vlog.py) - A complete vlog creation demo with background music and animated text. - [examples/simple_clip_demo.py](examples/simple_clip_demo.py) - Quick-start tutorial for basic cutting and track management. - [examples/compound_clip_demo.py](examples/compound_clip_demo.py) - **New**: Professional nested project (Compound Clip) automation. - [examples/cloud_video_music_tts_demo.py](examples/cloud_video_music_tts_demo.py) - Cloud video + cloud BGM + TTS/subtitle alignment. - [examples/web_to_video_intro_demo.py](examples/web_to_video_intro_demo.py) - Web-to-Video intro demo (HTML animation -> timeline clip). - [examples/robust_auto_export.py](examples/robust_auto_export.py) - Stable export workflow and failure handling. - [examples/auto_exposure_align_demo.py](examples/auto_exposure_align_demo.py) - CV-assisted exposure alignment workflow. - [examples/video_transcribe_and_match.py](examples/video_transcribe_and_match.py) - **Advanced**: AI-driven workflow (Transcribe Video -> Match B-Roll via AI semantics -> Assemble Draft). ## 🧠 提示词与集成工具 (Prompts & Integrated Tools) Use these templates and scripts for complex tasks: - **Asset Search**: Find filters, transitions, and animations by Chinese/English name: ```bash python /scripts/asset_search.py "复古" -c filters ``` - **Movie Commentary Builder**: Generate 60s commentary videos from a storyboard JSON: ```bash python /scripts/movie_commentary_builder.py --video "video.mp4" --json "storyboard.json" ``` - **Sync Native Assets**: Import your favorited/played BGM from JianYing App to the Skill: ```bash python /scripts/sync_jy_assets.py ``` - **README to Tutorial**: Convert a project's README.md into a full installation tutorial video script: - Read prompt: `prompts/readme_to_tutorial.md` - Inject content into `{{README_CONTENT}}` variable - **Screen Recorder & Smart Zoom**: Record your screen and auto-apply zoom keyframes: ```bash python /tools/recording/recorder.py # Or apply zoom to existing video: python /scripts/jy_wrapper.py apply-zoom --name "Project" --video "v.mp4" --json "e.json" ``` - **Auto Exporter**: Headless export of a draft to MP4/SRT: ```bash python /scripts/auto_exporter.py "DraftName" "output.mp4" --res 1080 --fps 60 # For SRT only: python /scripts/jy_wrapper.py export-srt --name "DraftName" ``` - **Template Clone & Replacer**: 安全克隆模板并批量替换物料 (防止损坏原模板): ```bash # 克隆模板生成新项目 python /scripts/jy_wrapper.py clone --template "酒店模板" --name "客户A_副本" ``` - **API Validator**: Run a quick diagnostic of your environment: ```bash python /scripts/api_validator.py ``` ## 🚀 快速开始示例 ```python import os import sys # 1. 环境初始化 (必须同步到脚本开头) 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, ".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(".agent/skills/jianying-editor"), os.path.abspath(".trae/skills/jianying-editor"), os.path.abspath(".claude/skills/jianying-editor"), os.path.dirname(current_dir) # 如果在 examples/ 目录下 ] 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__": project = JyProject("My Video Project") assets_dir = os.path.join(skill_root, "assets") # 2. 导入视频与配乐 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") # 3. 添加带动画的标题 project.add_text_simple("剪映自动化开启", start_time="1s", duration="3s", anim_in="复古打字机") project.save() ``` ## 🛠️ 初始化与项目规范 (Initialization & Project Rules) 在初始化 `JyProject` 时，请务必根据主视频素材的比例设置分辨率。**默认值为横屏 (1920x1080)**。 ### 🚨 脚本存放位置规范 **禁止在 Skill 安装目录下创建你的业务剪辑脚本**。 - **正确做法**：将你的剪辑 Python 脚本放在项目的根目录。 - **原因**：Skill 目录应该只包含工具集源码，便于后续 `git pull` 升级。业务代码混入会导致版本管理混乱。 --- *Source: https://skills.yangsir.net/skill/gh-jianying-editor-skill* *Markdown mirror: https://skills.yangsir.net/api/skill/gh-jianying-editor-skill/markdown*