ホーム / 全スキル / コンテンツ制作 / video-edit
English (EN)简体中文 (ZH)日本語 (JA)
コンテンツ制作 · prime-skills/runcomfy-agent-skills

video-edit

RunComfy 上の既存動画を編集 — 本スキルは、ユーザーの意図を RunComfy カタログ内の最適な編集モデルへと結びつけるスマートルーターです。Wan 2.7 Edit-Video（一般的なスタイル変換・背景差し替え・パッケージ差し替え、アイデンティティとモーションの保持）、Kling 2.6 Pro Motion Control（参照動画からターゲットキャラクターへの精密なモーション転送）、Lucy Edit Restyle（アイデンティティを保った軽量なスタイル変換・衣装変更）の中から選択します。各モデルで文書化されたプロンプトパターンを内包しており、不適当なモデルで無駄なイテレーションを消費することなく、高精度な動画編集を実現します。ローカルの RunComfy CLI を通じて `runcomfy run <vendor>/<model>/<endpoint>` を呼び出します。「video edit」、「edit video」、「restyle video」、「swap video background」、「motion control」、「outfit swap video」、または動画変換に関する明確な指示によりトリガーされます。

L4 高権限 · 段階的認可と監査V1 コミット固定コマンド実行ネットワーク通信ファイル書き込みDual-pass Audit
Author prime-skillsGitHub prime-skills/runcomfy-agent-skills ↗Stars 43License MIT（仓库根 LICENSE：Copyright (c) 2026 RunComfy / agentspace-so；GitHub API spdx=MIT）Commit fca19ae084
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

プロンプトのみによるルーティング編成（完全ノーコード）：中核となるのは「ユーザーの意図 × 動画編集モデル」の分類表です。エージェントがテーブルを読み取ってユーザーの要求を3つのモデルのいずれかに分類し、すべての意思決定はホスト LLM が行います。スキルファイル自体には決定表、スキーマ、テンプレートのみが含まれます。

video-edit/SKILL.md
| Restyle a talking-head video — preserve face / pose / lip movement | **Wan 2.7 Edit-Video** | Strong identity + motion preservation; supports up to 1080p |
ルーティングテーブル直後の `The agent reads this table, classifies the user's intent, and picks the matching subsection below.` という記述が実行方式を明示しています。プログラムによる if/else ではなく「エージェントが表に基づき分類」する仕組みであり、スクリプトは一切含まずホストエージェント上で動作します。

3つのルートそれぞれに「フィールドレベルのスキーマ ＋ コピペ可能な CLI 呼び出しテンプレート」を内包。RunComfy CLI のパラメータ仕様をドキュメント内に完結させており、エージェントは外部 API ドキュメントを参照することなく JSON を埋めるだけで利用できます。

video-edit/SKILL.md
**Model**: `wan-ai/wan-2-7/edit-video`
各ルートごとにセクションが用意されています：スキーマ表（prompt/video/reference_image/resolution/aspect_ratio/duration/audio_setting/seed、必須項目およびデフォルト値を含む）＋ 2つの完全な呼び出しコードブロック ＋ プロンプティングのヒント。「背景を差し替えつつ人物の同一性と元音声を維持する」といった要件を、単一の JSON 定義で一度に満たすことを意図しています。

実際の実行エンジンは RunComfy 公式 CLI とリモートの Model API：CLI が POST 送信、ポーリング、--output-dir への成果物ダウンロードを担当し、ローカルではリクエスト送信と結果の受け取りのみを行い、メディア演算処理はすべてクラウド上で実行されます。

video-edit/SKILL.md
The skill picks one of Wan 2.7 Edit-Video / Kling 2.6 Pro Motion Control / Lucy Edit Restyle based on user intent and invokes `runcomfy run <model_id>` with the matching JSON body. The CLI POSTs to the Model API, polls the request, fetches the result, and downloads any `.runcomfy.net`/`.runcomfy.com` URL into `--output-dir`. `Ctrl-C` cancels the remote request before exit.
これが「提示された機能を実現できる理由」です。能力の実体はクラウドモデル（Wan 2.7/Kling 2.6/Lucy）であり、スキルの価値は生成そのものではなく「最適なモデル選定 ＋ プロンプト・パラメータの正確な構築」にあります。CLI の詳細動作（Ctrl-C によるリモートリクエストの中断など）はドキュメント上の記載であり、CLI ソースコードはリポジトリ外にあります。

もう1つの価値は、プロンプトのドリフト防止指針：各モデルで「破綻させずに生成するためのノウハウ」を、保持対象の前方配置や1回につき1方向の変更に絞るなど、簡潔なルールとして凝縮しています。

video-edit/SKILL.md
- **Preservation goals first**: `"Preserve [face / pose / motion / framing / lip movement]; [then state the change]"`.
同セクションには `One edit direction per call. Compound edits drift on motion.`、`reference_image only when justified`、`audio_setting: "origin" for talking-head` といった指示があり、生成モデル特有の「複合指示によるドリフト（意図の逸脱）」を防ぐための実践的な対策となっています。

同一リポジトリ内のブランド別スキルとの階層化：汎用的な意図は本ルーターが処理し、ユーザーが特定モデルを指定した場合は専用のブランド別スキル（wan-2-7 など）に委譲することで、競合を回避します。

video-edit/SKILL.md
- **Brand-specific overrides** — if the user named a specific model, route to the corresponding brand skill (`wan-2-7`) for fuller treatment.
リポジトリ内で明確に階層化されています：wan-2-7/ や kling-3-0/ などのブランドディレクトリと、video-edit、image-edit、image-to-video などのルーターディレクトリが共存しており、ルーターは「ブランド別ディレクトリで個別化されていない汎用編集意図」のみをカバーします。

セキュリティ境界のドキュメント明記：--input は JSON 文字列として CLI に直接渡され（シェル展開されない旨を明記）、通信先エンドポイントのホワイトリスト、トークンの保存場所と権限、単一ファイルダウンロードの 2 GiB 上限が記載されています。

video-edit/SKILL.md
- **Outbound endpoints**: only `model-api.runcomfy.net` (request submission) and `*.runcomfy.net` / `*.runcomfy.com` (download whitelist for generated outputs). No telemetry, no callbacks.
これら（`~/.config/runcomfy/token.json` のパーミッション 0600 や 2 GiB 上限を含む）は CLI の挙動を説明するドキュメント上の証拠であり、CLI のソースコード自体はリポジトリ外にあるため独立した検証はできません（verification.unlocatable 参照）。

2コア機能

01動画編集意図のルーティング：スタイル変換・モーション制御・衣装変更の各リクエストを Wan 2.7 Edit-Video、Kling 2.6 Pro Motion Control、Lucy Edit Restyle のいずれかに自動分類
02モデル別のフィールドレベル入力スキーマ（必須項目/デフォルト値/列挙型/メディア制約：2〜10秒、≤100MB、最大1080p）
03即座に使える CLI 呼び出しテンプレート：各ルートに対応する完全な `runcomfy run` コマンドと JSON 本文サンプル
04ドリフト防止プロンプト設計指針（保持対象の前置、1回あたり1方向の編集、必要な場合のみ参照メディア指定、音声保持設定）
05モデル機能の境界仕様：動画長/解像度/変更方向の上限、複数ルートの混在禁止
06終了コード早見表（0/64/65/69/75/77）およびトラブルシューティング案内

3外部依存関係

KindDependency / Endpoint
cliruncomfy（@runcomfy/cli 官方 CLI）
package@runcomfy/cli（npm 全局安装）及 npx skills add agentspace-so/runcomfy-skills --skill video-edit
networkRunComfy Model API（请求提交）
network生成结果下载白名单
networkRunComfy 文档站（模型页与 CLI 故障排查，仅引用链接）
network用户提供的第三方源媒体 URL（视频/参考图）——由 RunComfy 模型服务器抓取，非本机 CLI 抓取

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
  • 网络端点: 外部ネットワークアクセスの宣言: model-api.runcomfy.net — 動画編集リクエストの送信（ドキュメント上で明記された唯一の送信経路、runcomfy CLI 経由）
  • 本地工作目录: ファイルの読み書きと成果物出力: CLI が生成されたメディアを --output-dir で指定されたローカルディレクトリにダウンロード（パスは呼び出し側が指定）
  • SKILL.md: ホストの CLI インタプリタまたは外部実行環境の呼び出し宣言
監査ノート： 統一判定基準に基づく評価：ランタイムの唯一の動作はサードパーティの npm パッケージ/CLI（`@runcomfy/cli`、npm グローバルインストール）の呼び出しです。この CLI は実行時に RunComfy の認証情報（`~/.config/runcomfy/token.json`（ドキュメント上は mode 0600）または `RUNCOMFY_TOKEN` 環境変数）を読み取るため、「サードパーティ npm/CLI の呼び出しおよびクォータ/シークレット読み取りの可能性 → オレンジ」に該当します。また、実行基盤（CLI、Model API、トークン読み込み）がすべてリポジトリ外にあり、CLI に関するドキュメントの記述（パーミッション 0600、2 GiB 上限、シェル展開なし、Ctrl-C 中断など）を本リポジトリ内で検証できないため、「不確実な場合は上位基準を適用する」原則に基づきオレンジと判定しました。さらに外部ネットワーク送信が存在し、ユーザーの動画・参照画像・プロンプトが `model-api.runcomfy.net` 経由でサードパーティクラウドに送信され（送信先は特定可能ですがデータは外部へ越境）、参照メディア URL のサーバー側取得や画像インジェクションリスクがドキュメントで自認されています。スキル自体は純粋な Markdown であり、スクリプト、難読化、隠蔽されたエンドポイントは存在しないため、レッド判定には至りません。

5二重目の独立検証

  • [ok] 三个 route 模型 ID 真实存在于调用示例与 schema — wan-ai/wan-2-7/edit-video、kling/kling-2-6/motion-control-pro、decart/lucy-edit/restyle 均在 '**Model**' 行与 `runcomfy run` 示例中成对出现，无悬空引用。
  • [ok] 默认路由声明一致性 — 路由表末行 'Default if unspecified | Wan 2.7 Edit-Video | Most versatile, highest resolution' 与正文默认判断一致。
  • [unlocatable] SKILL.md 对 CLI 行为的断言（无 shell 展开、单端点、token.json 0600、2 GiB 上限、Ctrl-C 取消远端请求） — 属作者对 @runcomfy/cli 的转述；CLI 源码不在本仓库，无法在本 pin 内独立证实，标记待补而非采信为事实。
  • [ok] 品牌转交声明指向 wan-2-7 — 仓库根确有 wan-2-7/ 目录；但 Kling/Lucy 无同名品牌目录（kling-3-0 为另一版本模型），brand override 仅覆盖 wan——文档未宣称覆盖 Kling/Lucy，不算矛盾。
  • [discrepancy] 身份/安装链接一致性 — SKILL.md 内 npx 安装命令与 GitHub 链接指向 agentspace-so/runcomfy-skills，镜像仓库 README 指向 agentspace-so/runcomfy-agent-skills，被 pin 仓库实为 prime-skills/runcomfy-agent-skills——三处来源标识不一致（非代码缺陷，属发布身份漂移，详情页应展示被 pin 的 prime-skills 仓库）。
  • [ok] 功能声明 vs 实际能力夸大检查 — description 所称『smart router + 提示词模式库 + runcomfy CLI 调用』全部由文档兑现；'documented prompting patterns' 中的 documented 无仓内来源（指向 RunComfy 站外文档），'sharper edits' 为无评测证据的主观宣称，已在 risks 标注。

6結論

  • モデル選定の意思決定コスト削減：意図分類表により、背景差し替え・モーション制御・衣装変更などの自然言語プロンプトを最適なクラウドモデルにマッピングし、専門知識のないユーザーでも一言で開始可能
  • スキーマと JSON テンプレートの内包：制約（動画長、解像度、アスペクト比、音声）が直接参照可能で、外部 API ドキュメントを調べる手間を省略
  • 生成モデルの複合指示ドリフト課題に対する実践的・具体的なプロンプト指針の提示（保持対象の前方配置、1リクエスト1変更）
  • 透明性の高いセキュリティ：通信先エンドポイント、トークン保存場所・権限、ダウンロード上限が明記されており、納得した上での利用判断が可能
  • ブランド別スキルとの階層的共存：汎用リクエストとモデル指名リクエストが競合せず、より詳細な特化スキルへとスムーズに引き継ぎ可能
    • 最適な用途： RunComfy アカウントを所有し、動画の背景差し替え・衣装変更・モーション転送をクラウドモデルに任せたい Claude/Cursor エージェントユーザー、クリエイティブ素材のバッチ改変を行うマーケティング・製品チーム、および「意図ルーティング ＋ ドリフト防止指針」というプロンプト設計パターンをスキル開発に再利用したい開発者に適しています。
    不向きな用途： RunComfy アカウントを持っていない、または動画素材をサードパーティクラウドにアップロードできないユーザー、ローカル/オフライン環境での動画編集、同一クリップに対する複数モデルの複合編集（ドキュメントで1回1モデルに限定）、エンドツーエンドで監査可能なセキュリティが求められる環境（CLI およびクラウドがリポジトリ外）、スキーマやルールに従わず自由形式プロンプトで試行錯誤したい用途には適していません。
    Install Agent-Ready
    ① Verified Mirror 2026-09-09
    Option A · Direct DownloadDownload video-edit.tar.gz
    sha256: 6e103a2472433792…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit fca19ae084.