画面(分鏡)
これは一つのタスクであり、ワークフローの一部ではありません。 ユーザーが呼び出したときに実行し、後で編集を変更したら再度行うことができます。
前提条件は二つだけ:台帳と字幕がすでに存在していること(レイヤーは字幕画面に配置され、時間は台帳から計算されます)。
必要ファイル 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をモジュールディレクトリに保存して参照用にする;同じクリップ内の同じブランドは一貫した外観でなければならない