Communitygithub.com

federicobrancasi/pr-studio

プルリクエストを解説する動画(PR説明動画、レビュー動画、「<PR URL>の動画を作成して」など)を作成したい場合に使用します。このリポジトリ内の全ワークフロー(PRの取得、ナレーションの作成、音声生成、図の選択と作成、チェック、レンダリング、pr-directorによる承認、納品)をカバーします。

pr-studio とは?

federicobrancasi/pr-studioは、プルリクエストの内容をあまり読まない人(多くの場合マネージャー)向けに、40〜100秒の解説動画を生成するAIエージェントスキルです。変更内容、理由、仕組み、リスク、ステータス、レビュー担当者がどこから始めるべきかなど、技術的でありながら平易な言葉で説明します。このスキルはCLIツールとして提供され、`node cli/prs.mjs <command>` で実行できます。ワークフローは、PRの取得とストーリーボード作成(`prs new`)、ストーリーの執筆(`prs check`)、音声生成(`prs voice`)、映像の方向性決定(`prs direct`)、スチル生成(`prs stills`)、レンダリング(`prs render`)、公開(`prs publish`)、そしてpr-directorエージェントによる承認と納品で構成されています。GitHub ActionsやSlackとの統合もサポートし、正確性を重視し、PR内の情報のみに基づいた内容を制作します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/federicobrancasi/pr-studio/tree/HEAD/.claude/skills/pr-video

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

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

ドキュメント

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分を目標)

  1. 取得。 prs new <PR URL> で videos/<slug>/ が作成されます:brief.md(すべて読む)、pr.diff(必要な行を検索;全体は読まない)、pr.json、および適切な数のビートを持つストーリーボードのスケルトン。
  2. ストーリー。 videos/<slug>/storyboard.json を書く:ビートごとに1つのアイデア、ビートごとに need、キュー、および証拠に基づく主張(guides/story.md)。prs check を ready for prs voice と表示されるまで実行する。
  3. 音声(バックグラウンドで)。 prs voice(約1分;Azureキーが設定されている場合はMAI-Voice-2、それ以外はローカルのKokoro音声)を開始し、実行中に作業を続ける。
  4. ディレクション。 prs direct で各ビートの処理方法と動画のモーションを選択し、direction.json を作成し、それらの処理方法で scenes.js をスキャフォールディングする。PR からの TODO をすべて埋める。選択内容はそのままにする:それらは最近の動画と異なるように選択されている。ある処理方法がどうしてもそのビートを表示できない場合は、`prs direct --use = --reason

関連スキル