HR 製品ビデオ
HR向けナレーション付き製品ビデオ。コードとして構築され、ユーザーのコンピューター上でレンダリングされます。対象視聴者は従業員であるため、言語はプロフェッショナルで平易かつ明瞭にし、組織のブランドガイドラインに従います。
このスキルは実際のHRアシスタントローンチビデオで構築・テストされました。references/lessons.md のすべてのルールはプロダクトオーナーからのフィードバックに基づいています。構築前に必ず読んでください。
最初に読むべきもの
| タイミング | 読むもの |
|---|---|
| 常に、スクリプトの前に | references/hr-context.md(HR領域、視聴者、トーン、センシティブなトピック) |
| 常に、構築の前に | references/lessons.md(音声、タイミング、キャプション、発音、QC) |
| リリース前に | references/qc-checklist.md |
| 3Dまたは動きの多いナレーションなしの作品の場合 | 代わりにこのリポジトリ内の motion-design スキルを使用 |
フォルダ
| フォルダ | 格納内容 |
|---|---|
brand/<org>/ | brand.js(色、フォント、ロゴ)、ガイドラインPDF、ロゴ、フォント、イントロ・アウトロビデオ |
references/ | 参考ビデオ、トランジション、音楽、ユーザーが好む音声サンプル |
projects/<name>/ | 1つのビデオ:brief.md、script.js、scenes.js、project.json、assets/、audio/、out/ |
.claude/skills/hr-product-video/engine/ | シーンエンジン(1つのプロジェクトで編集しないでください。振る舞いは scenes.js にコピーしてください) |
.claude/skills/hr-product-video/tools/ | レンダリング、音声、音楽、アセンブル、QC |
ワークフロー
一度に1ステップずつ進めてください。結果を表示し、次のステップに進む前に承認を得てください。変更は早期に行うほどコストが低くなります。
| # | ステップ | 出力 | ゲート |
|---|---|---|---|
| 1 | ブリーフ | brief.md:製品、視聴者、チャネル、長さ、地域、承認、公開されているもの | ユーザー確認 |
| 2 | ブランド | ガイドラインから brand/<org>/brand.js(サンプル色はPDFから取得、推測しない) | ユーザー確認 |
| 3 | スクリプト | script.js:シーン、show(キャプション)と say(音声)のテキスト | ユーザーが内容を承認 |
| 4 | ストーリーボード | シーンごとに1行:ビジュアル、動き、画面上のテキスト(両方の形状が必要な場合は両方に) | ユーザー承認 |
| 5 | 実際のコンテンツ | 実際の製品回答とスクリーンショット(個人データは削除) | ユーザー提供、あなたがレビュー |
| 6 | 構築 | scenes.js、各シーンの静止画(レビュー用) | ユーザーが静止画を承認 |
| 7 | 音声 | tools/voice.py(1テイク)、珍しい単語がある場合は発音サンプル | ユーザーが聴く |
| 8 | 音楽 | ユーザーのライセンス曲、または tools/music.py | ユーザーが聴く |
| 9 | レンダリング | tools/render.js、tools/assemble.py | |
| 10 | QC | tools/qc.py --transcribe、コンタクトシートを確認、その後チェックリストを確認 | あなたが確認、その後ユーザー |
新しいプロジェクトを開始するには、projects/_template を projects/<name> にコピーしてください。
コマンド(リポジトリルートから実行)
node .claude/skills/hr-product-video/tools/render.js projects/<name> land --stills 2,8,15 # 静止画レビュー
python3 .claude/skills/hr-product-video/tools/voice.py projects/<name> # 音声 + timing.js
python3 .claude/skills/hr-product-video/tools/music.py projects/<name> # オプション、クレジット消費
node .claude/skills/hr-product-video/tools/render.js projects/<name> land # サイレント本体ビデオ
python3 .claude/skills/hr-product-video/tools/assemble.py projects/<name> land # 最終ビデオ
python3 .claude/skills/hr-product-video/tools/qc.py projects/<name> land --transcribe # チェック
非妥協ルール
- ライブなものだけを表示すること。 ロードマップ、将来の機能、内部プロジェクト用語は禁止。
- 実際の製品出力のみを表示すること。 製品が実際に表示した回答のみを、トリミングして表示すること。回答を発明してはいけません。間違っている、矛盾している、推測している、または給与等級やその他の機密データを公開している回答はすべて除外すること。表示内容はコンテンツ所有者に確認させること。
- 実在人物のデータは使用しないこと。 架空の従業員で画面を再構築すること。ユーザーのアカウントからの名前、写真、チャット、連絡先は禁止。
- ブランドを優先すること。 組織のガイドラインがスタイルのアイデアより優先されます。ただし、ユーザーが別の決定をした場合は除きます。
- テキストが音声より先に表示されないこと。 キャプションと見出しは、その単語が話されたときに表示されます。
- 有料ツールはユーザーのクレジットを使用すること。 ステップを実行する前にそのコストを伝えること。キーは
.envに保管し、コミットされるファイルには決して置かないこと。 - ベンダー、価格、法律、製品機能について述べる前に検証すること。 未確認のものはその旨を明確に伝えること。