ビデオトレーニング:まずストーリーボード、次に実際のアプリを画面表示
トレーニングビデオは、一連の電話画面のようなカードで構成されます。各カードには、見出し、1行のヘルプ、実際のアプリからのコールアウト付きキーフレーム、そして1行のナレーションが含まれます。一部のカードは静止画の代わりにアプリの短いクリップを再生します。同じカードがスライドとPDFとしても提供されます。
すべてを統制するファイルは1つです:storyboard.json。Daveはデザインキャンバスを通じてこれを編集し、すべてのビルドスクリプトがそれを読み込みます。
使用するタイミング
使用する場合:
- アプリを紹介するトレーニングビデオ、はじめの一歩ガイド、クイックスタート、ハウツービデオ
- 技術者、アドバイザー、部品担当者向けの注釈付きスクリーンショットまたはスライドガイド
- このスキルで作成されたビデオの改訂(新しい文言、新しいカード、新しいクリップ)
使用しない場合:
- マーケティングやプロモーションビデオ(トーンとルールが異なります。Daveに相談してください)
- 製品内で記録される顧客向け点検ビデオ
- まだ存在しない画面のモックアップ(
/visualを使用してください)
原則
- 制作前にストーリーボード。 Daveがストーリーボードキャンバスを編集し、完了したと言うまでは、ナレーションも動画の組み立ても行いません。
- 実際のアプリで、実際の作業を表示。 実際のスキャン、実際の音声入力、実際に生成されたストーリー。決してモック画面や入力された結果を使用しないでください。
- Daveはチャットではなくキャンバス上で指示を出します。 キャンバスを読み取り、その差分を確認します。会話から彼の指示を再構築しないでください。
- 承認されたテイクは保持されます。 ナレーションは、文言が変更された行についてのみ再生成されます。Daveがレビューしたバージョンを上書きしないでください。
-v2、-v3として出荷します。 - Claudeは聞いたり見たりできません。 その旨を毎回の手戻り時に伝えてください。単語は文字起こしで証明し、画像はサンプルフレームで証明し、確認できなかったものを明示します。
- 元の状態に戻す。 モードを復元して確認し、再撮影の修理依頼はクローズします。
最初に読むもの
/Users/davidsonders/ro-bot/shared/product-facts.mdおよびshared/brand.md:名前、数、禁止ワード。emダッシュなし、絵文字なし、「TenthGear」は一語。視聴者に見えるもの、聞こえるものでは「single player」や「multi-player」とは決して言わないでください。- このフォルダ内の
reference.md:技術的な落とし穴。それぞれすでに一度は経験済みです。 - デザインキャンバスに関するメモリー:
reference_design_canvas_mechanics、reference_design_canvas_roundtrip、reference_design_canvas_entity_crash。
ファイルの保存場所
| 内容 | 場所 |
|---|---|
| ビデオのプロジェクトフォルダ | /Users/davidsonders/ro-bot/training-videos/<slug>/(セッションと共に消えるスクラッチパッドには絶対に置かない) |
| 唯一の信頼できる情報源 | <project>/storyboard.json |
| キーフレーム、クリップ、ナレーション | <project>/frames/、footage/、narration/ |
| ビルド成果物 | <project>/out/ |
| Daveが受け取る場所 | ~/Desktop/<Title>/ |
| 作業例 | training-videos/story-writer-getting-started/ およびこのフォルダ内の examples/story-writer/ |
スクリプトはこのフォルダ内の scripts/ にあります。最初の引数としてプロジェクトフォルダを取ります。
ワークフロー
以下の手順のTODOリストを作成し、順番に進めてください。
ステップ0:依頼内容を確定する
リクエストから以下の情報を見つけます。不足しているものだけを、推奨事項を先に述べて1つの質問で尋ねてください。
| 決定事項 | デフォルト |
|---|---|
| 誰が見るのか、どの役割か | 技術者 (Technician) |
| 電話かデスクトップか | 電話、390 x 844 |
| どのフローを、最初から最後まで | Daveの概要 |
| ストアとワークフローモード | Daveに確認。ステップ2を参照。 |
| 静止画のみか、静止画+クリップか | 画面が動くところではクリップ:録画、読み込み、開閉 |
| 尺 | 2分30秒以内 |
ステップ1:デザインキャンバス上でストーリーボードを作成する
これはDaveが最初に見るものであり、彼がスクリプトとコールアウトを編集する場所です。
-
プロジェクトフォルダを作成し、必要な小道具をレンダリングします(
props/render-paper.mjsがサンプルの紙の修理依頼書を作成します)。 -
キーフレームのためにフローを下見します。 キーフレームは実際のアプリから取得するため、このステップではキャプチャ実行(ステップ2とステップ3、静止画のみ)が必要です。
examples/story-writer/capture-stills.mjsをプロジェクトにコピーし、フローを書き換えます。先に進む前にすべてのフレームを確認してください。 -
storyboard.jsonをドラフトします。 視聴者が行う操作ごとに1カード。形式は以下の通り:{ "id": "write-story", "part": 2, "img": "10-write-story", "title": "[[Write Story]] をタップ", "body": "AIライターがあなたのメモをレビューし、3Cを自動生成します。", "boxes": [[183, 400, 191, 44]], "arrow": [162, 768], "footage": { "clip": "C-write", "runs": [[15, 336]], "note": "クリップの内容" }, "narration": "準備ができたら、Write Storyをタップしてください。" }boxesとarrowは電話画面のピクセル単位です。キャプチャは各コントロールのボックスをフレームの横に書き込みます。[[Label]]はボタンチップを描画します。最初のドラフトから以下のスタイルルールに従ってください。 -
キャンバスを作成します。 アーティファクトツール:
quickstartにdesign意図を指定して実行し、返されたtype_urlとタイトルを指定して公開します。URLを<project>/storyboard/artifact.jsonに保存します。 -
キーフレームをキャンバスにアセットとしてアップロードします(JPEG、高さ1688ピクセル。スクラッチパッドにステージングして1回の呼び出しで送信します)。返された各
/_blob/...URLをartifact.jsonのassetsの下に、フレーム名をキーとして記録します。 -
生成して公開します。
node scripts/storyboard-canvas.mjs <project>でstoryboard/project/を書き込みます。そのフォルダをスクラッチパッドにコピーして公開します:canvas.jsonをfile_pathとして、すべての.dc.htmlをfilesとして。 -
リンクをDaveに渡して停止します。 彼に伝えてください:カードの単語は再入力可能、各カードの下の青いメモは音声トラック、黄色いコールアウトはドラッグ可能、その他のメモは自由に追加可能。制作は開始しないでください。
-
編集内容を収集します。 アーティファクト
readをpaths(インデックスとすべてのアートボード)とout_dirを指定して実行し、その後node scripts/storyboard-harvest.mjs <project> <out_dir>を実行します。レポートを平易な言葉で彼に読み上げ、彼が追加したメモに対応し、その後--writeを付けて再実行します。 -
もう1ラウンド必要ですか?
project/canvas.jsonを読み戻し、--live <そのファイル>を付けて再生成し、再公開します。ライブインデックスから開始しない公開は拒否されます。
ステップ2:ストアを借りる
アプリはビデオで表示するモードでなければなりません。テストストアのみ使用可能です。
| ストア | ID | 通常モード | 注記 |
|---|---|---|---|
| Summit Auto Group (デモ) | demo-dealership | チームワークフロー | Daveの見込み客向けデモ。ログイン:[email protected] (技術者)、marcus@ (アドバイザー)、priya@ (部品)。最初のビデオで使用。 |
| Test Dealership 1 | mlTaPo12wbpUtJB9GXJM | チームワークフロー | ビルドセッションと共有。多くの場合ビジー。 |
ListAgentsを実行し、次に各ピアにSendMessageで問い合わせます:そのストアを使用しているか、モードが必要か?回答を待ちます。ピアが必要とする場合は、別のストアを使用するかDaveに尋ねます。- まずモードを読み取ります:アプリフォルダから
NODE_OPTIONS='-r dotenv/config' npm run --silent manage-org -- info <id>を実行します。 - キャプチャの実行中のみ、キャプチャと復元の同じコマンドチェーン内でモードを変更します。その後、再度読み取って確認します。
- 顧客のストアには絶対に触れないでください。テストアカウントの設定を変更しないでください。
ステップ3:キャプチャ
- 静止画:
dpr: 3。カードごとに1フレーム。画面が落ち着いてから撮影します。 - クリップ:
dpr: 2、vt.recorderを使用。各クリップは静止のビートで開始し、指のマーカーを表示してから操作します。marks.jsonを読んでfootage.runsを選択します。 - 音声入力は実際のもの。
vt.dictationで録音されたクリップを擬似マイクに再生します。アプリがそれを録音して文字起こしします。すべての文字起こしを印刷して読んでください:文字起こしは数字やブランド名を書き換えることがあります。 - 再撮影には新しい修理依頼書が必要です。番号を順に付け、各IDを
created-ros.txtにリストします。
ステップ4:スライド
node scripts/build-slides.mjs <project> で out/slides/*.png、PDF、およびビデオに必要なレイヤーが書き込まれます。すべてのカードのコンタクトシートを確認します。コールアウトが指すものを隠していないか確認します。
ステップ5:ナレーション
cd /Users/davidsonders/ro-bot/app
NODE_OPTIONS='-r dotenv/config' node ~/.claude/skills/video-training/scripts/narrate.mjs <project>
音声 ash、モデル gpt-audio-1.5(以前の gpt-4o-mini-tts から移行。OpenAIは2027-01-06にこれを廃止予定)。文字起こしがカードの文言と一致しないテイクは再試行され、それでもダメなら拒否されます。Daveはこの音声を承認し、Macの内蔵音声はロボットっぽいとして却下しました。アプリのOpenAIキーを使用し、1ビルドあたり数セントのコストがかかります:新しいビデオの概要でその旨を伝え、支出が驚きとならないようにします。DRY=1 で再生成されるものをリスト表示します。
耳で聞くためのナレーションを書いてください:「アール オー」「スリー シーズ」「テンスギア ドット エーアイ」。各部分は最初のカードでアナウンスします。
ステップ6:ビデオ
node scripts/build-video.mjs <project>。速度は1.25倍(QuickTimeの「Fast」)、Daveが承認したペースです。クリップのあるカードは、ナレーションとクリップのうち長い方の時間だけ再生されます。
ステップ7:検証し、検証できなかったことを伝える
check-audio.mjsでビデオを文字起こしし、各カードをスコアリングします。すべてのLOOK行を読んでください。- クリップや矢印のある各カードから1フレームを抽出して確認します。
- 手戻り時に、明確に伝えてください:聞いていない、最後まで見ていない。
ステップ8:納品
ビデオ、PDF、out/slides/ を ~/Desktop/<Title>/ にコピーします。以前のバージョンは保持します。尺、変更点、Daveが気づくかもしれない事項(クリップ内の異なる修理依頼番号、フッテージ上に重なったコールアウトなど)を伝えます。
ステップ9:クリーンアップ
- ストアモードを復元し、読み戻して確認します。
node scripts/close-ros.mjs <project> <email> <org-id>で再撮影をクローズします。修理依頼の削除はDaveの判断です。- メッセージを送ったピアに、ストアが空いたことを伝えます。
スタイルルール(Dave、2026-09-29)
| ルール | 例 |
|---|---|
| 視聴者がタップするボタンはボタンとして描画する | [[新規RO]] をタップ |
| パートヘッダーは短く、「/3」のような表記はしない | パート2:保証ストーリー |
| 表紙にステップ数は入れない | |
| 1ステップにつき1カード。1つの判断を示すカードは統合する | レビューと保存は1カード |
| 自明なポイントのカードは省く | 原因と修正の読み上げ |
| 誰が何を使って操作するかを明記する | 「メモを追加する」ではなく「音声メモを追加する」 |
| 画面上の2つのものが該当する可能性がある場合、どちらかを指す | 緑のボタンに矢印 |
| アプリ内で動くものはビデオでも動かす | 波形、スピナー、カードの開閉 |
| 現場用語を使用する | RO、ライン、ストーリー、3C、CP |
Daveはスライドの編集をPDFのページ番号で指定します。ページ1は表紙なので、「pg 7」はステップ6です。各編集を適用する前に、ステップ名で言い換えてください。
成功基準
- Daveがストーリーボードキャンバスを編集し、その編集内容が推測ではなく収集されたこと
- すべてのフレームとクリップが、ビデオで説明するモードの実際のアプリであること
- スライド、PDF、ビデオがすべて同じ
storyboard.jsonから生成されていること - ナレーションが文字起こしで確認され、不明瞭な行が特定されていること
- 手戻り時に、聞いていない箇所や見ていない箇所が明記されていること
- ストアモードが復元され確認済みであること。再撮影の修理依頼がクローズされていること
- プロジェクトフォルダがスクラッチパッド外に保持されていること
関連スキル
/visual:まだ存在しない画面のモックアップ用/app-testing:このスキルが借用するテストアカウントとライブパスハーネス用/compound:キャプチャ中に製品のバグや新しい落とし穴が発見された場合に使用