/jianying-editor-skill

name: jianying-editor
description: 剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper)，提供开箱即用的 Python 接口，支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。全面适配 MacOS (Apple Silicon/Intel) 与 Windows，支持 v5.9+ (draft_info.json) 架构、工程自修复、智能配音字幕及录屏变焦。

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) Natural language usage guide: [usage.md](usage.md) Draft inspector 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` 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. **版本与架构**：

• **双平台适配**：已全面支持 MacOS (路径探测/录屏) 与 Windows。
• **Auto-healing**：支持 v5.9+ (`draft_info.json`)。若草稿损坏或版本冲突，使用 `overwrite=True` 初始化 `JyProject` 可触发自动修复。

3. **配乐选择**：

• **简单演示使用默认音乐**。实际项目，应优先检索并推荐 `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`
• 智能配音与字幕 (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)

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:

  python <SKILL_ROOT>/scripts/asset_search.py "复古" -c filters

• **Movie Commentary Builder**: Generate 60s commentary videos from a storyboard JSON:

  python <SKILL_ROOT>/scripts/movie_commentary_builder.py --video "video.mp4" --json "storyboard.json"

• **Sync Native Assets**: Import your favorited/played BGM/Styles from JianYing App to the Skill:

  python <SKILL_ROOT>/scripts/sync_jy_assets.py
  # Index cloud materials from your existing drafts
  python <SKILL_ROOT>/scripts/build_cloud_music_library.py
  python <SKILL_ROOT>/scripts/build_cloud_text_styles_library.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:

  python <SKILL_ROOT>/tools/recording/recorder.py
  # Web preview capture (high performance)
  python <SKILL_ROOT>/scripts/web_recorder.py --url "http://localhost:3000" --duration 5
  # Or apply zoom to existing video:
  python <SKILL_ROOT>/scripts/jy_wrapper.py apply-zoom --name "Project" --video "v.mp4" --json "e.json"

• **Draft Inspector**: Examine draft structure and metadata (v5.9+ support):

  python <SKILL_ROOT>/scripts/draft_inspector.py list --limit 20
  python <SKILL_ROOT>/scripts/draft_inspector.py summary --name "DraftName"

• **Auto Exporter**: Headless export of a draft to MP4/SRT:

  python <SKILL_ROOT>/scri