Communitygithub.com

JianYing (剪映) AI自动剪辑 Skill

剪映 Pro を自動操作する高級 API (JyWrapper)。録画、素材取込、字幕生成、Web 動画合成、プロジェクト出力などを Python で完結。MacOS (Apple Silicon/Intel) と Windows に対応。

JianYing (剪映) AI自动剪辑 Skill とは?

この Skill は、AI エージェント (Claude Code、Cursor、Codex など) が剪映 Pro (JianYing Pro) を完全自動操作するための Python ラッパー (JyWrapper) を提供します。ユーザーは録画、メディア素材のインポート、AI ナレーション付き字幕生成、Web 動画 (HTML/CSS/JS) のタイムライン合成、そして MP4 や SRT への書き出しまでをコードで実行できます。v5.9+ の `draft_info.json` アーキテクチャを完全サポートし、破損したプロジェクトは自動修復されます。対応プラットフォームは MacOS (Apple Silicon および Intel) と Windows で、画面録画とスマートズーム機能も内蔵しています。開発者はこの Skill を使うことで、手動操作なしで動画編集パイプラインを構築でき、テンプレートの複製・素材差し替え、AI 意味解析による B-Roll マッチング、バッチ出力など高度なワークフローも実現可能です。

対応✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/jianying-editor-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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)

  1. スクリプトの配置場所: Skill の内部ディレクトリで編集用スクリプトを作成してはいけません。すべての編集ロジック実装コード(.py スクリプト)は、ユーザーのプロジェクトのルートディレクトリ(または scripts/ などのサブディレクトリ)に配置し、Skill ライブラリの純粋性と移植性を保ってください。
  2. バージョンとアーキテクチャ:
    • デュアルプラットフォーム対応: MacOS(パス検出/画面録画)と Windows を完全サポートしています。
    • 自動修復 (Auto-healing): v5.9+ (draft_info.json) に対応。草稿が破損していたりバージョン競合が発生した場合は、JyProject を overwrite=True で初期化することで自動修復がトリガーされます。
  3. BGM の選択:
    • 簡単なデモではデフォルト音楽を使用します。実際のプロジェクトでは、data/cloud_music_library.csv から関連する曲を優先的に検索・推奨するか、動画のテーマ(例:「テクノロジー」「温かみ」)でキーワードフィルタリングを行ってください。
    • ユーザーに次のように問いかけてください:「テーマに合ったクラウド音楽をいくつか見つけました。試してみませんか?(例:Illuminate - テクノロジー感)」

📋 ルールガイド (Rules)

特定のタスクや制約については、個別のルールファイルをお読みください:

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

  • クラウド動画 + クラウド音楽: 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)

完全なワークフローについてはこれらを参照してください:

🧠 プロンプトと統合ツール (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 にヘッドレス書き出し:
    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"
    
    注: MP4 自動書き出しは Windows の UI Automation を使用します。macOS では草稿を生成し、手動で剪映から書き出してください。
  • テンプレートクローン&リプレーサー: 安全にテンプレートをクローンし、素材をバッチ置換(元のテンプレートを破損から保護):
    # テンプレートをクローンして新規プロジェクトを作成
    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 によるアップグレードを容易にするためです。業務コードが混在するとバージョン管理が混乱します。

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

2789927464king-jpg/video-skill-ku

剪辑环境的唯一管理者:就绪检查(skills 是否最新 → Runtime 是否配套)、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用;业务 Skill(剪口播/字幕/画面/导出)第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。

2789927464king-jpg/video-skill-ku

剪辑中文口播原素材:逐词转录、词典修字出修字表、五轮扫描找口误与重复、汇总表与重复句子表、打开 Studio 让用户复核、复盘沉淀用户偏好与词典。只产出一份已复核的删词账本,不切媒体、不做字幕、不做分镜动画。用户说剪口播、处理口误、生成口播基础素材、继续剪口播,或确认卡回传 action=return_cut_review 时使用。不要用于执行物理剪切、导出剪后视频、单独安装、单独打开工作台或口播分镜成片。

2789927464king-jpg/video-skill-ku

把剪好的口播烧成一个成片文件:账本切片段、推近、字幕、HTML 画面层,一次全部烧进 mp4。用户说导出、出成片、烧字幕、渲染、导出视频、生成最终文件时使用。不要用于生成删词候选、写字幕、做画面动画。

2789927464king-jpg/video-skill-ku

整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub Issue、这个问题告诉开发者,或要求继续提交已预览的 Bug 草稿时使用。不要用于功能建议、普通排错、代码提交或未获用户确认的自动上报。

2789927464king-jpg/video-skill-ku

给剪好的口播做字幕:直接用已有的逐词稿加账本算出剪后时间(不必导出、不必重新转录)、用词典和作者文稿改写听错的专名、按句子分屏、在 Studio 里逐屏复核。用户说做字幕、加字幕、改字幕、重新分屏、字幕不对时使用。不要用于删词剪辑、物理剪切、分镜动画或成片渲染。

2789927464king-jpg/video-skill-ku

操作 chengfeng-videocut 剪辑工作台的已有工程,通过 Runtime CLI 查工程与词句位置、添加或替换画面覆盖层、移除画面、删除明确指定的词句或片段、拆分裁剪移动已有片段、调整画布比例并回读核验。用户说插入片段、删掉这句、移除动画、换个画面、调整顺序或管理时间线时使用;先区分画面覆盖与主轨顺延插入,不负责自动判断口误、创作动画、制作字幕、导出或排查安装故障。

2789927464king-jpg/video-skill-ku

Create Ian Xiaohei-style HTML/SVG motion illustrations for Chinese articles, scripts, storyboard scenes, workflow explanations, concept metaphors, and short video visual aids. Use when the user asks for 小黑 SVG、漫画感 HTML、分层 SVG 动效、把小黑生图做成 HTML/SVG、可编辑矢量动效、口播流程动画、手绘漫画动效、正文配图动画, or wants a Xiaohei illustration style adapted into controllable HTML/SVG/GSAP output instead of raster image generation.

2789927464king-jpg/video-skill-ku

给剪好的口播配画面:在录屏上盖 HTML 层(圈重点标注 / 小黑整屏动画 / 推近),层绑字幕屏、由播放器逐帧驱动、直接在预览里看。用户说做分镜、配画面、加动画、圈重点、B-roll、做 storyboard 时使用。不要用于删词剪辑、字幕、物理剪切或成片渲染。

関連スキル