影片培訓:先分鏡,再展示真實應用程式
這裡的培訓影片是一組手機形狀的卡片。每張卡片都有一個標題、一行輔助說明、一個來自真實應用程式的關鍵畫面(附帶標註)以及一行旁白。有些卡片會播放應用程式的短影片片段,而非靜態畫面。這些相同的卡片也會以投影片和 PDF 形式提供。
一切由一個檔案驅動:storyboard.json。Dave 透過設計畫板編輯它;每個建置腳本都讀取它。
何時使用
用於:
- 展示應用程式的培訓、入門、快速開始或操作示範影片
- 給技術人員、顧問或零件部門的註釋螢幕截圖或投影片指南
- 對此技能製作的影片進行修訂(新的措辭、新的卡片、新的片段)
請勿用於:
- 行銷或宣傳影片(語氣和規則不同;請詢問 Dave)
- 在產品內部錄製的客戶檢查影片
- 尚未存在的螢幕原型(請使用
/visual)
原則
- 先分鏡,後製作。 在 Dave 編輯完分鏡畫板並表示完成之前,不會進行任何旁白或組裝。
- 展示真實的應用程式,執行真實的操作。 真實的掃描、真實的聽寫、真實生成的故事。絕不使用模擬螢幕,絕不輸入結果。
- Dave 在畫板上做決定,而不是在聊天中。 回讀畫板內容並比對差異。不要根據對話重新建構他的指示。
- 已批准的版本會被保留。 只有文字變更的旁白行才會重新產生。絕不覆蓋 Dave 已審查過的版本;改為輸出
-v2、-v3。 - Claude 無法聽或觀看。 在每次交回時都這麼說。透過逐字稿證明文字,透過範例幀證明圖片,並指明哪些項目未被檢查。
- 離開時恢復原狀。 確認模式已還原,關閉重拍的工單。
優先閱讀
/Users/davidsonders/ro-bot/shared/product-facts.md和shared/brand.md:名稱、計數、禁用詞。不要使用長破折號,不要使用表情符號,「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/。它們將專案資料夾作為第一個參數。
工作流程
為這些步驟建立待辦事項列表,並依序完成它們。
步驟 0:確認需求
從請求中找到這些資訊。只詢問遺漏的部分,一次一個問題,並先提出建議。
| 決定事項 | 預設值 |
|---|---|
| 觀看者是誰,以及哪個角色 | 技術人員 |
| 手機或桌面 | 手機,390 x 844 |
| 哪個流程,從頭到尾 | Dave 的大綱 |
| 商店和工作流程模式 | 詢問 Dave。請參閱步驟 2。 |
| 僅靜態畫面,或靜態畫面加片段 | 只要畫面會移動的地方就使用片段:錄製、載入、開啟和關閉 |
| 長度 | 少於 2:30 |
步驟 1:在設計畫板上建立分鏡腳本
這是 Dave 看到的第一個東西,也是他編輯腳本和標註的地方。
-
建立專案資料夾 並渲染任何道具(
props/render-paper.mjs會製作範例紙本工單)。 -
為關鍵畫面探索流程。 關鍵畫面來自真實應用程式,因此此步驟需要一次擷取執行(步驟 2 和步驟 3,僅靜態畫面)。將
examples/story-writer/capture-stills.mjs複製到專案中並改寫流程。繼續之前,先檢視每一幀。 -
草擬
storyboard.json。 檢視者每做一件事就用一張卡片。格式:{ "id": "write-story", "part": 2, "img": "10-write-story", "title": "點擊 [[Write Story]]", "body": "AI 寫手會檢視您的筆記,並為您撰寫 3Cs。", "boxes": [[183, 400, 191, 44]], "arrow": [162, 768], "footage": { "clip": "C-write", "runs": [[15, 336]], "note": "片段內容" }, "narration": "準備好時,請點擊 Write Story。" }boxes和arrow使用手機像素;擷取時會將每個控制項的框寫在其幀旁邊。[[Label]]會繪製一個按鈕標記。從第一個草稿就遵循以下風格規定。 -
建立畫板。 使用 Artifact 工具:
quickstart,意圖為design,然後使用它回傳的type_url和一個標題發布。將網址儲存在<project>/storyboard/artifact.json。 -
將關鍵畫面 作為資產上傳到畫板(JPEG,高度 1688 像素,暫存在暫存區以便一次調用)。將每個回傳的
/_blob/...網址記錄在artifact.json的assets之下,以幀名稱為鍵。 -
生成並發布。
node scripts/storyboard-canvas.mjs <project>會寫入storyboard/project/。將該資料夾複製到暫存區並發布:canvas.json作為file_path,files中的每個.dc.html。 -
將連結交給 Dave 並停止。 告訴他:可以重新輸入任何卡片上的文字,每張卡片下方的藍色註釋是語音軌跡,拖曳黃色標註,或者在任何註釋上寫任何東西。不要開始製作。
-
收集他的編輯內容。 使用 Artifact
read,指定paths(索引和每個畫板)和out_dir,然後執行node scripts/storyboard-harvest.mjs <project> <out_dir>。用白話向他報告結果,根據他新增的任何註釋採取行動,然後使用--write重新執行。 -
再來一輪? 回讀
project/canvas.json,使用--live <那個檔案>重新生成,重新發布。不是從即時索引開始的發布將被拒絕。
步驟 2:借用商店
應用程式必須處於影片要展示的模式。只能使用測試商店。
| 商店 | Id | 正常模式 | 備註 |
|---|---|---|---|
| Summit Auto Group (demo) | 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。每張卡片一個幀,在畫面穩定後拍攝。 - 片段:
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 金鑰,每次建置花費幾美分:在每個新影片的需求確認中說明這一點,這樣花費就不會令人意外。DRY=1 會列出將被重新產生的內容。
為聽覺而寫旁白:「R O」、「three Cs」、「tenthgear dot A I」。在第一張卡片上宣布每個部分。
步驟 6:影片
node scripts/build-video.mjs <project>。速度為 1.25(QuickTime 的「Fast」),這是 Dave 批准的節奏。包含片段的卡片,其播放時間為其旁白和片段中較長者。
步驟 7:驗證,並說明哪些未經驗證
check-audio.mjs會轉錄影片並為每張卡片評分。閱讀每一行LOOK。- 從每張包含片段或箭頭的卡片中抽出一幀並檢視。
- 在交回時,明確說明:未從頭到尾收聽,未從頭到尾觀看。
步驟 8:交付
將影片、PDF 和 out/slides/ 複製到 ~/Desktop/<Title>/。保留較舊的版本。提供長度、更改的內容,以及 Dave 可能注意到的任何事項(例如片段中不同的工單號碼、覆蓋在影片上的標註)。
步驟 9:清理
- 商店模式已恢復,然後回讀並確認。
node scripts/close-ros.mjs <project> <email> <org-id>關閉重拍工單。刪除工單是 Dave 的決定。- 通知您曾發送過訊息的任何同儕,該商店現在是空閒的。
風格規定(Dave,2026-09-29)
| 規則 | 範例 |
|---|---|
| 檢視者點擊的按鈕應繪製為按鈕 | 點擊 [[New RO]] |
| 部分標題簡短,不含「of 3」 | PART 2: WARRANTY STORY |
| 封面沒有步驟計數 | |
| 每個步驟一張卡片。合併顯示一個決策的卡片。 | 檢閱和儲存是一張卡片 |
| 若卡片的要點顯而易見,則移除該卡片 | 閱讀原因和糾正措施 |
| 說明誰執行了什麼操作 | 「新增語音註釋」,而非「新增註釋」 |
| 當畫面上可能有兩個東西時,指向正確的那個 | 箭頭指向綠色按鈕 |
| 應用程式中任何會移動的東西,在影片中也應該移動 | 波形、載入圖示、卡片展開 |
| 車間用語 | RO, line, story, 3Cs, CP |
Dave 會透過 PDF 頁碼提供投影片編輯意見。第 1 頁是封面,所以「pg 7」是步驟 6。在套用每個編輯之前,先以步驟名稱重申該編輯。
成功標準
- Dave 已編輯分鏡畫板,他的編輯內容已被擷取,而非猜測
- 每個幀和片段都來自真實應用程式,並處於影片所展示的模式
- 投影片、PDF 和影片都來自同一個
storyboard.json - 旁白已透過逐字稿檢查;不明確的行已標明
- 交回時說明了哪些內容未被收聽或觀看
- 商店模式已恢復並確認;重拍工單已關閉
- 專案資料夾保留在暫存區之外
相關技能
/visual:適用於尚未存在的螢幕原型/app-testing:適用於此技能借用的測試帳號和即時測試工具/compound:如果在擷取過程中暴露了產品錯誤或新的陷阱,之後使用