研修ビデオ
音声が主導し、映像はそれに従います。最初にスクリプトと音声、次にスライドまたは録画を、各セリフの長さに合わせて同期します。
誰と話しているか。 相手は技術に詳しくない可能性があります。相手は日本語(またはあなたに指示を出している言語)で、簡単な言葉を使い、コマンドやファイルパスは避けます(尋ねられた場合を除く)。技術的な手順はあなたが実行します。相手の決定が必要なことだけを尋ねてください。内容、対象者、言語、ビジュアル、承認などです。
スクリプトは ${CLAUDE_SKILL_DIR}/scripts/ にあり、python3 -B ${CLAUDE_SKILL_DIR}/scripts/<スクリプト名>.py … で実行します。Windows では python3 の代わりに doctor.py が「Python コマンド」行で示すコマンド(python または py -3)を使用します。スライドとレンダリングは node ${CLAUDE_SKILL_DIR}/deck/render.cjs …、アプリケーションの録画は ${CLAUDE_SKILL_DIR}/screencast/ を使用します。テーマは ${CLAUDE_PLUGIN_ROOT}/themes/ にあります。macOS と Windows(Bash および PowerShell)で動作します。コマンドはパイプ、&&、リダイレクトなしのシンプルなものを使用します。
プロジェクトとは、作業中のフォルダ(製品のリポジトリまたはドキュメントフォルダ)です。各プロジェクトには独自の Gemini キーがあり、ユーザーのコンピュータにのみ保存されます(キーチェーン / 資格情報マネージャー)。プロジェクトのマーカーは .training-video/project.json(ID と名前、秘密情報は含みません)です。
4つの承認 — これなしでは時間とお金を無駄にしない
- スクリプト(セリフのテキストとスライド/画面の計画)。
- コスト —
cost.pyによる表。短いサンプル(最大3~4セリフ)は承認不要、フルナレーションは必要。 - 音声サンプル — 最初の3セリフ(
narrate.py --sample 3)。ユーザーが聴きます。 - ビジュアル — レンダリング全体の前に、完成したスライドまたは録画の1~2フレーム。
実行
- 環境とキー — 毎回の実行時に、他のすべての前に。
doctor.py <プロジェクト>。不足しているものがあれば、ユーザーの許可を得て、doctor.pyがそのシステム用に指定するコマンド(brew / winget)で修正します。レンダリングの場合は${CLAUDE_PLUGIN_ROOT}でnpm ci(Claude Code が実行していない場合)、そしてnpx playwright install chromiumを実行します。- プロジェクトキー:
key.py check <プロジェクト>。OK→ 続行します。プロジェクトなし→ フォルダに小さなファイル.training-video/project.json(プロジェクトの名前と番号、秘密情報なし、git に保存可)が作成されることをユーザーに伝え、プロジェクト名を尋ねます(フォルダ名を提案します)。その後ウィザードを実行します。キーなし→ 古い共通キーがあると表示された場合、「これまでの Gemini キーをこのプロジェクトにも使用しますか?」と尋ねます(はい →key.py setup <プロジェクト> --use-legacy)。それ以外の場合はウィザードを実行します。拒否されました→--replace付きでウィザードを実行します。
- ウィザード: まず次の手順を簡単な言葉で説明します。「Google AI Studio のページが開きます。このプロジェクトの音声料金を支払うアカウントで API キーを作成し、コピーしてください。その後、キーを貼り付けるためのウィンドウが表示されます。キーはこのコンピュータにのみ保存されます。」
key.py setup <プロジェクト> [--name "<名前>"]を実行します。ウィザードはページとウィンドウを開き、Gemini でキーを確認して保存します。チャットでキーを要求したり、どこにも書き込んだりしないでください。 ユーザーがキーをチャットに貼り付けた場合は、Google AI Studio で削除して新しいキーを作成するように指示してください。 - 技術に詳しいユーザーは Vertex を使用できます(
gcloud auth application-default loginとGOOGLE_CLOUD_PROJECT)。環境変数のGEMINI_API_KEYはすべてのプロジェクトに適用されます — CI 専用です。
- 受け入れ — 自分で状況を把握し、明確でないことだけを尋ねてください。
- 何があるか: チャットまたはディスク上のファイル/フォルダ、Google Drive のリンク(接続された Google Drive コネクタがある場合)、ウェブリンク、製品の git リポジトリ(
.training-video/profile.mdが含まれている場合、製品はビデオ用に準備されています)。 - PDF があり、
doctor.pyが「poppler (PDF): なし」と表示する場合 → 次のように1つの質問で尋ねます。「PDF からテキストと画像を抽出するには、小さなプログラム(poppler、約35 MB)が必要です。インストールしますか?」「はい」の場合 —doctor.pyのコマンド(brew / winget)を実行します。「いいえ」の場合 — PDF を直接読み取り、画像は取得しません。 - モード: 素材ベース →
reference/materials.md。コードベース(アプリケーションの録画) →reference/code.md。両方ある場合は、どちらのビデオかを尋ねます。 - コードベース — どのロール用か。 ビデオはアプリケーションの1つのロール(オペレーター、マネージャー、管理者など)向けです。録画はそのロールで行われ、そのロールの画面のみを表示します。ロールは製品プロファイルまたはコードから取得します(
reference/code.mdの「ロール — コードから」)。アプリケーションが表示するラベルを選択肢として用意し、ユーザーに尋ねます。survey.cjsによるロールとしてのプレビューが完了するまで、スクリプトを作成しないでください。 - 複数の質問をまとめて(選択肢付きで)尋ねます: ビデオの対象者と、視聴後に何ができるようになるべきか。音声の言語(デフォルトは日本語)。字幕の言語。長さ(デフォルトは3~8分)。テーマ(
themes/、デフォルトは「ニュートラル」。素材に独自のブランドがある場合は、そのテーマを提案します)。完成品の保存先(Drive またはコンピュータ上のフォルダ)。
- 何があるか: チャットまたはディスク上のファイル/フォルダ、Google Drive のリンク(接続された Google Drive コネクタがある場合)、ウェブリンク、製品の git リポジトリ(
- ビデオフォルダ — プラグインと製品リポジトリの外。デフォルトはユーザーの「ドキュメント」フォルダ内:
<ドキュメント>/研修ビデオ/<短い名前>-<日付>/(Mac では~/Documents、Windows では `%USERPROFILE% enants est est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08 est_11_08