JianYing Editor Skill
ユーザーが JianYing Pro の動画編集を自動化したり、草稿 (draft) を生成したり、メディアアセットを操作したい場合に使用します。
エージェント実行プレイブック: 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)
- スクリプトの配置場所: Skill の内部ディレクトリで編集用スクリプトを作成してはいけません。すべての編集ロジック実装コード(
.pyスクリプト)は、ユーザーのプロジェクトのルートディレクトリ(またはscripts/などのサブディレクトリ)に配置し、Skill ライブラリの純粋性と移植性を保ってください。 - バージョンとアーキテクチャ:
- デュアルプラットフォーム対応: MacOS(パス検出/画面録画)と Windows を完全サポートしています。
- 自動修復 (Auto-healing): v5.9+ (
draft_info.json) に対応。草稿が破損していたりバージョン競合が発生した場合は、JyProjectをoverwrite=Trueで初期化することで自動修復がトリガーされます。
- BGM の選択:
- 簡単なデモではデフォルト音楽を使用します。実際のプロジェクトでは、
data/cloud_music_library.csvから関連する曲を優先的に検索・推奨するか、動画のテーマ(例:「テクノロジー」「温かみ」)でキーワードフィルタリングを行ってください。 - ユーザーに次のように問いかけてください:「テーマに合ったクラウド音楽をいくつか見つけました。試してみませんか?(例:
Illuminate- テクノロジー感)」
- 簡単なデモではデフォルト音楽を使用します。実際のプロジェクトでは、
📋 ルールガイド (Rules)
特定のタスクや制約については、個別のルールファイルをお読みください:
- 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 - 生成編集のための思考連鎖 (Chain of Thought)。
- rules/audio-voice.md - 新機能: TTS ナレーション & BGM 調達。
🎯 エージェントクイックルーティング
- クラウド動画 + クラウド音楽:
rules/media.md+rules/audio-voice.md->examples/cloud_video_music_tts_demo.py - スマートナレーションと字幕 (Script-to-Video):
rules/text.md+rules/audio-voice.md-> コア APIadd_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)
完全なワークフローについてはこれらを参照してください:
- examples/my_first_vlog.py - BGM とアニメーションテキスト付きの完全な Vlog 作成デモ。
- examples/simple_clip_demo.py - 基本的なカットとトラック管理のためのクイックスタートチュートリアル。
- examples/compound_clip_demo.py - 新機能: プロフェッショナルなネストプロジェクト(コンパウンドクリップ)自動化。
- examples/cloud_video_music_tts_demo.py - クラウド動画 + クラウド BGM + TTS/字幕同期。
- examples/web_to_video_intro_demo.py - Web から動画へのイントロデモ(HTML アニメーション -> タイムラインクリップ)。
- examples/robust_auto_export.py - 安定した書き出しワークフローと障害処理。
- examples/auto_exposure_align_demo.py - CV 支援による露出調整ワークフロー。
- examples/video_transcribe_and_match.py - 高度: AI 駆動ワークフロー(動画文字起こし -> AI 意味解析による B-Roll マッチング -> 草稿アセンブル)。
🧠 プロンプトと統合ツール (Prompts & Integrated Tools)
複雑なタスクにはこれらのテンプレートとスクリプトを使用してください:
- アセット検索: フィルター、トランジション、アニメーションを中国語/英語名で検索:
python <SKULL_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 # Web プレビューキャプチャ (高性能) 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 にヘッドレス書き出し:
注: MP4 自動書き出しは Windows の UI Automation を使用します。macOS では草稿を生成し、手動で剪映から書き出してください。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" - テンプレートクローン&リプレーサー: 安全にテンプレートをクローンし、素材をバッチ置換(元のテンプレートを破損から保護):
# テンプレートをクローンして新規プロジェクトを作成 python <SKILL_ROOT>/scripts/jy_wrapper.py clone --template "ホテルテンプレート" --name "顧客A_コピー" - API Validator: 環境のクイック診断を実行:
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("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("新しいAI動画", overwrite=True)
assets_dir = os.path.join(skill_root, "assets")
# 3. スマートナレーションと字幕 (One-click Script-to-Video)
project.add_narrated_subtitles(
text="JianYing 自動化 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("JianYing 自動化開始", start_time="1s", duration="3s", anim_in="ヴィンテージタイプライター")
project.save()
🛠️ 初期化とプロジェクトルール (Initialization & Project Rules)
JyProject を初期化する際は、メイン動画素材のアスペクト比に応じて解像度を設定してください。デフォルトは横画面 (1920x1080) です。
🚨 スクリプト配置場所ルール
Skill インストールディレクトリ内で業務用編集スクリプトを作成しないでください。
- 正しい方法: 編集用 Python スクリプトはプロジェクトのルートディレクトリに配置します。
- 理由: Skill ディレクトリにはツールセットのソースコードのみを置き、今後の
git pullによるアップグレードを容易にするためです。業務コードが混在するとバージョン管理が混乱します。