jianying-editor

JianYing Editor Skill

ユーザーがJianYing Proで動画編集の自動化、ドラフトの生成、メディアアセットの操作を希望する場合に、このスキルを使用します。

エージェント実行プレイブック：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」に従ってください。

🚨 重要な開発原則 (重要な開発ルール)

1. スクリプトの配置場所：Skill 内部のディレクトリに編集スクリプトを作成してはいけません。すべての編集ロジック実装コード（.py スクリプト）は、Skill ライブラリの純粋性と移植性を保つため、ユーザーの現在のプロジェクトのルートディレクトリ（または scripts/ などのサブディレクトリ）に配置する必要があります。
2. バージョンとアーキテクチャ：
   • デュアルプラットフォーム対応：MacOS（パス検出／画面録画）と Windows を全面的にサポートしています。
   • 自動修復：v5.9+ (draft_info.json) をサポートしています。ドラフトが破損している場合やバージョンが競合している場合は、overwrite=True を指定して JyProject を初期化すると、自動修復を実行できます。
3. BGM の選択：
   • 簡単なデモではデフォルトの音楽を使用します。実際のプロジェクトでは、まず data/cloud_music_library.csv から関連する楽曲を検索しておすすめするか、動画のテーマ（「テクノロジー」、「温かみ」など）に基づいてキーワードで絞り込んでください。
   • ユーザーに次のように尋ねてください：「テーマに合うクラウド音楽が数曲見つかりました。試してみますか？（例：Illuminate - テクノロジー感）」

ルールガイド (ルール)

具体的なタスクと制約については、各ルールファイルを参照してください。

• rules/setup.md - すべてのスクリプトで必須の初期化コードです。
• rules/core.md - 基本操作：保存、エクスポート、ドラフト管理。
• rules/cli.md - CLI の仕様と、機械可読な出力の規約。
• rules/media.md - アセットのインポートとAI 動画分析の最適化（30m/360p）。
• rules/text.md - 字幕、テキスト、キャプションの追加。
• rules/keyframes.md - 高度な内容：キーフレームアニメーションの追加。
• rules/effects.md - フィルター、エフェクト、トランジションの検索と適用。
• rules/recording.md - 新機能：画面録画とスマートズームの自動化。
• rules/web-vfx.md - 高度な内容：Web から動画を生成。
• rules/generative.md - 生成編集の思考連鎖。
• rules/audio-voice.md - 新機能：TTS ナレーションと BGM の調達。

🎯 エージェントのクイックルーティング

• クラウド動画 + クラウド音楽：rules/media.md + rules/audio-voice.md -> examples/cloud_video_music_tts_demo.py
• AI ナレーションと字幕（台本から動画を生成）：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/my_first_vlog.py - BGM とアニメーションテキストを使った、Vlog 作成の完全なデモです。
• examples/simple_clip_demo.py - 基本的なカット編集とトラック管理のクイックスタートチュートリアルです。
• examples/compound_clip_demo.py - 新機能：プロ仕様のネストされたプロジェクト（Compound Clip）の自動化です。
• examples/cloud_video_music_tts_demo.py - クラウド動画＋クラウド BGM＋TTS／字幕の同期です。
• examples/web_to_video_intro_demo.py - Web-to-Video のイントロデモ（HTML アニメーション → タイムラインクリップ）です。
• examples/robust_auto_export.py - 安定したエクスポートのワークフローとエラー処理です。
• examples/auto_exposure_align_demo.py - CV を活用した露出調整のワークフローです。
• examples/video_transcribe_and_match.py - 上級者向け：AI 主導のワークフロー（動画の文字起こし → AI による意味解析を使った B ロールのマッチング → ドラフトの作成）です。

🧠 プロンプトと統合ツール

複雑なタスクには、以下のテンプレートとスクリプトを使用してください。

• 素材検索：中国語／英語の名前からフィルター、トランジション、アニメーションを検索します。

  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"
  

• ネイティブ素材の同期：JianYing アプリでお気に入り登録または再生した BGM／スタイルを 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 からチュートリアルを作成：プロジェクトの README.md を、インストール手順を網羅した動画スクリプトに変換します。
  • プロンプトを読み込みます：prompts/readme_to_tutorial.md
  • {{README_CONTENT}} 変数に内容を挿入します。
• スクリーンレコーダーとスマートズーム：画面を録画し、ズームのキーフレームを自動適用します。

  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"
  

• ドラフトインスペクター：ドラフトの構造とメタデータを確認します（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
  # For SRT only:
  python <SKILL_ROOT>/scripts/jy_wrapper.py export-srt --name "DraftName"
  

  注：MP4 の自動エクスポートでは、Windows UI Automation を使用します。macOS では、ドラフトを生成してから JianYing で手動でエクスポートしてください。
• テンプレートの複製と置換：テンプレートを安全に複製し、素材を一括置換します（元のテンプレートの破損を防止します）。

  # 克隆模板生成新项目
  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. 智能配音与字幕 (One-click 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()

🛠️ 初期化とプロジェクトのルール

JyProject を初期化する際は、メイン動画素材のアスペクト比に合わせて解像度を設定してください。デフォルト値は横向き（1920x1080）です。

🚨 スクリプトの保存場所に関する規則

Skill のインストールディレクトリ内に、編集用スクリプトを作成しないでください。

• 推奨される方法：編集用の Python スクリプトは、プロジェクトのルートディレクトリに配置します。
• 理由：Skill ディレクトリにはツールセットのソースコードのみを格納し、後から git pull でアップグレードしやすくする必要があります。業務コードが混在すると、バージョン管理が煩雑になります。