Communitygithub.com

dsonders/claude-skills

製作有旁白的培訓或操作示範影片(含對應的註釋投影片與 PDF),畫面中展示真實的 TenthGear 應用程式。從設計畫板上的分鏡腳本開始(關鍵畫面、標註、語音軌道),Dave 可即時編輯,然後從即時應用程式擷取靜態畫面與影片片段,使用 OpenAI 文字轉語音來旁白,最後組合成影片。當被要求製作培訓影片、入門指南、快速開始、操作示範影片、逐步解說、給技術人員或顧問的註釋螢幕截圖,或要修改現有培訓影片時使用。

claude-skills 是什麼?

此技能是一個完整的培訓影片製作系統,遵循「先分鏡,後製作」的原則。它會產生一組手機形狀的卡片,每張卡片包含標題、輔助說明、來自真實應用程式的關鍵畫面(含標註)以及旁白文字。某些卡片還會播放應用程式的短影片片段而非靜態畫面。所有內容均由單一 `storyboard.json` 檔案驅動,該檔案透過設計畫板進行編輯,所有建置腳本都會讀取它。此技能支援 Claude Code、Coder 和 Cursor 等平台,並透過一系列嚴謹的步驟操作:確認需求、在設計畫板上建立分鏡腳本、借用測試商店來設定真實應用程式環境、從即時應用程式捕捉靜態畫面與影片片段、建置投影片與 PDF、使用 OpenAI 文字轉語音產生旁白、組裝最終影片,最後驗證並交付。它還包含詳盡的風格規則、成功標準以及清理流程,確保每次產出都基於真實應用程式、可編輯且一致。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/dsonders/claude-skills/tree/HEAD/video-training

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

影片培訓:先分鏡,再展示真實應用程式

這裡的培訓影片是一組手機形狀的卡片。每張卡片都有一個標題、一行輔助說明、一個來自真實應用程式的關鍵畫面(附帶標註)以及一行旁白。有些卡片會播放應用程式的短影片片段,而非靜態畫面。這些相同的卡片也會以投影片和 PDF 形式提供。

一切由一個檔案驅動:storyboard.json。Dave 透過設計畫板編輯它;每個建置腳本都讀取它。

何時使用

用於:

  • 展示應用程式的培訓、入門、快速開始或操作示範影片
  • 給技術人員、顧問或零件部門的註釋螢幕截圖或投影片指南
  • 對此技能製作的影片進行修訂(新的措辭、新的卡片、新的片段)

請勿用於:

  • 行銷或宣傳影片(語氣和規則不同;請詢問 Dave)
  • 在產品內部錄製的客戶檢查影片
  • 尚未存在的螢幕原型(請使用 /visual)

原則

  1. 先分鏡,後製作。 在 Dave 編輯完分鏡畫板並表示完成之前,不會進行任何旁白或組裝。
  2. 展示真實的應用程式,執行真實的操作。 真實的掃描、真實的聽寫、真實生成的故事。絕不使用模擬螢幕,絕不輸入結果。
  3. Dave 在畫板上做決定,而不是在聊天中。 回讀畫板內容並比對差異。不要根據對話重新建構他的指示。
  4. 已批准的版本會被保留。 只有文字變更的旁白行才會重新產生。絕不覆蓋 Dave 已審查過的版本;改為輸出 -v2、-v3。
  5. Claude 無法聽或觀看。 在每次交回時都這麼說。透過逐字稿證明文字,透過範例幀證明圖片,並指明哪些項目未被檢查。
  6. 離開時恢復原狀。 確認模式已還原,關閉重拍的工單。

優先閱讀

  • /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 看到的第一個東西,也是他編輯腳本和標註的地方。

  1. 建立專案資料夾 並渲染任何道具(props/render-paper.mjs 會製作範例紙本工單)。

  2. 為關鍵畫面探索流程。 關鍵畫面來自真實應用程式,因此此步驟需要一次擷取執行(步驟 2 和步驟 3,僅靜態畫面)。將 examples/story-writer/capture-stills.mjs 複製到專案中並改寫流程。繼續之前,先檢視每一幀。

  3. 草擬 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]] 會繪製一個按鈕標記。從第一個草稿就遵循以下風格規定。

  4. 建立畫板。 使用 Artifact 工具:quickstart,意圖為 design,然後使用它回傳的 type_url 和一個標題發布。將網址儲存在 <project>/storyboard/artifact.json。

  5. 將關鍵畫面 作為資產上傳到畫板(JPEG,高度 1688 像素,暫存在暫存區以便一次調用)。將每個回傳的 /_blob/... 網址記錄在 artifact.json 的 assets 之下,以幀名稱為鍵。

  6. 生成並發布。 node scripts/storyboard-canvas.mjs <project> 會寫入 storyboard/project/。將該資料夾複製到暫存區並發布:canvas.json 作為 file_path,files 中的每個 .dc.html。

  7. 將連結交給 Dave 並停止。 告訴他:可以重新輸入任何卡片上的文字,每張卡片下方的藍色註釋是語音軌跡,拖曳黃色標註,或者在任何註釋上寫任何東西。不要開始製作。

  8. 收集他的編輯內容。 使用 Artifact read,指定 paths(索引和每個畫板)和 out_dir,然後執行 node scripts/storyboard-harvest.mjs <project> <out_dir>。用白話向他報告結果,根據他新增的任何註釋採取行動,然後使用 --write 重新執行。

  9. 再來一輪? 回讀 project/canvas.json,使用 --live <那個檔案> 重新生成,重新發布。不是從即時索引開始的發布將被拒絕。

步驟 2:借用商店

應用程式必須處於影片要展示的模式。只能使用測試商店。

商店Id正常模式備註
Summit Auto Group (demo)demo-dealership團隊工作流程Dave 的潛在客戶示範。登入帳號 [email protected](技術人員)、marcus@(顧問)、priya@(零件)。用於第一個影片。
Test Dealership 1mlTaPo12wbpUtJB9GXJM團隊工作流程與建置工作階段共用。經常忙碌。
  1. 執行 ListAgents,然後對每個同儕執行 SendMessage:它是否正在使用該商店,以及是否需要該模式?等待回答。如果同儕需要它,則使用另一個商店或詢問 Dave。
  2. 先讀取模式:從應用程式資料夾執行 NODE_OPTIONS='-r dotenv/config' npm run --silent manage-org -- info <id>。
  3. 僅在擷取執行的幾分鐘內更改它,並在同一個指令鏈中一併執行擷取和還原。然後再次讀取並確認。
  4. 絕不觸碰客戶商店。絕不更改測試帳戶的偏好設定。

步驟 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:驗證,並說明哪些未經驗證

  1. check-audio.mjs 會轉錄影片並為每張卡片評分。閱讀每一行 LOOK。
  2. 從每張包含片段或箭頭的卡片中抽出一幀並檢視。
  3. 在交回時,明確說明:未從頭到尾收聽,未從頭到尾觀看。

步驟 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:如果在擷取過程中暴露了產品錯誤或新的陷阱,之後使用

相關技能