Communitygithub.com

画面(分镜)

给剪好的口播配画面:在录屏上覆盖HTML层(圈重点标注、小黑整屏动画、推近),层绑定字幕屏,由播放器逐帧驱动,直接在预览里查看。

画面(分镜) とは?

このスキルは、口述動画やチュートリアル動画の編集において、録画画面にHTMLレイヤーをオーバーレイすることで、視覚的なストーリーボードやBロール効果を追加するものです。ユーザーが「分鏡、配画面、加动画、圈重点、B-roll、做storyboard」と指示した際に起動し、すでに存在する字幕データ(subtitles.json)と編集台帳(edit-list.json)に基づいて、字幕の各フレーズに合わせたレイヤーを自動生成します。処理は4つのステップ(文章によるタスク分類、実際のフレーム抽出による画面確認、動きの検出、レイヤーの作成と配置)で構成され、各ステップはスキップできません。レイヤーは字幕のキューにバインドされ、時間情報ではなく字幕の単語IDに依存するため、編集が変更されても自動的に追随します。このスキルはClaude CodeやClineなどのコマンドラインベースのAIエージェント向けに設計されており、デスクトップアプリの既存サービスを再利用します。出力はvisuals.jsonと各モジュールのHTMLファイルで、プレビュー上で即座に確認できます。重要な制約として、フレーム抽出と動き検出のスキップ禁止、すべての座標は目測ではなくピクセル統計で決定、ブランドアイコンは公式フォントまたはsimple-iconsから取得するなど、品質と正確性を厳格に守るルールがあります。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/chengfeng-videocut-skills/plugins/chengfeng-videocut/skills/chengfeng-visual

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

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

ドキュメント

画面(分鏡)

これは一つのタスクであり、ワークフローの一部ではありません。 ユーザーが呼び出したときに実行し、後で編集を変更したら再度行うことができます。

前提条件は二つだけ:台帳と字幕がすでに存在していること(レイヤーは字幕画面に配置され、時間は台帳から計算されます)。

必要ファイル  edit-list.json、transcript.json、subtitles.json
出力ファイル  visuals.json + modules/<番号-名前>/index.html

完了したら停止し、ユーザーに次のステップを指示しません。

まず業務スキルのフェーズ契約を読み込み実行します。 モジュール記述の厳格なルールはモジュール契約を参照、 判断ルールは画面判断を参照。

0. 準備

まず更新チェックの「準備チェック」を実行——skillsが最新かどうか、ランタイムが互換かどうか;プラグインルートもそこで特定されます(この文書のコマンド内の <プラグインルート> はすべてそのリテラルパスに置き換えます)。「準備完了」の場合のみ続行;「新セッションが必要」または「停止」の場合はその指示に従って実行(「自作の代替UI禁止」の禁令を含む)。業務スキルは環境ロジックを持ちません。

準備結果が runtime.kind=desktop-managed の場合、デスクトップアプリにすでにインストールされている安定版CLIと同一の launchd/windows-task サービスを直接再利用します。Electronパスの解決、依存関係の追加インストール、または別のRuntimeの起動は行わないでください。

コマンド

node "<プラグインルート>/scripts/ensure-running.cjs" --json
node "<プラグインルート>/scripts/videocut-cli.cjs" visual get   <project> --json
node "<プラグインルート>/scripts/videocut-cli.cjs" visual frame <project> --cues sub-0004,sub-0005 --count 12 --out <dir> --json
node "<プラグインルート>/scripts/videocut-cli.cjs" visual add   <project> --module modules/01-xx/index.html --cues sub-0004,sub-0005 [--zoom x,y,w,h] [--id vis-0001] --json
node "<プラグインルート>/scripts/videocut-cli.cjs" visual remove <project> --id vis-0001 --json

ensure-running はまず canonical 5190 が現在のプラットフォームのマネージドサービスに属していることを証明する必要があります。失敗した場合はそのままエラーを透過させて停止し、フォアグラウンドや独自のポートにフォールバックしません。

レイヤーは字幕画面(--cues)にバインドされます。製品自身が単語IDに換算します——レイヤーが誰も話していない単語にバインドされることは決してなく、編集が変更されるとレイヤーは自動的に追従します。秒数は保存しません。

4つのステップ、1つもスキップ不可

① テキストでタスクを決定     subtitles.jsonを読み込み、意味的にセグメント化。各セグメントで以下を判断:
                         チュートリアル/デモ/証明、それとも概念/論理/遷移?
② フレームを抽出して画面を確認    visual frame で8〜12フレームを抽出し、実際に目で見る。
                         実測では12セグメント中2セグメントで画面がテキストの予測を覆した——このステップは形だけではない
③ 動きのウィンドウを計測     隣接フレームでピクセル差分を計算し、スクロール/切り替え/操作の瞬間を見つける。
                         レイヤーは安定ウィンドウにのみ配置、円は画面が動き始める前に退場
④ レイヤーを作成して配置   モジュールを記述 → visual add → プレビューでレイヤーごとに確認

② の判断ルール

画面がまさに彼の言っている内容である場合     → 注釈:円で囲む、どの単語を言っているときにどこを囲むか。本当の証の証拠は隠してはいけない
画面が関係が薄い/空白である場合     → 黒背景アニメーション:全画面白背景、スタイルレジストリから作成
画面がそれ自体で十分に明確である場合 → 何もしない。これが最も一般的な正解(実測では13セグメント中4セグメントは何もしなかった)

③ の出力は数字であり、感覚ではない

円の座標     ピクセル統計から算出(グレースケールスキャンでテキスト行を検出)、目測禁止——目測では50pxの誤差が発生した
相互作用の瞬間    フレームごとのピクセル差分で急激な変化を検出(実測では一度4から335にジャンプ)、その0.2秒前に円が退場完了
安定ウィンドウ    開始時にはよくスクロールがある(彼がコンテンツを探している)、レイヤーは動きが止まった画面のキューからバインドを開始

ズーム(zoom)は使う前に考える

デフォルトではズームしない。   960x720の録画を拡大するとぼやけ、ユーザーはすぐに気づく
どうしても拡張が必要な場合     ≤1.6倍、領域は62.5%の正方形を中央に——構図の完全性 > 小さな文字の読みやすさ
文字が小さすぎて読めない場合   円で視線を誘導すれば十分;本当に読みたいなら、答えは高解像度での再録画であり、拡大ではない

レビューサイクル

モジュールディレクトリは番号で命名(01-daily-report、05-anim-task-split)、タイムラインのトラックにはディレクトリ名が表示され、ユーザーが番号を報告したらそのレイヤーだけを変更し、他は触らない。

レイヤー変更に関する2つの規律。それぞれ実際の事故に対応しています:

レイヤー変更時は必ずモジュールを確認     レイヤーを狭く/長くした後、モジュール内にハードコードされた相対時刻は自動的に追従しない——
                         円の登場時刻がレイヤー終了後になる可能性があり、永遠に表示されない
確認はピクセルで     スクリーンショットで画面を確認し、DOM属性は確認しない。「可視性のトグルが正しい」iframeが
                         物理的に画面内に存在しなかった——属性はすべて正しく、画面は完全に空だった

禁止事項

  • フレーム抽出と動き検出をスキップして直接レイヤーを作成してはいけない(両方の間違いをそれぞれ一度犯した:本当の証拠を隠した、スクロール上に円を浮かせた)
  • すべてのセグメントに何かを追加してはいけない——埋め尽くすことが目標ではなく、何もしないことは一般的な正解である
  • 秒数を保存してはいけない、座標を目測してはいけない、白背景のページに暗いオーバーレイを追加してはいけない
  • 実際のコンテンツがない場合にプレースホルダー画像でごまかしてはいけない
  • スタイルはレジストリから選択し、独自に発明してはいけない
  • ブランドアイコンは公式フォントを使用し、手描きの代用をしてはいけない(Xを2本の交差線で描いたことがあるが、ユーザーに見つかった)。 ローカルインデックスにない場合は、simple-iconsから単色の公式グリフを取得(白黒スタイルにちょうど合う)、 元のsvgをモジュールディレクトリに保存して参照用にする;同じクリップ内の同じブランドは一貫した外観でなければならない

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

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper),提供开箱即用的 Python 接口,支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。全面适配 MacOS (Apple Silicon/Intel) 与 Windows,支持 v5.9+ (draft_info.json) 架构、工程自修复、智能配音字幕及录屏变焦。

関連スキル