ビデオスクリプトライター は何をしますか?
製品デモ、機能ウォークスルー、ローンチビデオのためのビデオスクリプトを作成します。ペース、ビジュアルディレクション、タイミング、プラットフォームに適した長さを処理します。
入力解決
引数(指定されている場合)を以下の順序で解決します:
- 既存のマーケティングブリーフへのパス(「エグゼクティブサマリー」または「主要メッセージ」を含む
.mdファイル)→ マーケティングブリーフ - 既存のブログ記事へのパス(ブログ記事構造の
.mdファイル)→ ブログ記事 - 既存のチェンジログへのパス → チェンジログ
- 既存のニュースレターへのパス → ニュースレター
- GitHub URLまたは
#\d+パターンに一致 → PR ...または..を含む → Git参照範囲- 既存のファイル/ディレクトリに解決 → コードベース機能
- それ以外 → 自由形式テキスト
引数が指定されていない場合は、次のように尋ねます:「ビデオの内容は何にしますか?マーケティングブリーフ、ブログ記事、チェンジログ、PRのURL/番号、Git参照範囲、ファイル/ディレクトリパス、または機能の説明を提供できます。」
複数の解釈が一致する場合は、ユーザーに確認します。
プロセスフロー
digraph video_script {
rankdir=TB;
"Resolve input" [shape=box];
"Phase 1: Discovery" [shape=box];
"Phase 2: Configure" [shape=box];
"Phase 3: Outline" [shape=box];
"Outline approved?" [shape=diamond];
"Phase 4: Write" [shape=box];
"Phase 5: Review" [shape=box];
"Approved?" [shape=diamond];
"Phase 6: Output" [shape=box];
"Resolve input" -> "Phase 1: Discovery";
"Phase 1: Discovery" -> "Phase 2: Configure";
"Phase 2: Configure" -> "Phase 3: Outline";
"Phase 3: Outline" -> "Outline approved?";
"Outline approved?" -> "Phase 3: Outline" [label="no, revise"];
"Outline approved?" -> "Phase 4: Write" [label="yes"];
"Phase 4: Write" -> "Phase 5: Review";
"Phase 5: Review" -> "Approved?";
"Approved?" -> "Phase 4: Write" [label="revisions"];
"Approved?" -> "Phase 6: Output" [label="yes"];
}
フェーズをスキップしないでください。 自然なペースで質問してください。ユーザーが複数の質問に一度に答えた場合は、バンドルされた回答を受け入れ、先に進んでください。
ユーザーが「デフォルトでいいよ」などと言った場合は、妥当なデフォルトを選択し、選択内容を伝え、単一の確認を求めます。
フェーズ1: ディスカバリー
ステップ1 - 入力を分析
| 入力タイプ | 読み取る内容 |
|---|---|
| マーケティングブリーフ | 問題定義、価値提案、オーディエンス、主要メッセージを抽出。ステップ3にスキップ。ブリーフに製品コンテキストがない場合はステップ2を実行。 |
| ブログ記事 | 見出し、重要ポイント、オーディエンス、CTAを抽出。ステップ3にスキップ。 |
| チェンジログ | 主要なエントリを抽出し、最も影響の大きい変更に焦点を当てる。ステップ3にスキップ。 |
| ニュースレター | 件名、主な更新、CTAを抽出。ステップ3にスキップ。 |
| PR | Diff、PR説明、レビューコメント、コミットメッセージ。大規模なPR(20ファイル以上)の場合は、ユーザー向けの変更に焦点を当てる。 |
| Git参照 | 参照間のgit diffとgit log。ユーザー向けの変更を優先。 |
| コードベース機能 | 指定されたファイル/ディレクトリを読み取る。 |
| 自由形式テキスト | ユーザーの説明を解析。具体性に欠ける場合は、ユーザーに詳細または特定のファイル/PRを指定するよう依頼。 |
ユーザー向けの変更には、新機能、UI変更、API変更、パフォーマンス改善、バグ修正、ドキュメント更新が含まれます。内部変更には、リファクタリング、テスト追加、CI変更、依存関係のバンプが含まれます。
エラーハンドリング:
ghが利用不可 -> ユーザーに通知、代替入力を提案- 無効なPR/参照 -> ユーザーに確認を依頼
- ファイルが見つからない -> 正しいパスを尋ねる
ステップ2 - より広範な製品コンテキストを読み取る
存在する場合は、README、docs/、package.json(または同等のもの)を読み取ります。
何も見つからない場合は、次のように尋ねます:「製品とその対象ユーザーについて簡単に説明してもらえますか?」
ステップ3 - 理解内容を提示
「ビデオスクリプトのベースとして以下を使用します:」
- 機能A - 簡単な説明
- 機能B - 簡単な説明
「追加、削除、修正したいことはありますか?」
ユーザーがスコープを確認するまで先に進まないでください。
ステップ4 - 機密コンテンツのチェック
先に進む前に、機密性の可能性があるコンテンツ(セキュリティパッチ、内部価格、認証情報、未公開のロードマップ項目、または機密とマークされたコンテンツ)をスキャンします。疑わしいものはすべてユーザーにフラグを立てます。
フェーズ2: 設定
以下の質問をします:
Q1 - ビデオの長さ:
- ショートフォーム(30〜90秒) - ソーシャルメディア(Reels、Shorts、TikTok)
- ミディアムフォーム(3〜5分) - YouTube、製品デモ、ウォークスルー
Q2 - スクリプトタイプ:
- ナレーション - スクリーンレコーディング/フッテージに重ねて読むナレーションテキスト
- ツーカラム - 左列:ビジュアルディレクション/画面アクション、右列:ナレーション
- トーキングヘッド - カメラ上のスピーカー、会話調の配信
Q3 - トーン: 既存のリポジトリコンテンツを読み、声を検出します。確認します:
「既存のコンテンツに基づくと、トーンは[例:会話調で開発者に優しい]ようです。これに合わせるべきですか、それとも別の方向にしますか?」
分析するコンテンツがない場合は、直接尋ねます。
Q4 - CTA: コンテキストから推測:
- オープンソース -> 「リポジトリにスターを付ける」、「試してみる」
- SaaS -> 「無料でサインアップ」、「トライアルを開始」
- 機能更新 -> 「今すぐ試す」、「ドキュメントを確認」
「CTAは[推測されたCTA]を提案します。これでいいですか、それとも別のものにしますか?」
フェーズ3: アウトライン
タイミングを含む構造化されたアウトラインを生成します。ビデオの長さに基づいて適切なテンプレートを使用します:
ショートフォーム(30〜90秒) - 3〜4セクション:
## [作業タイトル] - [総時間]
1. **フック** (0:00-0:05) - [アプローチ]
- 重要ポイント
- ビジュアル: [表示するもの]
2. **問題** (0:05-0:15) - [設定するペインポイント]
- ビジュアル: [表示するもの]
3. **ソリューション** (0:15-0:45) - [機能ウォークスルー]
- 重要ポイントA
- ビジュアル: [表示するもの]
- 重要ポイントB
- ビジュアル: [表示するもの]
4. **CTA** (0:45-0:60) - [実行するアクション]
- ビジュアル: [エンドスクリーン]
推定合計: ~X単語(135 WPMで約Y秒)
ミディアムフォーム(3〜5分) - 5〜8セクション:
## [作業タイトル] - [総時間]
1. **フック** (0:00-0:10) - [アプローチ]
- ビジュアル: [表示するもの]
2. **問題** (0:10-0:30) - [ペインポイント、コンテキスト、なぜ重要か]
- ビジュアル: [表示するもの]
3. **ソリューション概要** (0:30-1:00) - [構築したもののハイレベル説明]
- ビジュアル: [表示するもの]
4. **ディープダイブ:[機能A]** (1:00-2:00) - [ウォークスルー]
- 重要ポイント
- ビジュアル: [スクリーンレコーディングの手順]
5. **ディープダイブ:[機能B]** (2:00-3:00) - [ウォークスルー]
- 重要ポイント
- ビジュアル: [スクリーンレコーディングの手順]
6. **ディープダイブ:[機能C]** (3:00-3:45) - [ウォークスルー]
- 重要ポイント
- ビジュアル: [スクリーンレコーディングの手順]
7. **まとめ** (3:45-4:30) - [主要なメリットを要約]
- ビジュアル: [サマリースライドまたはサイドバイサイド]
8. **CTA** (4:30-5:00) - [実行するアクション]
- ビジュアル: [エンドスクリーン]
推定合計: ~X単語(135 WPMで約Y秒)
カバーする機能に合わせてディープダイブセグメントの数を調整します。
アウトラインを提示し、執筆前に承認を待ちます。
フェーズ4: 執筆
ペーシング参考表
| ビデオの長さ | 目標単語数 | WPM |
|---|---|---|
| 30秒 | ~65単語 | 130 |
| 60秒 | ~135単語 | 135 |
| 90秒 | ~200単語 | 135 |
| 3分 | ~400単語 | 135 |
| 5分 | ~675単語 | 135 |
会話調の配信では130〜145 WPMを目標にします。割り当てられた時間を超過するセクションにはフラグを立てます。
スクリプト形式(タイプ別)
ナレーションスクリプト:
## [タイトル]
### フック (0:00-0:05) - ~15単語
ビジュアル: [画面に表示されるものの説明]
[ナレーションテキストをここに。]
### セクション名 (0:05-0:20) - ~30単語
ビジュアル: [画面に表示されるものの説明]
[ナレーションテキストをここに。]
ツーカラムスクリプト:
| 時間 | ビジュアル | ナレーション |
|---|---|---|
| 0:00-0:05 | [画面:ランディングページが読み込まれる] | [ナレーションテキスト] |
| 0:05-0:15 | [画面:設定メニューをクリック] | [ナレーションテキスト] |
| 0:15-0:30 | [画面:ダークモードを切り替え] | [ナレーションテキスト] |
トーキングヘッドスクリプト:
## [タイトル]
### フック (0:00-0:05) - ~15単語
カメラ: [カメラ上のスピーカー、ミディアムショット]
[スピーカーテキストをここに。会話調、カメラに直接。]
### セクション名 (0:05-0:20) - ~30単語
カメラ: [スクリーンレコーディングに切り替え]
ナレーション: [スクリーンレコーディングにかぶせるナレーション]
カメラ: [スピーカーに戻る]
[スピーカーテキストをここに。]
フック
最初の3〜5秒で視聴者が見続けるかどうかが決まります。フックは以下を満たす必要があります:
- ペインポイントに対処する、または挑発的な質問をする
- 自社/製品名で始めない
- 「このビデオでは、...をお見せします」で始めない
- 即座に好奇心や感情的な共鳴を生み出す
ビジュアルディレクション
スクリプトタイプに関わらず、必ずインラインでビジュアルディレクションを含めます:
VISUAL:/SCREEN:スクリーンレコーディングやフッテージ用CAMERA:トーキングヘッドのカメラディレクション用- 具体的に:「SCREEN: エクスポートボタンをクリックし、PDFがダウンロードされるのを見せる」であり、「SCREEN: 機能を見せる」ではない
- シーン間のトランジションノートを含める
セクションごとのタイミング
すべてのセクションに推定時間と単語数を含めます:
### セクション名 (0:15-0:30) - ~30単語- セクションが時間予算を超えた場合はフラグを立てる
- スクリプトの総単語数は、135 WPMで目標時間と一致している必要があります
執筆ルール
- 会話調で、台本っぽくないこと。実際に人が話すように書く。
- 短い文。1文あたり最大10〜15単語。
- 1文に1つのアイデア。
- 常に能動態。
- 生成コンテンツではemダッシュを使用しないでください。 「---」文字は使用しないでください。代わりにカンマ、コロン、ピリオド、または括弧を使用してください。
- 説明ではなく、見せる。「これがどれだけ速く読み込まれるか見てください」> 「とても速く読み込まれます」
- ミディアムフォームのビデオでは、3つのルールを使用:3つのメリット、3つの機能、3つの例。ショートフォームでは、単一の主要なメリットに焦点を当てます。
CTA
- ビデオの最後の5〜10秒
- 単一の明確なアクション
- エンドスクリーンのビジュアルディレクションを含める(購読ボタン、リンクオーバーレイ、QRコード)
フェーズ5: レビュー
タイミング内訳を含む完全なスクリプトを提示します:
「こちらがスクリプトです:」
[完全なスクリプト]
タイミング内訳:
- フック: 5秒(約15単語)
- 問題: 10秒(約25単語)
- ソリューション: 30秒(約70単語)
- CTA: 10秒(約20単語)
- 合計: 55秒(135 WPMで約130単語)
「変更はありますか?」
承認を待ちます。ユーザーが確認した場合のみ出力に進みます。
フェーズ6: 出力
承認された最終スクリプトを必ずターミナルに表示します。
次に尋ねます:「これを scripts/<slug>.md に保存しますか?それとも別のパスにしますか?」
ディレクトリが存在しない場合は作成します。ファイルがすでに存在する場合は、上書きするか、バージョン管理されたコピーを作成するかを尋ねます。
エラーハンドリング
ghが利用不可 -> ユーザーに通知、代替入力を提案- 無効なPR/参照 -> ユーザーに確認を依頼
- 製品コンテキストがない -> ユーザーに製品の説明を依頼
- スクリプトが目標時間を超える -> フラグを立て、レビュー前にカットを提案
このスキルが行わないこと
- ビデオの録画や編集
- サムネイルやビジュアルアセットの生成
- アニメーションやモーショングラフィックスの作成
- ブログ記事やソーシャルコピーの執筆(
/blog-postまたは/social-copyを使用)