ra-video-wash-pipeline

動画洗稿パイプライン

目標

動画のソースリンクまたはローカル動画ファイルから、制作にすぐ使える洗稿済み台本を作成します。忠実な文字起こしを抽出し、確立された ra-洗稿スタックを通じて書き直した後、承認済みの台本を 01-内容生产/视频工作台/待制作/ に投入し、制作時の正式な基準とします。動画制作はこのキューから引き継がれる独立した段階です（通常は制作ホストが ra-video-production-director を通じて担当します）。ユーザーが明示的に依頼した場合に限り、同じセッション内で制作まで続行してください。

このスキルはオーケストレーターです。ra-逐字稿提取skill、ra-洗稿、ra-人话、dbs-*、ra-video-production-director の詳細なルールを重複させず、各ステップで作業を担当するスキルを読み込み、その指示に従ってください。

ソースのプライバシー境界

このスキルで動画の洗稿を行う場合、ソースの文字起こしは内部作業用の成果物であり、納品物ではありません。

厳守事項：

• 会話内にソース動画の文字起こしを表示、引用、要約、返却しないでください。
• ユーザーが文字起こしの抽出を明示的に依頼しない限り、最終回答や引き継ぎファイルにソース動画のタイトル、ソース URL、ソースの文字起こしのパス、ソースのフレーズを含めないでください。
• 文字起こしツールが通常、全文を表示する場合は、内部／非公開モードに切り替えるか、出力を表示せずに取得してください。
• 書き直しに必要な場合に限り、ソースの文字起こしを一時的な内部保存場所に保存してください。ユーザーが保持を明示的に依頼しない限り、書き直した台本とチェックの作成後にソースの文字起こしを削除してください。
• 新しい台本、書き直したフック、品質チェック、制作概要、ソースを含まない事実関係の修正のみを納品してください。

ルート

入力が動画 URL またはローカル動画ファイルで、ユーザーが書き直しまたは新規制作を希望している場合は、このスキルを使用してください。

次のような範囲の狭いタスクには、このスキルを使用しないでください。

• 文字起こしのみ → ra-逐字稿提取skill を使用
• 提供された文字起こしまたはラフテキストのみ → ra-洗稿 を使用
• 完成済みの台本または絵コンテのみ → ra-video-production-director を使用
• 動画制作を伴わない事実調査 → 該当する調査または執筆ワークフローを使用

依頼に 视频洗稿、二创成新视频、洗稿并制作视频 などが含まれる場合は、抽出 → 書き直し → 引き継ぎキューへの投入を行うものとします。同じセッション内で制作まで続けるのは、ユーザーが 直接制作、直接出片、一条龙 と明示した場合に限ります。ユーザーが 只要逐字稿、只要脚本、先不要生成视频、只分析 と明示した場合は、範囲を絞ってください。

ワークフロー

1. 受付

必要最小限の判断事項を確認します。

• ソースリンクまたはローカルファイル
• 対象プラットフォームとアスペクト比。指定がない場合は、Douyin 向けの横向き 16:9 ランドスケープ動画を既定とします
• 想定する範囲：台本のみ、10秒サンプル、または動画全編
• ビジュアルの方向性。指定がない場合は、ra-video-production-director の白を基調とした Xiaohei システムを既定とします
• ユーザーが 小黑配图、Ian 小黑、または特定のイラストスキルに言及した場合は、それを緩やかなスタイルの好みではなく、必須の制作条件として維持します
• ナレーション。AI ナレーションが必要で、ソース音声を再利用しない場合は、ユーザーのクローン音声を既定とします

回答によって実行経路が変わる場合に限り、質問してください。それ以外の場合は、慎重な既定値を選んで進めてください。

重複チェックの厳守事項：ソースリンクを受け取ったら、文字起こしを抽出する前に、まず python3 automation/scripts/wash_ledger.py check "<url>" を実行してください。終了コード 3 = すでに洗稿済み：停止し、台帳の記録（時刻、企画カード、制作物の行き先）をユーザーに伝えてください。ユーザーが再洗稿を明示的に確認した場合に限り続行します。終了コード 4 = 制作しない旨のマークがある、またはタイトルが類似している可能性があります：ひと言注意してから続行してください。重複チェックの結果は会話内でのみ伝え、制作物には記載しないでください。

2. 文字起こしの抽出

まず ra-逐字稿提取skill を呼び出しますが、内部依存として使用してください。

Douyin／Xiaohongshu の URL では、次を優先してください。

python3 "$ZT_HOME/scripts/transcript.py" "<url>" --internal --output-dir "<temporary_internal_dir>"

必須の結果：

• プローブ後のプラットフォーム、再生時間、セグメント数、推定待ち時間
• エージェントが書き直しに利用できる完全な文字起こしテキスト
• ソースの文字起こし、ソースタイトル、ソース URL、ソースのフレーズ、ソースの文字起こしのパスがユーザーに露出していないこと

プラットフォームによるアクセス制限またはリンクが非公開であることが原因で抽出に失敗した場合は、停止し、ローカルファイル、公開リンク、またはエクスポートした字幕を依頼してください。推測した文字起こしを使って続行しないでください。

3. リライトスクリプト

完全な文字起こしとユーザーのゴールを ra-洗稿 に渡します。

ra-洗稿 にデフォルトスタックの実行を要求します：

1. ra-人话 リライト
2. dbs-ai-check 診断パス
3. dbs-hook 最初の5秒パス
4. dbs-resonate 共感パス
5. ra-video-title 候補パス：8〜12件の候補と Top 3 の推薦をハンドオフの 标题候选 セクションに（最終タイトルは決めない — ユーザーが公開時に手動で選択します）
6. dbs-xhs-title は小紅書 图文/笔记 のタイトルが対象の場合のみ

リライトの期待される出力：

• 新しい話し言葉スクリプトまたは逐字稿
• 最終的なフックと2行目
• 公開タイトル候補と Top 3 の推薦（ra-video-title）
• AI っぽさ、冒頭、共感、および該当する場合は小紅書タイトルに関するフローチェック
• ハンドオフ契約の内容：frontmatter フィールドに加え、セグメントごとの Xiaohei イラスト意図、オンページ情報コンポーネント、キャプション/モーションノート、アーカイブスラッグ

ユーザーが 只要脚本 を求めた場合は、ここで停止し、リライト済みスクリプトとフローチェックのみを返します。ソースの文字起こしパスは返さないでください。

4. ハンドオフをキューに投入（デフォルトのエンドポイント）

ra-洗稿 にデフォルトのエンドポイントで終了することを要求します：01-内容生产/视频工作台/_交接模板.md に従った 01-内容生产/视频工作台/待制作/YYYY-MM-DD-<主题slug>/交接稿.md 内のハンドオフファイル（先にプロジェクトフォルダを作成し、その中にハンドオフを置きます）。

停止する前に、次を検証します：

• ハンドオフファイルが存在し、その frontmatter 契約が完全である （status: 待制作、プラットフォーム、比率はデフォルトで 16:9、duration_target_s、 word_count、voice: pluvio-indextts2-calm-v1、 voice_provider: indextts2-local、 captions: asr-word-timestamps、caption_style: anchor-dark、visual、 illustration_skill）
• 标题候选 セクションに 8〜12件の候補と ra-video-title からの Top 3 の推薦が 入っている。最終タイトルは選ばない — ユーザーが後で手動で選択します
• スクリプト本文がセグメントに分割され、セグメントごとの Xiaohei 意図と オンページ情報コンポーネントが付いている
• ソース URL、ソースタイトル、ソース文字起こし、またはソース文字起こしパスが ファイル内のどこにも現れない
• 洗稿台帳のエントリーが追加されている（台账登记完成才算收尾）

台账登记（ハードゲート）：交接稿と选题卡が確定したら、洗稿台帳を登録します——優先的には python3 automation/scripts/wash_ledger.py add --status washed --from-source-json "<.internal/<日期>-<平台>-download/…source.json>" --card "<选题卡相对路径>" --handoff "<交接稿相对路径>"（このパイプラインがソース動画をダウンロードする場合は必ずこのファイルがあります）；ダウンロードを行わずリンクのみの場合は --url "<源URL>" --title "<源标题>" を使用します；クラウドの选题推薦からの場合は --work-id <云端作品id> を追加します。ユーザーがソースを見て洗稿しないと決めた場合も、add --status skipped --url "<源URL>" --note "<原因>" を実行し、後で重複して推薦されるのを防ぎます。

その後停止し、ハンドオフファイルのパスとスクリプトおよびフローチェックを返します。 制作は別ステージとしてキューから拾い上げられます。

5. 動画を制作（明示的な要求があった場合のみ）

ユーザーが明示的に 直接制作、直接出片、または 一条龙 と言った場合のみ： ハンドオフファイルを拘束力のある制作契約として ra-video-production-director を起動し、加えて：

• ソースフリーの動画メタデータとプライベートな文字起こしコンテキスト
• ra-洗稿 のフローチェック結果
• ユーザーが別のスタイルを指定しない限り、白基調の Xiaohei ビジュアルシステムによるデフォルトの抖音横向き 16:9 ランドスケープキャンバス
• 必須のイラストスキル：ユーザーが 小黑配图 を求めた場合、または白基調の Xiaohei デフォルトが選択された場合は常に ian-xiaohei-illustrations

初回実行、スタイル変更、またはモーションの方向性が不確かな場合は、まず10秒のサンプルをレンダリングします。ユーザーが明示的にサンプルゲートのスキップを求めない限り、承認後にのみ完全な動画へ進みます。

6. QC とアーカイブ（明示的な制作依頼がある場合のみ）

ra-video-production-director に通常の QC とアーカイブのルールを実行させてください。

最低限の最終確認項目：

• 最終 MP4 が 01-内容生产/视频工作台/已制作/<月上旬|月下旬>/<日期-主题>/成片/ に存在する
• automation/scripts/check_delivery.py が引き継ぎファイル、プロジェクトディレクトリ、最終 MP4 に対して合格する
• 引き継ぎファイルの 制作端回执 が記入され、status: 已完成 となっており、01-内容生产/视频工作台/已制作/<月上旬|月下旬>/<日期-主题>/ に引き継ぎファイル、成片/ 内の最終 MP4 のコピー、主要な QC フレームが 质检/ に揃っている
• 書き直した台本のパスが記録されている。元の文字起こしファイルのパスは非公開のままにするか、削除する
• 字幕がセーフゾーン内に配置され、不要な UI フレームが含まれていない
• 制作用字幕は、正確な最終音声から ra-audio-to-subtitles を通じて生成されている。caption-qc.json に合格し、skill-captions が 引き継ぎファイルの caption_style（デフォルトは anchor-dark）を適用して、 合格した caption-render-qc.json を生成している。文字数によるタイミング調整は使用していない
• ページのベースは安定したままにし、動きはコンポーネント上で発生する
• Xiaohei のイラストは ian-xiaohei-illustrations を通じて生成され、プロジェクトのアセットとして保存され、レンダリング時に直接読み込まれ、装飾ではなく現在のポイントを説明している
• 代表的なフレームで段階的な表示が確認でき、テキストの重なりがない

出力

デフォルトの引き継ぎ完了の場合は、次を返してください。

交接文件：
[01-内容生产/视频工作台/待制作/YYYY-MM-DD-<slug>/交接稿.md]

标题候选：
[Top 3 推荐；完整候选见交接文件]

新逐字稿/脚本：
[script]

流程检查：
- AI 味：
- 开头：
- 共鸣：
- 小红书标题（如适用）：

台本のみの完了（只要脚本）の場合は、交接文件 の行を除いた同じブロックを返し、キューファイルは作成しないでください。

セッション内での明示的な制作完了の場合は、次を返してください。

成片：
[final MP4 path]

质检：
[key QC path]

过程资产：
- 新脚本：

规格：
[ratio, resolution, duration, codecs]

限制：
[only if something remains]