\r \r

JianYing Editor Skill\r

\r Use this skill when the user wants to automate video editing, generate drafts, or manipulate media assets in JianYing Pro.\r \r Agent execution playbook: docs/agent-playbook.md\r Minimal command SOP: docs/minimal-command-sop.md\r Draft inspector CLI:\r python \x3CSKILL_ROOT>/scripts/draft_inspector.py list --limit 20\r python \x3CSKILL_ROOT>/scripts/draft_inspector.py summary --name "DraftName"\r python \x3CSKILL_ROOT>/scripts/draft_inspector.py show --name "DraftName" --kind content --json\r For generic editing requests, always follow the "Quick Edit Runtime Template" and "Acceptance Checklist" in that playbook.\r \r

🚨 重要开发原则 (CRITICAL DEVELOPER RULES)\r

1. 脚本位置：禁止在 Skill 内部目录创建剪辑脚本。所有的剪辑逻辑实现代码（.py 脚本）必须存放在用户当前项目的根目录（或子目录，如 scripts/），以保持 Skill 库的纯净和可移植性。\r
2. 配乐选择：\r
   • 简单演示使用默认音乐。实际项目，应优先检索并推荐 data/cloud_music_library.csv 中的相关曲目，或根据视频主题（如“科技”、“温暖”）进行关键词过滤。\r
   • 询问用户：“我发现了几首符合主题的云端音乐，要不要试试？（如：Illuminate - 科技感）”。\r \r

规则指南 (Rules)\r

\r Read the individual rule files for specific tasks and constraints:\r \r

• rules/setup.md - Mandatory initialization code for all scripts.\r
• rules/core.md - Core operations: Saving, Exporting, and Draft management.\r
• rules/cli.md - CLI contracts and machine-readable output conventions.\r
• rules/media.md - Importing assets & AI Video Analysis Optimization (30m/360p).\r
• rules/text.md - Adding Subtitles, Text, and Captions.\r
• rules/keyframes.md - Advanced: Adding Keyframe animations.\r
• rules/effects.md - Searching for and applying Filters, Effects, and Transitions.\r
• rules/recording.md - New: Screen Recording & Smart Zoom automation.\r
• rules/web-vfx.md - Advanced: Web-to-Video generation.\r
• rules/generative.md - Chain of Thought for generative editing.\r
• rules/audio-voice.md - New: TTS Voiceover & BGM sourcing.\r \r

🎯 Agent Quick Routing\r

\r

• 云端视频 + 云端音乐：rules/media.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py\r
• 旁白与字幕对齐：rules/text.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py\r
• 录屏与智能变焦：rules/recording.md -> tools/recording/recorder.py\r
• 批量导出/无头导出：rules/core.md + rules/cli.md -> examples/robust_auto_export.py\r
• 影视解说生成：rules/generative.md -> scripts/movie_commentary_builder.py\r \r

📖 经典示例 (Examples)\r

\r Refer to these for complete workflows:\r

• examples/my_first_vlog.py - A complete vlog creation demo with background music and animated text.\r
• examples/simple_clip_demo.py - Quick-start tutorial for basic cutting and track management.\r
• examples/compound_clip_demo.py - New: Professional nested project (Compound Clip) automation.\r
• examples/cloud_video_music_tts_demo.py - Cloud video + cloud BGM + TTS/subtitle alignment.\r
• examples/web_to_video_intro_demo.py - Web-to-Video intro demo (HTML animation -> timeline clip).\r
• examples/robust_auto_export.py - Stable export workflow and failure handling.\r
• examples/auto_exposure_align_demo.py - CV-assisted exposure alignment workflow.\r
• examples/video_transcribe_and_match.py - Advanced: AI-driven workflow (Transcribe Video -> Match B-Roll via AI semantics -> Assemble Draft).\r \r

🧠 提示词与集成工具 (Prompts & Integrated Tools)\r

\r Use these templates and scripts for complex tasks:\r

• Asset Search: Find filters, transitions, and animations by Chinese/English name:\r

  python \x3CSKILL_ROOT>/scripts/asset_search.py "复古" -c filters\r
  ```\r
  

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

  python \x3CSKILL_ROOT>/scripts/movie_commentary_builder.py --video "video.mp4" --json "storyboard.json"\r
  ```\r
  

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

  python \x3CSKILL_ROOT>/scripts/sync_jy_assets.py\r
  ```\r
  

• README to Tutorial: Convert a project's README.md into a full installation tutorial video script:\r
  • Read prompt: prompts/readme_to_tutorial.md\r
  • Inject content into {{README_CONTENT}} variable\r
• Screen Recorder & Smart Zoom: Record your screen and auto-apply zoom keyframes:\r

  python \x3CSKILL_ROOT>/tools/recording/recorder.py\r
  # Or apply zoom to existing video:\r
  python \x3CSKILL_ROOT>/scripts/jy_wrapper.py apply-zoom --name "Project" --video "v.mp4" --json "e.json"\r
  ```\r
  

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

  python \x3CSKILL_ROOT>/scripts/auto_exporter.py "DraftName" "output.mp4" --res 1080 --fps 60\r
  # For SRT only:\r
  python \x3CSKILL_ROOT>/scripts/jy_wrapper.py export-srt --name "DraftName"\r
  ```\r
  

• Template Clone & Replacer: 安全克隆模板并批量替换物料 (防止损坏原模板):\r

  # 克隆模板生成新项目\r
  python \x3CSKILL_ROOT>/scripts/jy_wrapper.py clone --template "酒店模板" --name "客户A_副本"\r
  ```\r
  

• API Validator: Run a quick diagnostic of your environment:\r

  python \x3CSKILL_ROOT>/scripts/api_validator.py\r
  ```\r
  

\r

🚀 快速开始示例\r

\r

import os\r
import sys\r
\r
# 1. 环境初始化 (必须同步到脚本开头)\r
current_dir = os.path.dirname(os.path.abspath(__file__))\r
env_root = os.getenv("JY_SKILL_ROOT", "").strip()\r
# 探测 Skill 路径 (支持 Antigravity, Trae, Claude 等)\r
skill_root = next((p for p in [\r
    env_root,\r
    os.path.join(current_dir, ".agent", "skills", "jianying-editor"),\r
    os.path.join(current_dir, ".trae", "skills", "jianying-editor"),\r
    os.path.join(current_dir, ".claude", "skills", "jianying-editor"),\r
    os.path.join(current_dir, "skills", "jianying-editor"),\r
    os.path.abspath(".agent/skills/jianying-editor"),\r
    os.path.abspath(".trae/skills/jianying-editor"),\r
    os.path.abspath(".claude/skills/jianying-editor"),\r
    os.path.dirname(current_dir) # 如果在 examples/ 目录下\r
] if p and os.path.exists(os.path.join(p, "scripts", "jy_wrapper.py"))), None)\r
\r
if not skill_root: raise ImportError("Could not find jianying-editor skill root.")\r
sys.path.insert(0, os.path.join(skill_root, "scripts"))\r
from jy_wrapper import JyProject\r
\r
if __name__ == "__main__":\r
    project = JyProject("My Video Project")\r
    assets_dir = os.path.join(skill_root, "assets")\r
\r
    # 2. 导入视频与配乐\r
    project.add_media_safe(os.path.join(assets_dir, "video.mp4"), "0s")\r
    project.add_media_safe(os.path.join(assets_dir, "audio.mp3"), "0s", track_name="Audio")\r
\r
    # 3. 添加带动画的标题\r
    project.add_text_simple("剪映自动化开启", start_time="1s", duration="3s", anim_in="复古打字机")\r
\r
    project.save()\r
```\r
\r
## 🛠️ 初始化与项目规范 (Initialization & Project Rules)\r
\r
在初始化 `JyProject` 时，请务必根据主视频素材的比例设置分辨率。**默认值为横屏 (1920x1080)**。\r
\r
### 🚨 脚本存放位置规范\r
**禁止在 Skill 安装目录下创建你的业务剪辑脚本**。\r
- **正确做法**：将你的剪辑 Python 脚本放在项目的根目录。\r
- **原因**：Skill 目录应该只包含工具集源码，便于后续 `git pull` 升级。业务代码混入会导致版本管理混乱。\r