Communitygithub.com

yinbaozong/rough-cut-wiki-video

エージェントスキル:編集可能なステップバイステップチュートリアルビデオのラフカットを、Jianying 10/11 および Final Cut Pro 向けに作成します。

rough-cut-wiki-video とは?

このスキルは、手順テキストと映像フォルダを入力として、チュートリアルビデオの非破壊的なラフカットパッケージを自動生成します。対応プラットフォームは Jianying 10/11 と Final Cut Pro です。CLI ツールが映像から音声を抽出し、faster-whisper モデルで文字起こしを行い、手順ステップと照合してタイムラインを構築します。出力には、レビュー用の `review.md`、編集計画の `edit-plan.json`、字幕(SRT)、FCPXML、および Jianying プロジェクトが含まれます。音声が不明瞭な場合や手順と無関係な場合は、ファイル名をフォールバックとして使用し、それでも判断できない場合はユーザーに確認を求めます。Jianying プロジェクトの作成時には、暗号化とバックアップを自動で行い、ユーザーの既存プロジェクトを上書きする前に明示的な許可を要求します。

対応✓Claude Code✓Codex CLI✓Cursor
npx skills add yinbaozong/rough-cut-wiki-video

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

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

ドキュメント

Wiki ビデオ ラフカット

順序付けられた手順とフッテージフォルダを、非破壊的なチュートリアルラフカットパッケージに変換します。手順テキストは会話に直接貼り付けるか、ローカルの UTF-8 テキスト/Markdown ファイルで受け付けます。音声証拠を優先し、ファイル名をフォールバックとして使用し、すべてのテイクを保持します。キャプションの事実ソースとして、即興のナレーションではなく、提供された手順を使用します。

ワークフロー

  1. フッテージディレクトリと順序付けられた手順を尋ねます。テキストを会話に直接貼り付けるか、ローカルの UTF-8 テキスト/Markdown ファイルを受け付けます。貼り付けテキストが利用可能な場合、.md ファイルを必須としません。ユーザーが明示的に要求しない限り、URL を取得しません。貼り付けられたテキストをそのままジョブの wiki-source.md として保存してから CLI を呼び出します。

  2. 順序付けられ、撮影されたアクションのみをタイムラインステップとして扱います。ツールリスト、準備セクション、背景、または撮影されていない理論をユーザーに追加するよう要求しません。Step 1/2/3、步骤一/二/三、または番号付きリストを優先します。重要な注意事項は、該当するアクション内に保持します。

  3. 読み込まれた SKILL.md からこのスキルディレクトリを見つけます。.codex、.claude、または .cursor パスを決して想定しません。

  4. 機能チェックを実行します。

    python scripts/roughcut.py doctor
    
  5. 分析を実行します。ユーザーがファイル名のみの処理を要求しない限り、auto を使用します。auto モードでは、まずオーディオトラックを抽出し、単語タイムスタンプ付きで文字起こしを行い、ファイル名を考慮する前に、話されたラベルが手順ステップに関連しているかテストします。

    python scripts/roughcut.py run --media "E:\footage" --wiki "E:\job\wiki.md" --output "E:\job\output" --mode auto --preview
    
  6. review.md、edit-plan.json、代表的な証拠、および警告を検査します。フッテージ/手順の証拠が変更をサポートしている場合にのみ、wiki-steps.json または edit-plan.json を改善します。数量、オブジェクト、原材料、部品、方向、または安全性に関する主張を決してでっち上げません。

  7. 手動で計画を変更した後、エクスポーターを再実行します(現在は完全なリビルドに run を使用します)。曖昧または競合するフッテージを保持し、待確認 とマークします。入力メディアを黙って削除しません。

  8. Windows では、jianying10 コマンドを使用して edit-plan.json からネイティブの Jianying 10/11 プロジェクトを作成します。まず --user-data を省略し、ステージングディレクトリで検証します。実際のプロジェクトを登録するために --user-data を追加する前に、Jianying が完全に閉じていることを要求します。エクスポーターは、両方のドラフト JSON ファイルを最新の有効なローカル videoeditor.dll で暗号化し、root_meta_info.json をバックアップし、一致するホームページエントリを登録する必要があります。ユーザーが明示的に許可しない限り、既存のドラフトを決して置き換えません。

証拠ルール

次の優先順位を使用します:ユーザーの修正;手順に関連する、スタート後の話されたラベル;意味のあるファイル名とパート番号;レビューのみのための手順順序/OCR/視覚的文脈。DJI_0001 のようなカメラファイル名はラベルではありません。音声が空であるか、どの手順ステップにも関連しない場合は、ファイル名を試みます。どちらも手順に関連する証拠を提供しない場合は、推測する代わりに停止し、ユーザーに話されたステップラベルを録音するか、ファイル名を変更するよう依頼します。繰り返しのテイクを保持し、録画時間の前に明示的なパーツを順序付けます。その他の一致しない素材はタイムラインの最後に配置し、撮影されていない手順ステップはレポートにのみリストします。

スタートキューは 321开始、三二一开始、321走、または単独の 开始/走 です。エンドキューは単独の OK、过、可以、好了、または 结束 です。可以安装 や 开始拆卸 のようなフレーズ内の単語はトリミングしません。ファイルの終端は有効なテイク終了と見なします。

キャプションと出力

提供された手順から正式なキャプションを作成し、自然な読みやすさのために構文を軽く磨きます。ステップに記載されている名前、数、方向、および警告を保持します。2 つの独立して削除可能なトラックを使用します:文档字幕 と正確なテキスト 待確認。元のオーディオと元の 4K ファイルはそのまま保持します。

出力契約と JSON フィールド定義は schemas.md にあります。プラットフォーム/セットアップの詳細は usage.md を、Jianying プロジェクトを登録する前に jianying10.md を参照してください。キャプチャ規約については、shooting-guide.md、filename-guide.md、および wiki-format.md を参照してください。

障害処理

マルチリンガル faster-whisper small モデルのみを使用します。tiny に置き換えないでください。small がないか不完全な場合は、音声分析を停止し、単一コマンドの scripts/download-model.ps1 または scripts/download-model.sh による修復を表示します。その他の認識または OCR 障害の場合は、すべてのメディアを保持し、残りの証拠を使用し、フォールバックを review.md に記録します。FFmpeg がない場合でも、計画、SRT、FCPXML、およびドラフト候補を出力します。プレビューは省略します。Jianying の暗号化または登録が失敗した場合は、ステージングドラフト、診断情報、SRT、FCPXML、および edit-plan.json を保持します。ユーザーの Jianying を自動的に置き換えたり、ダウングレードしたり、アンインストールしたりしません。

関連スキル