PR動画
プルリクエスト1件を読まない人(多くの場合マネージャー)向けに説明する40~100秒の解説動画:変更内容、理由、仕組み、リスク、ステータス、そしてレビュー担当者がどこから始めるべきか。技術的だが平易な言葉で。すべてCLIから実行します:node cli/prs.mjs <コマンド>(リポジトリルートから)、またはnode <pr-studioへのパス>/cli/prs.mjs <コマンド>(任意の場所から)(以下:prs)。
開始
- 誰も見ていない場合(GitHub Actionsジョブ)?最初にguides/unattended.mdを読んでください:質問はなく、時間制限、1回のレビューラウンド、結果の保存先について説明しています。
- Slackから開始した場合(@GitHub、クラウドセッション)?最初にguides/slack.mdを読んでください:トリアージ、59分の予算、各動画をスレッドに投稿すること、そしてそこでやってはいけないことについて説明しています。
- マシンごとに1回:
prs doctor(ブラウザ、音声モデル、Whisper、ffmpeg;不足しているものだけを追加します)。 - 次にguides/story.mdとguides/visuals.mdを読んでください。catalog.mdに目を通し、利用可能な図を確認してください。
ワークフロー(15~20分を目標)
- 取得。
prs new <PR URL>でvideos/<slug>/が作成されます:brief.md(すべて読む)、pr.diff(必要な行を検索;全体は読まない)、pr.json、および適切な数のビートを持つストーリーボードのスケルトン。 - ストーリー。
videos/<slug>/storyboard.jsonを書く:ビートごとに1つのアイデア、ビートごとにneed、キュー、および証拠に基づく主張(guides/story.md)。prs checkを ready for prs voice と表示されるまで実行する。 - 音声(バックグラウンドで)。
prs voice(約1分;Azureキーが設定されている場合はMAI-Voice-2、それ以外はローカルのKokoro音声)を開始し、実行中に作業を続ける。 - ディレクション。
prs directで各ビートの処理方法と動画のモーションを選択し、direction.jsonを作成し、それらの処理方法でscenes.jsをスキャフォールディングする。PR からの TODO をすべて埋める。選択内容はそのままにする:それらは最近の動画と異なるように選択されている。ある処理方法がどうしてもそのビートを表示できない場合は、`prs direct --use = --reason